Skip to content

Colota - Android GPS Location tracker

docs: add F-Droid as distribution channel

Max Dietrich751111a51752
diff --git a/README.md b/README.md
index 6d8dfa06..58e17542 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
# Colota - GPS Location Tracker
-[![Version](https://img.shields.io/github/v/release/dietrichmax/colota)](https://github.com/dietrichmax/colota/releases) [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0) [![Google Play](https://img.shields.io/badge/Google_Play-Download-green.svg?logo=google-play)](https://play.google.com/store/apps/details?id=com.Colota&hl=en-US) [![IzzyOnDroid](https://img.shields.io/endpoint?url=https://apt.izzysoft.de/fdroid/api/v1/shield/com.Colota&label=IzzyOnDroid)](https://apt.izzysoft.de/fdroid/index/apk/com.Colota)
+[![Version](https://img.shields.io/github/v/release/dietrichmax/colota)](https://github.com/dietrichmax/colota/releases) [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0) [![Google Play](https://img.shields.io/badge/Google_Play-Download-green.svg?logo=google-play)](https://play.google.com/store/apps/details?id=com.Colota&hl=en-US) [![F-Droid Version](https://img.shields.io/f-droid/v/com.Colota)](https://f-droid.org/de/packages/com.Colota) [![IzzyOnDroid](https://img.shields.io/endpoint?url=https://apt.izzysoft.de/fdroid/api/v1/shield/com.Colota&label=IzzyOnDroid)](https://apt.izzysoft.de/fdroid/index/apk/com.Colota)
**Self-hosted GPS tracking app for Android.**
@@ -64,7 +64,7 @@ Colota sends your location to your own server over HTTP(S). It works offline, su
## Quick Start
-1. Install from [Google Play](https://play.google.com/store/apps/details?id=com.Colota&hl=en-US) or download the APK from [GitHub Releases](https://github.com/dietrichmax/colota/releases)
+1. Install from [Google Play](https://play.google.com/store/apps/details?id=com.Colota&hl=en-US), [F-Droid](https://f-droid.org/packages/com.Colota/), [IzzyOnDroid](https://apt.izzysoft.de/packages/com.Colota/) or download the APK from [GitHub Releases](https://github.com/dietrichmax/colota/releases)
2. Grant location permissions (precise, all the time)
3. Grant notification permission (required for the foreground service)
4. Disable battery optimization for Colota
diff --git a/apps/docs/docs/faq.md b/apps/docs/docs/faq.md
index 494d9001..2f39c9c3 100644
--- a/apps/docs/docs/faq.md
+++ b/apps/docs/docs/faq.md
@@ -18,7 +18,7 @@ No, but you can use [Dawarich](/docs/integrations/dawarich) or a custom backend
### Does this work without Google Play Services?
-Yes. The **FOSS variant** (available on IzzyOnDroid and GitHub Releases) uses Android's native `LocationManager` and has no Google Play Services dependency. It works on LineageOS, GrapheneOS, CalyxOS, and any ROM without Google services.
+Yes. The **FOSS variant** (available on F-Droid, IzzyOnDroid and GitHub Releases) uses Android's native `LocationManager` and has no Google Play Services dependency. It works on LineageOS, GrapheneOS, CalyxOS and any ROM without Google services.
The Google Play variant uses `FusedLocationProvider` for potentially better location accuracy through Wi-Fi and cell tower fusion.
@@ -51,6 +51,7 @@ Depends on your settings. With the **Balanced** preset (30s interval, batch sync
### How do I update the app?
- **Google Play** - updates automatically, or open the Play Store and tap Update
+- **F-Droid** - open the F-Droid client and update from there, or use [Obtainium](https://github.com/ImranR98/Obtainium) to track releases automatically
- **IzzyOnDroid** - open the IzzyOnDroid client and update from there, or use [Obtainium](https://github.com/ImranR98/Obtainium) to track releases automatically
- **GitHub Releases** - download the latest APK from [GitHub Releases](https://github.com/dietrichmax/colota/releases) and install it - Android will update the existing app in place
diff --git a/apps/docs/docs/getting-started/installation.md b/apps/docs/docs/getting-started/installation.md
index ac9c0371..5f65e44e 100644
--- a/apps/docs/docs/getting-started/installation.md
+++ b/apps/docs/docs/getting-started/installation.md
@@ -10,13 +10,19 @@ sidebar_position: 1
The Google Play version uses Google Play Services for location (FusedLocationProvider).
+## From F-Droid
+
+[Get it on F-Droid](https://f-droid.org/packages/com.Colota/)
+
+The F-Droid version uses Android's native LocationManager and has **no Google Play Services dependency**. This is the recommended option for devices running LineageOS, CalyxOS, or any ROM without Google services.
+
## From IzzyOnDroid
[Get it on IzzyOnDroid](https://apt.izzysoft.de/packages/com.Colota/)
-The IzzyOnDroid version uses Android's native LocationManager and has **no Google Play Services dependency**. This is the recommended option for devices running LineageOS, CalyxOS, or any ROM without Google services.
+The IzzyOnDroid version is the same FOSS variant as on F-Droid and has **no Google Play Services dependency**. IzzyOnDroid typically receives new releases faster than the official F-Droid repository.
-**GrapheneOS users:** You can use the Google Play variant with sandboxed Google Play, or install the FOSS variant via IzzyOnDroid or GitHub Releases. GrapheneOS reroutes location requests to its own reimplementation of the Play geolocation service, so you get the accuracy benefits of FusedLocationProvider without sending location data to Google.
+**GrapheneOS users:** You can use the Google Play variant with sandboxed Google Play, or install the FOSS variant via F-Droid, IzzyOnDroid or GitHub Releases. GrapheneOS reroutes location requests to its own reimplementation of the Play geolocation service, so you get the accuracy benefits of FusedLocationProvider without sending location data to Google.
## From GitHub Releases
diff --git a/apps/docs/docs/getting-started/quick-start.md b/apps/docs/docs/getting-started/quick-start.md
index 8e4dce20..d0749dd6 100644
--- a/apps/docs/docs/getting-started/quick-start.md
+++ b/apps/docs/docs/getting-started/quick-start.md
@@ -6,7 +6,7 @@ sidebar_position: 2
Minimal setup to start tracking:
-1. Install the app ([Google Play](https://play.google.com/store/apps/details?id=com.Colota&hl=en-US), [IzzyOnDroid](https://apt.izzysoft.de/packages/com.Colota/), or [APK](https://github.com/dietrichmax/colota/releases))
+1. Install the app ([Google Play](https://play.google.com/store/apps/details?id=com.Colota&hl=en-US), [F-Droid](https://f-droid.org/packages/com.Colota/), [IzzyOnDroid](https://apt.izzysoft.de/packages/com.Colota/) or [APK](https://github.com/dietrichmax/colota/releases))
2. Grant location permissions - select **Precise location** and **Allow all the time**
3. Grant notification permission - required for the foreground service that keeps GPS tracking alive
4. Disable battery optimization for Colota in Android settings (otherwise background tracking won't work reliably)
diff --git a/apps/docs/docusaurus.config.ts b/apps/docs/docusaurus.config.ts
index c5edb664..3d60ca36 100644
--- a/apps/docs/docusaurus.config.ts
+++ b/apps/docs/docusaurus.config.ts
@@ -118,6 +118,10 @@ const config: Config = {
label: "Google Play",
href: "https://play.google.com/store/apps/details?id=com.Colota&hl=en-US"
},
+ {
+ label: "F-Droid",
+ href: "https://f-droid.org/packages/com.Colota/"
+ },
{
label: "IzzyOnDroid",
href: "https://apt.izzysoft.de/packages/com.Colota/"
diff --git a/apps/docs/src/pages/index.tsx b/apps/docs/src/pages/index.tsx
index 4a1fd2e7..1e2d31f3 100644
--- a/apps/docs/src/pages/index.tsx
+++ b/apps/docs/src/pages/index.tsx
@@ -33,6 +33,10 @@ function HomepageHeader() {
</div>
<div className={styles.downloadLinks}>
<span className={styles.downloadLabel}>Also available on</span>
+ <Link className={styles.downloadLink} href="https://f-droid.org/packages/com.Colota/">
+ F-Droid
+ </Link>{" "}
+ and
<Link className={styles.downloadLink} href="https://apt.izzysoft.de/fdroid/index/apk/com.Colota">
IzzyOnDroid
</Link>
diff --git a/apps/docs/src/pages/privacy-policy.md b/apps/docs/src/pages/privacy-policy.md
index 9466b68b..91435631 100644
--- a/apps/docs/src/pages/privacy-policy.md
+++ b/apps/docs/src/pages/privacy-policy.md
@@ -4,7 +4,7 @@ title: Privacy Policy
# Privacy Policy
-**Last updated: March 28, 2026**
+**Last updated: April 29, 2026**
Colota ("the App") is a self-hosted GPS tracking application for Android, developed by Max Dietrich. This privacy policy explains what data the App collects, how it is used, and your rights regarding that data.
@@ -73,7 +73,7 @@ Colota does not share your data with anyone. The only data transmission occurs t
### Google Play
-The GMS variant of the App is distributed via Google Play, which may collect data according to [Google's Privacy Policy](https://policies.google.com/privacy). This is outside the App's control. The FOSS variant is available on IzzyOnDroid and GitHub Releases with no Google dependency.
+The GMS variant of the App is distributed via Google Play, which may collect data according to [Google's Privacy Policy](https://policies.google.com/privacy). This is outside the App's control. The FOSS variant is available on F-Droid, IzzyOnDroid and GitHub Releases with no Google dependency.
### Map Tiles (maps.mxd.codes)