Telegram README

The project's README from github.com/DrKLO/Telegram. As one markdown file: README.md.

Telegram messenger for Android

Telegram is a messaging app with a focus on speed and security. It’s superfast, simple and free. This repo contains the official source code for Telegram App for Android.

Creating your Telegram Application

We welcome all developers to use our API and source code to create applications on our platform. There are several things we require from all developers for the moment.

  1. Obtain your own api_id for your application.
  2. Please do not use the name Telegram for your app — or make sure your users understand that it is unofficial.
  3. Kindly do not use our standard logo (white paper plane in a blue circle) as your app's logo.
  4. Please study our security guidelines and take good care of your users' data and privacy.
  5. Please remember to publish your code too in order to comply with the licences.

API, Protocol documentation

Telegram API manuals: https://core.telegram.org/api

MTproto protocol manuals: https://core.telegram.org/mtproto

Compilation Guide

Note: In order to support reproducible builds, this repo contains dummy release.keystore, google-services.json and filled variables inside BuildVars.java. Before publishing your own APKs please make sure to replace all these files with your own.

You will require Android Studio 2025.1.4, Android NDK 27.2.12479018 and Android SDK 36.

  1. Clone the Telegram source code with its submodules:
    git clone --recursive --shallow-submodules https://github.com/DrKLO/Telegram.git Telegram
    In case you forgot the --recursive flag, change to the Telegram directory and run:
    git submodule init && git submodule update --init --recursive --depth=1
  2. Copy your release.keystore into TMessagesProj/config
  3. Fill out RELEASE_KEY_PASSWORD, RELEASE_KEY_ALIAS, RELEASE_STORE_PASSWORD in gradle.properties to access your release.keystore
  4. Go to https://console.firebase.google.com/, create two android apps with application IDs org.telegram.messenger and org.telegram.messenger.beta, turn on firebase messaging and download google-services.json, which should be copied to the same folder as TMessagesProj.
  5. Open the project in the Studio (note that it should be opened, NOT imported).
  6. Fill out values in TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java – there’s a link for each of the variables showing where and which data to obtain.
  7. You are ready to compile Telegram.

Localization

We moved all translations to https://translations.telegram.org/en/android/. Please use it.

Telegram (DrKLO/Telegram)

Searching Database…

30.1K ·GitHub
Telegram
Что это такое?Это официальный клиент Telegram для Android с открытым исходным кодом. Telegram — мессенджер, созданный для скорости и безопасности.
Это само приложение Telegram или набор инструментов для создания своего мессенджера?Это реальный исходный код, на котором работает официальное приложение Telegram для Android. Telegram прямо разрешает разработчикам использовать этот API и код для создания собственных приложений на своей платформе.
Как собрать из этого рабочее приложение?Клонируйте репозиторий вместе с подмодулями, откройте проект в Android Studio (импорт не сработает), добавьте свой release.keystore и заполните поля с ключом и паролем, а также BuildVars.java.
Какие инструменты нужно установить перед сборкой?Нужны Android Studio 2025.1.4, Android NDK 27.2.12479018 и Android SDK 36, а также собственный проект Firebase для google-services.json.
Можно ли выпустить свою сборку под названием и логотипом Telegram?Нет. Нужно получить собственный API ID, не использовать название Telegram, если только не очевидно, что ваше приложение неофициальное, и нельзя использовать логотип Telegram с бумажным самолётиком.
Входят ли в этот репозиторий клиенты Telegram для iOS или десктопа?Нет, этот репозиторий содержит только клиент для Android. Приложения Telegram для iOS и десктопа поддерживаются в своих отдельных репозиториях.
Могу ли я на основе этого кода запустить собственное мессенджер-приложение?Да. Telegram прямо приглашает разработчиков использовать свой API и исходный код для собственных приложений, при условии что вы получите собственный API ID и не будете выдавать приложение за официальный клиент Telegram или использовать его логотип.
Откуда берутся переводы для приложения?Переводы вынесены из этого репозитория на отдельную платформу локализации, на которую ведёт README для участников.
What are similar projects?Signal-iOS, Telegram-iOS, chat, exteraless, thunderbird-android, FractalAndroid, Signal-Android, ARouter
Which topics is it in?chat-application, communication, firebase, gradle, messaging, gplv2, chat, telegram, android-app, mobile-app, java, mobile
Creator
DrKLO
Size
771.5 MB
Stars
30.1K
Updated
CommitOct 13Releaserelease-11.4.2-5469Nov 20
Age
12y
Commits · 90 Days