Build a custom version of the Telegram Android app from source to add your own features or branding.
Verify that the official Telegram X APK on Google Play matches the published source code with a reproducible build.
Contribute a bug fix or feature to the Telegram X codebase and submit a pull request.
Check the authenticity of a Telegram X APK you downloaded outside an official store using the checksum tool.
Requires 5+ GB disk, 4 GB RAM, macOS or Linux, a keystore file, and multiple toolchain steps before you can build.
Telegram X is an Android messaging app built by the same team behind Telegram, offered as an alternative to the standard Telegram client. The source code in this repository is the complete codebase for that app, along with detailed instructions for building it yourself. The app connects to Telegram's servers using the same account and contacts as the regular app, so switching between them requires no migration. The README focuses almost entirely on how to compile the app from source code, which requires considerable preparation. You need at least 5.34 gigabytes of free disk space, 4 gigabytes of RAM, and either macOS or Linux (Windows is technically possible through a compatibility layer but not officially supported). The process involves cloning the repository with all its dependencies, running a setup script, and either opening the project in Android Studio or building from the command line. You will also need a keystore file, which is the certificate used to sign Android apps so they can be installed on a device. Several build options exist for different processor types: arm64 and x64 for newer 64-bit hardware, arm32 and x86 for older or 32-bit devices, and a universal build that packages all of them together. If you want to contribute code changes, a simpler build path is available that skips some of the heavier steps and lets you submit a pull request to the project. The repository also includes instructions for verifying that official APK releases published on Google Play match the source code exactly, meaning no extra code has been added. This process is called a reproducible build. You recreate the build environment using specific Ubuntu versions and then compare your compiled output against the downloaded app file. This is mostly relevant for security researchers or users who want assurance that the published app is unmodified. If you downloaded the app from somewhere other than an official store, there is also a simpler verification method using a checksum tool to confirm the file matches a known official version. The README is technical and oriented toward developers. If you just want to use the app, you can download it directly from Google Play without any of these steps.
← tgx-android on gitmyhub — every repo by this author, as a profile.
Verify against the repo before relying on details.