Repolode
Submit
TelegramMessenger

TelegramMessenger/Telegram-iOS

Official source code for the Telegram messenger iOS app, with a build system for compiling it yourself in Xcode.

Open-source alternative to:Telegram

View on GitHub
Stars
9,293
Forks
3,085
Open issues
705
Last commit
11 days ago

What is it?

This repository contains the Swift source code of Telegram's iOS messaging app. It is intended for developers who want to compile the app themselves, or to build their own Telegram-based client using Telegram's API and source code under the conditions Telegram sets.

The build is driven by a Python script (Make.py) that uses Bazel as its build system and generates an Xcode project. Developers must supply their own api_id, bundle identifier, and signing information through a configuration JSON file. Simulator-only builds can skip code signing, and IPA builds for distribution are also supported.

Telegram asks that forks not use the Telegram name or standard logo without clear labeling as unofficial, and that derived code be published in line with the license.

Key features

  • 01Generates an Xcode project from Swift sources via a Python build script.
  • 02Uses Bazel for builds with a local cache directory.
  • 03Supports simulator-only builds without code signing.
  • 04Supports release IPA builds with distribution provisioning profiles.
  • 05Requires developers to provide their own api_id and signing configuration.

Use cases

  • Building a private, self-compiled copy of the Telegram iOS client for testing.
  • Studying how a large production iOS messaging app is structured and built.
  • Creating a derivative Telegram-based iOS client using Telegram's API.

Topics

#swift#ios#messaging#xcode#bazel#mobile-app

FAQ

What is Telegram-iOS?
Official source code for the Telegram messenger iOS app, with a build system for compiling it yourself in Xcode. This repository contains the Swift source code of Telegram's iOS messaging app. It is intended for developers who want to compile the app themselves, or to build their own Telegram-based client using Telegram's API and source code under the conditions Telegram sets.
Is Telegram-iOS free to use? What license does it have?
Telegram-iOS has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is Telegram-iOS still maintained?
Actively maintained. The last commit to Telegram-iOS was on Oct 8, 2026.
What can I use Telegram-iOS for?
Building a private, self-compiled copy of the Telegram iOS client for testing. Studying how a large production iOS messaging app is structured and built. Creating a derivative Telegram-based iOS client using Telegram's API.
Where can I get Telegram-iOS?
The source code and installation instructions are on GitHub: https://github.com/TelegramMessenger/Telegram-iOS

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects