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, exteraless, chat, thunderbird-android, Signal-Android, ARouter, MVPArms
Which topics is it in?chat-application, firebase, communication, 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