Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

TelegramMessenger/Telegram-Android

Productivity & Utilities

Official Android source for the Telegram messaging app, aimed at developers building their own client.

30,302
10,579
Java
GPL-2.0
13 years old

What it is

This repository holds the official source code of the Telegram messaging app for Android, the same app distributed through Google Play. It is a full client implementation in Java, not a library or a starter kit, and is meant for developers who want to study the app or build a derivative messenger on Telegram's API.

The README also sets rules for anyone reusing the code: obtain your own api_id through Telegram's application registration, do not name a derivative app "Telegram", do not reuse the official logo, follow the MTProto security guidelines, and publish your own code to satisfy the GPL-2.0 license.

Quick start

Building requires Android Studio 2025.1.4, Android NDK 27.2.12479018 and Android SDK 36, per the compilation guide.

  1. Clone the source with submodules:
    git clone --recursive --shallow-submodules https://github.com/DrKLO/Telegram.git Telegram
    
    If you cloned without --recursive, run git submodule init && git submodule update --init --recursive --depth=1 inside the directory.
  2. Copy your release.keystore into TMessagesProj/config and fill in RELEASE_KEY_PASSWORD, RELEASE_KEY_ALIAS and RELEASE_STORE_PASSWORD in gradle.properties.
  3. In the Firebase console, create two Android apps with IDs org.telegram.messenger and org.telegram.messenger.beta, enable Firebase Messaging, and put the downloaded google-services.json in the same folder as TMessagesProj.
  4. Open the project in Android Studio rather than importing it, and fill in the values in TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java. Each variable links to where its value is obtained.
  5. Build the project to produce your APK.

Translations are managed on the separate Telegram translations site, not in this repository.

Build constraints

  • The checked-in release.keystore, google-services.json and BuildVars.java values are placeholders for reproducible builds; they must be replaced before publishing any APK.
  • The build is tied to specific toolchain versions listed above; newer or older Android Studio, NDK or SDK versions are not covered by the guide.
  • A working client needs your own api_id and Firebase configuration in addition to Telegram's source.
  • The code is under GPL-2.0; distributing a modified app requires publishing its source under the same license.

HotRepo's take

The project recorded 8 new stars on the Java daily list on 2026-11-16, the only snapshot available, so there is no basis for reading a trend. At roughly 30k stars and 10.5k forks, the repository is mainly a reference client: its scale reflects years of use as the canonical Android implementation, and the many forks fit the pattern of developers building custom messengers from it rather than of a fast-moving upstream.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. TelegramMessenger/TelegramOfficial Android source code for the Telegram messaging app, intended for developers building or studying the client.Java30,302
  2. DrKLO/TelegramThe official Android client source for Telegram, useful to developers building or auditing a messenger, not as a kit for private chat.Java30,157
  3. TGX-Android/Telegram-XAn official alternative Telegram client for Android with full source and reproducible build instructions.Java6,192
  4. telegramdesktop/tdesktopOfficial Telegram desktop client source for building and using the messenger on Windows, macOS and Linux.C++33,411
  5. FoxCoderGit/AstraGramAn independent Android Telegram client that adds optional media, plugin and update tooling.Java115