From 6c8b9a143d8d4f6a2adaae183b1c6729b4da2085 Mon Sep 17 00:00:00 2001 From: Ahlem Date: Mon, 22 Jun 2026 13:36:44 +0100 Subject: [PATCH 1/4] update read me --- README.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 36a6e27df..7aa4111ae 100644 --- a/README.md +++ b/README.md @@ -79,7 +79,17 @@ Tella for Android can be downloaded: - from [this folder](https://web.tresorit.com/l/JgMjK#FV9IoIZdDxwAUPqtupJzsQ) or from our [Telegram channel](https://t.me/tellaapp), as an APK, to be installed manually. ### Tella FOSS (F-droid) -We also maintain a version of Tella in the [F-droid store](https://f-droid.org/en/packages/org.hzontal.tellaFOSS/). And the code for it can be found here: https://github.com/Horizontal-org/Tella-Android-FOSS +We also maintain a version of Tella in the [F-droid store](https://f-droid.org/en/packages/org.hzontal.tellaFOSS/) (`org.hzontal.tellaFOSS`). It is built from **this repository** using the `fdroid` product flavor (see below). The former [Tella-Android-FOSS](https://github.com/Horizontal-org/Tella-Android-FOSS) codebase has been merged here. + +### Play Store vs F-Droid (build flavors) +Both the Play Store app and Tella FOSS share one codebase. Two **`distribution`** flavors in `mobile/build.gradle`: + +| Flavor | Application id | Notes | +|--------|----------------|-------| +| **`playstore`** | `org.hzontal.tella` | Google Play build; includes Firebase Crashlytics, Google Drive, Dropbox, and Google sign-in | +| **`fdroid`** | `org.hzontal.tellaFOSS` | F-Droid / Tella FOSS; excludes proprietary Google and Dropbox SDKs | + +F-Droid release builds pass `-Pfdroid` (see `fastlane/README.md` and `docs/fdroid-release-verification.md`). ### Get started on Tella Android @@ -92,7 +102,7 @@ This software uses the following open source packages: - [SQLCipher](https://github.com/sqlcipher/sqlcipher) for our encrypted database. - [CacheWord](https://guardianproject.info/code/cacheword/) for passphrase caching and management. - [ODK JavaRosa](https://github.com/getodk/javarosa) to work with XForms. -- [CameraView](https://github.com/natario1/CameraView), [ExoPlayer](https://github.com/google/ExoPlayer), [RxJava](https://github.com/ReactiveX/RxJava), [OkHttp](https://github.com/square/okhttp), [Retrofit](https://github.com/square/retrofit), [PermissionDispatcher](https://github.com/permissions-dispatcher/PermissionsDispatcher), [PatternLock](https://github.com/zhanghai/PatternLock) and a lot of other excellent [libraries](https://github.com/Horizontal-org/Tella-Android/blob/master/mobile/build.gradle) helping all of us in Android application development. +- [CameraX](https://developer.android.com/jetpack/androidx/releases/camera), [ExoPlayer](https://github.com/google/ExoPlayer), [RxJava](https://github.com/ReactiveX/RxJava), [OkHttp](https://github.com/square/okhttp), [Retrofit](https://github.com/square/retrofit), [Glide](https://github.com/bumptech/glide), [Hilt](https://dagger.dev/hilt/), [Ktor](https://ktor.io/), [WorkManager](https://developer.android.com/jetpack/androidx/releases/work), [Mapsforge](https://github.com/mapsforge/mapsforge), [Nextcloud Android library](https://github.com/nextcloud/android), [PermissionDispatcher](https://github.com/permissions-dispatcher/PermissionsDispatcher), [PatternLock](https://github.com/zhanghai/PatternLock) (vendored in `tella-locking-ui`), and other libraries listed in [mobile/build.gradle](mobile/build.gradle). ## Contributing to the code From 819001bc6c7cc8fa75384e7a1e4f1e086770f1d7 Mon Sep 17 00:00:00 2001 From: Ahlem Date: Mon, 22 Jun 2026 13:41:02 +0100 Subject: [PATCH 2/4] update readme download reference --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 7aa4111ae..9a48c771e 100644 --- a/README.md +++ b/README.md @@ -76,6 +76,7 @@ A detailed list of features for Tella Android, Tella FOSS and Tella iOS can be f ### Tella for Android Tella for Android can be downloaded: - directly from the [Google Play Store](https://play.google.com/store/apps/details?id=org.hzontal.tella). +- from [F-Droid](https://f-droid.org/en/packages/org.hzontal.tellaFOSS/) (Tella FOSS, `org.hzontal.tellaFOSS`). - from [this folder](https://web.tresorit.com/l/JgMjK#FV9IoIZdDxwAUPqtupJzsQ) or from our [Telegram channel](https://t.me/tellaapp), as an APK, to be installed manually. ### Tella FOSS (F-droid) From b453fc097a7bcda6163684bd707ed9458bb20369 Mon Sep 17 00:00:00 2001 From: Ahlem Date: Mon, 22 Jun 2026 13:58:15 +0100 Subject: [PATCH 3/4] revert change --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 9a48c771e..7aa4111ae 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,6 @@ A detailed list of features for Tella Android, Tella FOSS and Tella iOS can be f ### Tella for Android Tella for Android can be downloaded: - directly from the [Google Play Store](https://play.google.com/store/apps/details?id=org.hzontal.tella). -- from [F-Droid](https://f-droid.org/en/packages/org.hzontal.tellaFOSS/) (Tella FOSS, `org.hzontal.tellaFOSS`). - from [this folder](https://web.tresorit.com/l/JgMjK#FV9IoIZdDxwAUPqtupJzsQ) or from our [Telegram channel](https://t.me/tellaapp), as an APK, to be installed manually. ### Tella FOSS (F-droid) From 3baf6efda1f1a873cfdc54a4a3c127c79e0da9d3 Mon Sep 17 00:00:00 2001 From: Ahlem Date: Tue, 23 Jun 2026 13:31:09 +0100 Subject: [PATCH 4/4] apply caro's comments --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 7aa4111ae..1c8275ae5 100644 --- a/README.md +++ b/README.md @@ -119,14 +119,14 @@ This software uses the following open source packages: **Step 6: Pushing your branch and creating a pull request** Push your branch up and create a pull request. Please indicate which issue your PR addresses in the title. ## Translating the app -Tella is currently available in [20 languages](https://tella-app.org/translating-tella). We are always looking to translate Tella into more languages. +Tella is currently available in [more than 25 languages](https://tella-app.org/translating-tella). We are always looking to translate Tella into more languages. If you are interested in adding a new language, or if you noticed a mistake or a missing translation, you can join [follow our contributing guidelines](https://tella-app.org/translating-tella/#how-do-i-become-a-translator). ## Contact us We love hearing from users, designers, and developers! -We host monthly [community meetings](https://tella-app.org/community-meetings) and we offer different ways to [contact-us](https://tella-app.org/contact-us). +We offer different ways to [contact us](https://tella-app.org/contact-us). If you have any question, ideas or suggestions on how we can improve or what new features we should add, or if you need support deploying Tella, don't hesitate to reach out!