Skip to content

README.md

Latest commit

 

History

History
50 lines (34 loc) · 3.43 KB

README.md

File metadata and controls

50 lines (34 loc) · 3.43 KB
Raw

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 3.4, Android NDK rev. 20 and Android SDK 8.1

  1. Download the Telegram source code from https://github.com/DrKLO/Telegram ( git clone https://github.com/DrKLO/Telegram.git )
  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.

Voice control

The user can choose the dialogs and start conversation with a series of voice commands. Voice commands include:

  1. Speak out the contact name to choose one of the dialogs.
  2. Okay to start conversation and the hint text will be changed to chat started.
  3. Speak out the message one wants to send, which can be sent using send command.
  4. Clear to clear the message in the text input.
  5. Close to finish the current conversation and there would be a chat closed prompt.

The speech is transcribed into text with Google Speech-to-Text API. In order to use the API, make sure to download the JSON credentials file from Google Cloud and put the file in the app resources as app/src/main/res/raw/credential.json. The main modifications to the original Telegram code are in org/telegram/ui/DialogsActivity and org/telegram/ui/Components/ChatActivityEnterView.