[TF] Readme + Changelog

README.md

@@ -1,39 +1,125 @@
-## Telegram messenger for Android
+[![Releases](https://img.shields.io/github/release/Telegram-FOSS-Team/Telegram-FOSS.svg)](https://github.com/Telegram-FOSS-Team/Telegram-FOSS/releases/latest)
+[![Discussions](https://img.shields.io/badge/Offtopics-Telegram-blue.svg)](https://t.me/tfossofftop)
+
+[![Donate](https://liberapay.com/assets/widgets/donate.svg)](https://liberapay.com/Telegram-FOSS/) or <img src="https://en.bitcoin.it/w/images/en/c/cb/BC_Logotype.png" alt="Bitcoin" height="25px" /> `1McafEgMvqAVujNLtcJumZHxp2UfaNByqs`
+
+# Telegram-FOSS
 
 [Telegram](https://telegram.org) 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](https://play.google.com/store/apps/details?id=org.telegram.messenger).
 
-## Creating your Telegram Application
+This is an unofficial, FOSS-friendly fork of the original [Telegram App for Android](https://github.com/DrKLO/Telegram).
+
+This version of Telegram is available on FDroid:
+
+[<img src="https://f-droid.org/badge/get-it-on.png"
+      alt="Get it on F-Droid"
+      height="80">](https://f-droid.org/app/org.telegram.messenger)
+
+## Current Maintainers
+
+- [thermatk](https://github.com/thermatk)
+- [Bubu](https://github.com/Bubu)
+- you? :)
+
+## Contributors
+
+- [slp](https://github.com/slp)
+- [Sudokamikaze](https://github.com/Sudokamikaze)
+- [l2dy](https://github.com/l2dy)
+- [maximgrafin](https://github.com/maximgrafin)
+- [vn971](https://github.com/vn971)
+- [theel0ja](https://github.com/theel0ja)
+- [AnXh3L0](https://github.com/AnXh3L0)
+- [noplanman](https://github.com/noplanman)
+- [vk496](https://github.com/vk496)
+- [verdulo](https://github.com/verdulo)
+- [anupritaisno1](https://github.com/anupritaisno1)
+- [nekohasekai](https://github.com/nekohasekai)
+- [kdrag0n](https://github.com/kdrag0n)
+
+## Discussion
+
+Join the [Telegram-FOSS Offtopics group](https://t.me/tfossofftop)
+
+You can also join `#telegram-foss:matrix.org` via [matrix](https://matrix.to/#/#telegram-foss:matrix.org) or `#telegram-foss` on freenode.
+
+## Changes:
 
-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.
+*Replacement of non-FOSS, untrustworthy or suspicious binaries or source code:*
+- Do location sharing with OpenStreetMap(osmdroid) instead of Google Maps
+- Use Twemoji 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:** Old BoringSSL prebuilts are replaced with the newest upstream source code built at compile time
+- **SECURITY:** Old FFmpeg prebuilts are replaced with the newest upstream source code built at compile time
 
-1. [**Obtain your own api_id**](https://core.telegram.org/api/obtaining_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.
-3. Please study our [**security guidelines**](https://core.telegram.org/mtproto/security_guidelines) and take good care of your users' data and privacy.
-4. Please remember to publish **your** code too in order to comply with the licences.
+*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. You have to type the code manually
 
-### API, Protocol documentation
+*Other:*
+- Allow to set a proxy before login
+- Added the ability to parse locations from intents containing a `geo:<lat>,<lon>,<zoom>` string
+- Force static map previews from Telegram
+
+## Versioning
+
+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).
+
+## API, Protocol documentation
 
 Telegram API manuals: https://core.telegram.org/api
 
 MTproto protocol manuals: https://core.telegram.org/mtproto
 
-### Compilation Guide
+## Building
+
+**NOTE: Building on Windows is, unfortunately, not supported.
+Consider using a Linux VM or dual booting.**
+![WindowsSupport](/tgfoss-build-under-win.gif?raw=true)
+
+**Important:**
+
+1. You need the Android NDK, Go(Golang) and [Ninja](https://ninja-build.org/) 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 the `TMessagesProj/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_ffmpeg_clang.sh
+      ./patch_ffmpeg.sh
+      ./patch_boringssl.sh
+      ./build_boringssl.sh
+      ```
 
-**Note**: In order to support [reproducible builds](https://core.telegram.org/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.
+4. If you want to publish a modified version of Telegram:
+      - You should get **your own API key** here: https://core.telegram.org/api/obtaining_api_id and create a file called `API_KEYS` in the source root directory.
+        The contents should look like this:
+        ```
+        APP_ID = 12345
+        APP_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**
 
-You will require Android Studio 3.4, Android NDK rev. 20 and Android SDK 8.1
+The project can be built with Android Studio or from the command line with gradle:
 
-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.
+`./gradlew assembleAfatRelease`
 
-### Localization
+# DIGITAL RESISTANCE
 
-We moved all translations to https://translations.telegram.org/en/android/. Please use it.
+![DIGITALRESISTANCE](/DigitalResistance.jpg?raw=true "DIGITALRESISTANCE")

metadata/af/description.txt

@@ -0,0 +1,11 @@
+'''Waarskuwing:''' terwyl hierdie bou gebaseer is op 'n suiwer-floss vurk, is die oorspronklike stroom-op is nie altyd vinnig met die publisering van die bronkode vir onlangse weergawes.
+
+Kliënt vir die telegram Boodskapdiens platform. Gesels met vriende, begin groep geselsies en deel alle vorme van inhoud. Al jou boodskappe en gesprekke in telegram se wolk gestoor is.
+
+Die Boodskapdiens platform is gemik op mobiele toestelle, maar werkskerm en web kliënte bestaan ook.
+
+Verskeie eiendomsregtelike dele van die oorspronklike telegram kliënt is verwyder, insluitend Google Play Services vir die geogafiese posisie dienste, HockeySDK vir self dateering en om kennisgewings deur Google Cloud Messaging te versprei. geogafiese posisie deel funksionaliteit word nou gedoen met behulp van OpenStreetMap.
+
+Anti-kenmerk: Nie - vrye netwerk, aangesien die bedieners eiendomsregtelike sagteware uitvoer.
+
+Die amptelike bronkode van die program bevat Binêre datablokke, dit hou trend van 'n vurk wat bou diegene uit bronkode. Weergawes se beskikbaarheid het dus gewoonlik 'n sekere agterstand.

metadata/af/name.txt

@@ -0,0 +1 @@
+Telegram

metadata/af/summary.txt

@@ -0,0 +1 @@
+Telegram is 'n boodskap app met 'n fokus op spoed en sekuriteit.

metadata/am/summary.txt

@@ -0,0 +1 @@
+ቴሌግራም ፍጥነት እና ደህንነት ላይ ትኩረት ጋር መላላኪያ መተግበሪያ ነው.

metadata/ar/description.txt

@@ -0,0 +1,11 @@
+'' 'تحذير: ''' بينما يستند هذا البناء على fork حر بالكامل ، المصدر الأصلي ليس سريعا لنشر الكود البرمجي للإصدارات المطروحة مؤخرا.
+
+عميل لمنصة تيليجرام. دردش مع الأصدقاء، و أبدء محادثات جماعية وشارك كل أنواع المحتوى. يتم تخزين جميع رسائل البريد والمحادثات في سحابة تيليجرام.
+
+هدف البرنامج المراسلة في الأجهزة المحمولة ، ولكنه كذالك يمتلك عميلا لسطح المكتب والويب .
+
+تم إزالة العديد من الأجزاء الإحتكارية من السورس الأصلي لتيلجرام ، بما في ذلك خدمات جوجل و خدمات المواقع، HockeySDK لتحديث ذاتي ودفع الإخطارات عن طريق "سحابة جوجل ". تم استعادة ميزة الموقع باستخدام خريطة OSM مفتوحة المصدر .
+
+ميزة مضادة : الشبكة ليست حرة، لأنها تعمل خوادم تُشغّل برمجيات غير حرة.
+
+شفرة المصدر الرسمي للتطبيق تحتوي على باينري ، لذلك هذه المسارات مأخوذة من الFork الذي يقوم ببنائها من المصدر.ومن ثم يتم توفير النسخ ولاكن مع تأخر لفترة زمنية معينة.

metadata/ar/name.txt

@@ -0,0 +1 @@
+تيليجرام

metadata/ar/summary.txt

@@ -0,0 +1 @@
+تيليجرام هو برنامج مراسلة يُركز على السرعة والأمان.

metadata/ast/name.txt

@@ -0,0 +1 @@
+Telegram

metadata/ast/summary.txt

@@ -0,0 +1 @@
+Telegram ye una app de mensaxería centrada na velocidá y la seguridá.

metadata/be/name.txt

@@ -0,0 +1 @@
+Telegram

metadata/be/summary.txt

@@ -0,0 +1 @@
+Telegram — дадатак абмену паведамленнямі з акцэнтам на хуткасць і бяспечнасць.

metadata/bg/summary.txt

@@ -0,0 +1 @@
+Телеграма е съобщения ап с акцент върху скоростта и сигурността.

metadata/bo/description.txt

@@ -0,0 +1,11 @@
+'''ཉེན་བརྡ། :''' བཟོ་བཀོད་འདི་pure-floss fork གཞིར་བཞག་ནས་བཟོས་ཡོད་སྟབས། ཉེ་བའི་ཆར་གྱི་ཐོན་རིམ་ཁག་གི་འབྱུང་ཁུངས་ཨང་རྟགས་པར་སྐྲུན་དང་མཉམ་དུ་ནང་བཅུག་ང་ོམ་བྱེད་སྐབས་མགྱོགས་པོ་བྱེད་ཐུབ་ཀྱི་མེད།
+
+ཏར་འཕྲིན་འཕྲིན་ཐུང་བབས་སྟེགས་ཀྱི་མཉེན་ཆས། གྲོགས་པོ་ཚོ་མཉམ་དུ་སྐད་ཆ་ཤོད། སྐད་འཕྲིན་ཚོགས་པ་འགོ་བཙུགས་ནས་ནང་དོན་ཚང་ཕན་ཚུན་མཉམ་སྤྱོད་བྱེད། ཁྱེད་རང་གི་འཕྲིན་ཡིག་དང་སྐད་འཕྲིན་ཡོངས་རྫོགས་ཏར་འཕྲིན་གྱི་སྤྲིན་ཕུང་སྒང་ལ་ཉར་ཚགས་བྱས་ཡོད།
+
+འཕྲིན་ཐུང་བབས་སྟེགས་འདི་ལག་ཐོགས་ཁ་པར་རིགས་ལ་གཙོ་བོར་དམིགས་པ་རེད། འོན་ཀྱང་གློག་ཀླད་དང་དྲྭ་རྒྱ་མཉེན་ཆས་སྒང་ལའང་ཡོད།
+
+སྒེར་ལ་དབང་བའི་ཡན་ལག་ཁ་ཤས་ཤིག་ཏར་འཕྲིན་གྱི་མཉེན་ཆས་ངོ་མ་ནས་ཕྱིར་སྟོན་ཟིན་པ་རེད། འདིའི་ནང་ས་གནས་ཞུབས་ཞུའི་ཆེད་དུ་གུ་གལ་མཉེན་ཆས་ཞབས་ཞུ་དང་། རང་འགུར་གྱི་གསར་བསྒྱུར་དང་གུ་གལ་སྤྲིན་ཕུང་འཕྲིན་ཐུང་རྒྱུད་དེ་བརྡ་ལན་གཏོང་བའི་ཆེད་དུ་ཧོཀ་ཀི་SDK སོགས་དང་པོ་ནས་ཕྱིར་སྟོན་པའི་གྲས་ཆགས་ཡོད། ས་གནས་མཉམ་སྤྱོད་བྱེད་ལས་འདི་བཞིན་OpenStreetMap བེད་སྤྱོད་བྱས་ཏེ་སྐྱར་བཅུག་ཐུབ།
+
+ཁྱད་ཆོས་འགལ་ཟླ་: ཞབས་ཞུ་འཕྲུལ་ཆས་དེ་སྒེར་ལ་དབང་བའི་མཉེན་ཆས་ཡིན་པ་སོང་ཙང་། རིན་མེད་མ་ཡིན་པའི་དྲྭ་རྒྱ་དགོས།
+
+The official source code of the app contains binary blobs, so this tracks a fork which builds those from source. Hence, versions might become available with a certain lag.

metadata/bo/name.txt

@@ -0,0 +1 @@
+ཏར།

metadata/bo/summary.txt

@@ -0,0 +1 @@
+ཏར་ནི་མྱུར་ཚད་དང་བདེ་འཇགས་ལ་དམིགས་ཏེ་བཟོས་པའི་འཕྲིན་ཐུང་མཉེན་ཆས་ཤིག་རེད།

metadata/ca/name.txt

@@ -0,0 +1 @@
+Telegram

metadata/ca/summary.txt

@@ -0,0 +1 @@
+Telegram és una aplicació de missatgeria ràpida i segura.

metadata/cs/description.txt

@@ -0,0 +1,3 @@
+Platforma pro textovou komunikaci cílená na mobilní zařízení – ale klienti pro osobní počítače a weboví klienti také.
+
+Anti vlastnosti: Nesvobodná síť, protože servery provozují proprietární software.

metadata/cs/name.txt

@@ -0,0 +1 @@
+Telegram

metadata/cs/summary.txt

@@ -0,0 +1 @@
+Telegram je messaging aplikace se zaměřením na rychlost a bezpečnost.

metadata/da/name.txt

@@ -0,0 +1 @@
+Telegram

metadata/da/summary.txt

@@ -0,0 +1 @@
+Telegram er en messaging app med fokus på hastighed og sikkerhed.

metadata/de/description.txt

@@ -0,0 +1,11 @@
+'''Achtung:''' Während dieser Build auf einem reinen FLOSS-Fork beruht, ist das zugrundeliegende Repo bei der Veröffentlichung des Quellcodes für neuere Versionen nicht immer schnell.
+
+Client für das Messaging mit Telegram. Mit Feunden chatten, Gruppen-Chats beginnen und alle möglichen Inhalte teilen. Alle Nachrichten und Unterhaltungen werden in der Cloud von Telegram gespeichert.
+
+Die Messaging-Plattform ist auf Mobilgeräte ausgerichtet, es bestehen aber auch Desktop- und Web-Lösungen.
+
+Einige proprietäre Teile wurden aus dem Original-Client von Telegram entfernt, darunter die Google Play Services zur Standortbestimmung und das HockeySDK für selbsttätige Aktualisierungen und Push-Benachrichtigungen über Google Cloud Messaging. Die Funktion zur Standortübermittlung wird über OpenStreetMap wiederhergestellt.
+
+Unerwünschtes Merkmal: Nicht freies Netzwerk, da auf den Servern proprietäre Software läuft.
+
+Der offizielle Quellcode der App enthält Binär-Blobs, also verfolgt diese App einen Fork, der diese aus der Quelle herstellt. Somit kann es bis zum Erscheinen neuer Versionen zu gewissen Verzögerungen kommen.

metadata/de/name.txt

@@ -0,0 +1 @@
+Telegram

metadata/de/summary.txt

@@ -0,0 +1 @@
+Telegram ist eine auf Geschwindigkeit und Sicherheit fokussierte Messaging-App.

metadata/el/name.txt

@@ -0,0 +1 @@
+Τηλεγράφημα

metadata/el/summary.txt

@@ -0,0 +1 @@
+Τηλεγράφημα είναι ένα messaging app με μια έμφαση στην ταχύτητα και ασφάλεια.

metadata/en-US/changelogs/13400.txt

@@ -0,0 +1,5 @@
+* Telegram Passport
+* Telegram FOSS:
+  * suggested locations and search are back
+  * location sharing fixes and https for map tiles
+  * everything from Telegram 4.7 and 4.8

metadata/en-US/changelogs/13580.txt

@@ -0,0 +1,5 @@
+* New “Exceptions” section in Notification settings
+* Improved password hashing algorithm to better protect Telegram Passport data
+* Export your chats on Telegram Desktop
+* Telegram-FOSS:
+  * sync boringSSL

metadata/en-US/changelogs/13590.txt

@@ -0,0 +1,2 @@
+* Security update for bundled SQLite
+* new Emoji 11!

metadata/en-US/changelogs/14780.txt

@@ -0,0 +1,6 @@
+* new upstream release:
+* Global permissions for groups
+* Unified group settings
+* Undo deleting chats and clearing chat history within 5 seconds
+* New sorting options in Contacts
+* New animations when uploading and downloading media

metadata/en-US/changelogs/14970.txt

@@ -0,0 +1,5 @@
+* new upstream release:
+* Apply blur and motion effects to chat backgrounds
+* and other changes around backgrounds
+* TFOSS:
+* allow installing APKs

metadata/en-US/changelogs/15170.txt

@@ -0,0 +1,8 @@
+* new upstream release:
+* Autoplaying videos
+* New settings for automatic media download
+* Logout alternatives
+* TFOSS:
+* Fixed OpenStreetMaps
+* Added other tile servers
+* Other great fixes

metadata/en-US/changelogs/15910.txt

@@ -0,0 +1,7 @@
+* new upstream release:
+* delete anytime
+* new icons and menus
+* swipe to archive
+* see who's online
+* TalkBack support
+* ...

metadata/en-US/changelogs/16080.txt

@@ -0,0 +1,5 @@
+* Choose who can see your phone number.
+* Add groups to "Always/Never Share" exceptions.
+* Enjoy improved design.
+* Connect a discussion group to your channel.
+* Seamlessly integrate bots with web services.

metadata/en-US/changelogs/16480.txt

@@ -0,0 +1,4 @@
+* Location-based group chats
+* Animated stickers
+* Transfer ownership of groups and channels
+* A lot more!

metadata/en-US/changelogs/16840.txt

@@ -0,0 +1,8 @@
+* Hold the Send button to send silent messages.
+* Enable Slow Mode in Group Permissions.
+* Set custom titles for admins.
+* Redesigned attachment menu.
+* Toggle looped playback for animated stickers.
+* See video preview thumbnails when scrubbing.
+* Send animated emoji.
+* A lot more!

metadata/en-US/changelogs/17100.txt

@@ -0,0 +1,5 @@
+* Choose who can find you on Telegram by your phone number
+* Hold the 'Send' button to schedule messages
+* Create new themes based on your color choices
+* Share your themes via links and update them for all users
+* And more!

metadata/en-US/changelogs/18290.txt

@@ -0,0 +1,9 @@
+* Create themes with color gradients and patterns.
+* Schedule messages to be sent when your recipient comes online.
+* Switch to Night Mode and back directly from the left menu.
+* Choose video quality in a more intuitive way.
+* Listen to podcasts and audio tracks longer than 20 minutes at 2x speed.
+* Resume playback from where you left off.
+* Tap and hold on chats when sharing from other apps to send to several recipients.
+* Hold on the Archive folder to mark all archived chats as read.
+* And more!

metadata/en-US/changelogs/18519.txt

@@ -0,0 +1,8 @@
+* Fix for push (fingers crossed).
+* Create three new kinds of polls.
+* See who voted for what in polls with visible votes.
+* Vote for several options in polls that allow multiple answers.
+* Try to guess the correct answer in quiz-style polls.
+* Use bots like @QuizBot to create quizzes with multiple questions.
+* See exact progress counters for files as they upload or download.
+* Change the appearance of message bubbles.

metadata/en-US/changelogs/18699.txt

@@ -0,0 +1,6 @@
+New Profiles, Fast Media Viewer and People Nearby 2.0
+* Access shared media directly from profile pages.
+* Pull down to enlarge profile pictures.
+* Flip through photos by tapping on their left or right edge.
+* Tap on your chat partner's profile picture to immediately expand it.
+* Make your profile visible to others in your area from 'Contacts' > 'Add People Nearby' and make new friends.