TGX-Android /Telegram-X
The main repository of Telegram X — official alternative Telegram client for Android.
★ 6,199⑂ 1,195👁 360⑃ 334● 0▤ 9
+2
Daily
+39
Weekly
+119
Monthly
6,199
stars
1,195
forks
360
watchers
334
prs
0
issues
9
releases
README
Telegram X — a slick experimental Telegram client based on TDLib. !Telegram X This is the complete source code and the build instructions for the official alternative Android client for the Telegram messenger, based on the Telegram API and the MTProto secure protocol via TDLib. Telegram X on Google Play (subscribe to beta) APKs and Build Info Bot to verify APK hash Other sources Telegram X on Huawei AppGallery GitHub Releases Build instructions Prerequisites Repository must be fetched via git JDK or Android Studio (with compatible bundled JDK) At least 8GB of RAM At least 7,32GB of free disk space when cloning with --shallow-submodules --depth=1 At least 2-5x times more disk space for files generated during build process. macOS Homebrew git with LFS: $ brew install git git-lfs && git lfs install JDK: $ brew install openjdk@25 rustup, then Rust of version.rust of version.properties with targets of Android: $ scripts/setup-rust.sh, which prints rust.dir for local.properties Ubuntu git with LFS: apt install git git-lfs Run $ git lfs install if you just installed git-lfs JDK: apt install openjdk-25-jdk rustup: apt install rustup, then Rust of version.rust of version.properties with targets of Android: $ scripts/setup-rust.sh, which prints rust.dir for local.properties. Run it again after a change of version.rust If multiple JDK versions are installed: update-java-alternatives --list update-java-alternatives --set java-1.25.0-openjdk-amd64 (or other compatible version) Windows MSYS2 (UCRT64 environment) Update packages: pacman -Syu Run pacman -S --needed git mingw-w64-ucrt-x86_64-git-lfs perl make diffutils Run git lfs install Run git config --global core.longpaths true rustup, then Rust of version.rust of version.properties with targets of Android: scripts/setup-rust.sh, which prints rust.dir for local.properties Clone the repository Set msys2.dir in local.properties after cloning Note: you have to use \\ or / as path separator in properties files Building 1. $ git clone --recursive https://github.com/TGX-Android/Telegram-X tgx 2. In case you forgot the --recursive flag, cd into tgx directory and run: $ git submodule update --init --recursive 3. Open project via Android Studio or build manually from the command line: ./gradlew assembleLatestDebug 4. If build fails, follow the instructions provided in the error message. Publishing 1. Obtain Telegram API credentials 2. Create local.properties file in the root project folder using any text editor: Location where you have Android SDK installed sdk.dir=YOUR_ANDROID_SDK_FOLDER \ Home of rustup with Rust of version.rust, printed by scripts/setup-rust.sh rust.dir=YOUR_RUSTUP_HOME_FOLDER \ Telegram API credentials obtained at previous step telegram.api_id=YOUR_TELEGRAM_API_ID telegram.api_hash=YOUR_TELEGRAM_API_HASH 3. Setup Firebase and replace google-services.json with the one that's suitable for your app.id Commands Reference
Latest release
Telegram X 0.29.1.1817 v0.29.1.1817 2026-10-11Telegram X 0.29.1.1817 has been released. You can review all changes in the source code here. Download Google Play (subscribe to beta) GitHub Releases Telegram X APKs & Build Info Checksums You can always check if checksum of an APK you downloaded corresponds to any official Telegram X build via @tgx_bot. Checksums for 0.29.1.1817. Tap to expand --- universal SHA-256: 28b0cf4008329355f271e4780cbabde30b41938d97df800f1cd0c62226c4f56c SHA-1: b269628af6486af78e5f9e4d83d4dbf6022803df MD5: 6875e50a1c03fe20dbe36bd6e8573679 --- arm64-v8a SHA-256: a546317abbe