Repository files navigation

or1P8kNcifVAkBWtWmjKY4RvVLy5QwruE2LQ

Telegram is a messaging app with a focus on speed and security. It’s superfast, simple and free.

This is an unofficial, FOSS-friendly fork of the originalTelegram App for Android.

This version of Telegram is available on FDroid:

• thermatk
• you? :)

• slp
• Bubu
• Sudokamikaze
• l2dy
• maximgrafin
• vn971
• theel0ja
• AnXh3L0
• noplanman
• vk496
• verdulo
• anupritaisno1
• nekohasekai
• kdrag0n
• terachad
• ppnplus
• luvletter2333
• 23rd
• proletarius101
• CWJamieson
• verdulo
• tehcneko

Join theTelegram-FOSS Offtopics group

You can also join#telegram-foss:matrix.org viamatrix or#telegram-foss on freenode.

Replacement of non-FOSS, untrustworthy or suspicious binaries or source code:

• Do location sharing with OpenStreetMap(osmdroid) instead of Google Maps
• Use Noto emoji set instead of Apple's emoji
• Google Play Services GCM replaced with Telegram's push service
• Has to show a notification on Oreo+, ask Google
• SECURITY: BoringSSL prebuilts are replaced with recent upstream source code built at compile time
• SECURITY: FFmpeg prebuilts are replaced with recent upstream source code built at compile time
• SECURITY: libvpx prebuilts are replaced with recent upstream source code built at compile time
• SECURITY: Bundled libWebP is updated

Removal of non-FOSS, untrustworthy or suspicious binaries or source code and their functionality:

• Google Vision face detection and barcode scanning (Passport)
• Google Wallet and Android Pay integration
• Google Voice integration
• HockeyApp crash reporting and self-updates
• Google SMS retrieval
• Google ML Kit

Other:

• Added the ability to parse locations from intents containing ageo:<lat>,<lon>,<zoom> string
• Force static map previews from Telegram
• No content restrictions

This repository contains tags to make tracking versions easier.

Versions are in form "v$UPSTREAM$RELEASE" where:

• $UPSTREAM is the public, visible version of upstream.
• $RELEASE is a letter ([a-z]) indicating minor releases between official versions (sometimes, upstream is updated without relating the changes to an specific version).

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

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

NOTE: Building on Windows is, unfortunately, not supported.Consider using a Linux VM or dual booting.

Important:

1. You need the Android NDK, Go(Golang) andNinja to build the apk.

2. Don't forget to include the submodules when you clone:

   • git clone --recursive https://github.com/Telegram-FOSS-Team/Telegram-FOSS.git

3. Build native FFmpeg and BoringSSL dependencies:

   • Go to theTMessagesProj/jni folder and execute the following (define the paths to your NDK and Ninja):

   export NDK=[PATH_TO_NDK]export NINJA_PATH=[PATH_TO_NINJA]./build_libvpx_clang.sh./build_ffmpeg_clang.sh./patch_ffmpeg.sh./patch_boringssl.sh./build_boringssl.sh

4. If you want to publish a modified version of Telegram:

   • You should getyour own API key here:https://core.telegram.org/api/obtaining_api_id and create a file calledAPI_KEYS in the source root directory.The contents should look like this:

     APP_ID = 12345APP_HASH = aaaaaaaabbbbbbccccccfffffff001122

   • Do not use the name Telegram and the standard logo (white paper plane in a blue circle) for your app — or make sure your users understand that it is unofficial
   • Take good care of your users' data and privacy
   • Please remember to publish your code too in order to comply with the licenses

The project can be built with Android Studio or from the command line with gradle:

./gradlew assembleAfatRelease