[TF] Readme + Changelog

README.md

@@ -1,32 +1,121 @@
-## 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)
+
+## 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:
+
+*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
+- **SECURITY:** Bundled libWebP is updated
 
-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.
+*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
+- HockeyApp crash reporting and self-updates
+- Google SMS retrieval. You have to type the code manually
 
-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.
+*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
 
-### API, Protocol documentation
+## 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
 
-### Usage
+## 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, revision 16b](https://developer.android.com/ndk/downloads/older_releases), 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_R16B]
+      export NINJA_PATH=[PATH_TO_NINJA]
+      ./build_ffmpeg_clang.sh
+      ./patch_boringssl.sh
+      ./build_boringssl.sh
+      ```
+
+4. For the whole project set NDK to r16b
+
+5. 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**
+
+The project can be built with Android Studio or from the command line with gradle:
 
-**Beware of using the dev branch and uploading it to any markets, in many cases it not will work as expected**.
+`./gradlew assembleAfatRelease`
 
-First of all, take a look at **src/main/java/org/telegram/messenger/BuildVars.java** and fill it with correct values.
-Import the root folder into your IDE (tested on Android Studio), then run project.
+# DIGITAL RESISTANCE
 
-### Localization
+![DIGITALRESISTANCE](/DigitalResistance.jpg?raw=true "DIGITALRESISTANCE")
 
-We moved all translations to https://translations.telegram.org/en/android/. Please use it.

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