TeleUI — A Modern Telegram Client Concept for macOS

TeleUI for MacOS

Screen.Recording.2026-04-13.at.8.17.49.PM.mov

TeleUI is a concept of a modern Telegram client for macOS built with SwiftUI.

Note: I have no plans to actively develop, maintain, or update this project. I simply dropped this repository as a proof-of-concept to demonstrate that the official Telegram app on macOS could have a much better, native UI/UX. This is purely for educational and demonstrational purposes.

✨ Features implemented in this concept

• ✅ Authentication: Phone number, SMS code, and two-factor authentication support
• ✅ Chats: Full chat list with archive support, chat folders, and sorting
• ✅ Messages: Message sending/receiving with real-time updates
• ✅ Reactions: Add emoji reactions to messages
• ✅ User Profiles: View user profiles with online status
• ✅ Media: Photo, video, document, and voice message support
• ✅ Menu Bar: Quick access via macOS menu bar
• ✅ Dark Mode: Full dark mode support

🚀 Getting Started

Requirements

• macOS 13.0 or later
• Xcode 15.0 or later
• Swift 5.9+
• Telegram API credentials from my.telegram.org

Installation

1. Clone the repository

   git clone https://github.com/MazyLawzey/TeleUI.git
   cd TeleUI

2. Get Telegram API Credentials

   • Visit my.telegram.org
   • Go to "API development tools"
   • Copy your api_id and api_hash

3. Configure Credentials

   • Open AppSecrets.swift
   • Replace apiId and apiHash with your credentials:

   enum AppSecrets {
       static let apiId: Int    = YOUR_API_ID        // Your api_id
       static let apiHash: String = "YOUR_API_HASH"  // Your api_hash
   }

4. Build and Run

   open TeleUI.xcodeproj

   • Select the TeleUI scheme
   • Press ⌘R to run

🏗️ Architecture & Structure

TeleUI uses a clean MVVM architecture:

• Views: SwiftUI components for UI
• ViewModels: State management and business logic (@StateObject, @Published, Combine)
• Models: Data structures (TLChat, TLMessage, etc.)
• Services: API integration (TelegramService, TDLibClientBridge built on TDLibKit)

👨‍💻 Author

Mazy Lawzey

yo @overtake, just take a look