TGX-Android / Telegram-X

# Telegram X — a slick experimental Telegram client based on TDLib.
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`
#### 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`
* 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`
* 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
 \# 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`
## Reproducing public builds
In order to verify that there is no additional source code injected inside official APKs, you must use one of the following versions of **Ubuntu**:
* **21.04**: for builds published before 26th May 2023
* **22.04.2 LTS**: for builds published before 27th September 2025
* **24.04 LTS**: for builds published before 1st October 2026
* **26.04 LTS**: for any newer releases
And update its configuration:
1. Create user called `vk` with the home directory located at `/home/vk`
2. Clone `tgx` repository to `/ho