Skip to content

Colota - Android GPS Location tracker

docs: sync the feature lists across README, store listing and intro

Max Dietrichca1b83fd7665
diff --git a/README.md b/README.md
index 9e6665b3..5f5e2eee 100644
--- a/README.md
+++ b/README.md
@@ -14,13 +14,14 @@ Colota sends your location to your own server over HTTP(S). It works offline, su
## Features
-- **Self-Hosted** - Send location data to your own server. Works with Dawarich, GeoPulse, Home Assistant, OwnTracks, PhoneTrack, Reitti, Traccar or any custom backend.
+- **Self-Hosted** - Send location data to your own server. Works with Dawarich, GeoPulse, Home Assistant, OwnTracks, Overland, PhoneTrack, Reitti, Traccar or any custom backend.
- **Privacy First** - No analytics, no telemetry, no third-party SDKs. Open source (AGPL-3.0).
- **Works Offline** - Fully functional without a server. Export as CSV, GeoJSON, GPX or KML.
- **Offline Maps** - Download map areas to your device for use without an internet connection.
- **Scheduled Export** - Automatic daily, weekly or monthly exports to a local directory with file retention management.
- **Encrypted Backup** - Single password-encrypted archive of all data (locations, settings, geofences, credentials) for migration or offsite storage.
-- **Location History** - View daily summaries, trip segmentation with manual merge and split, calendar with activity dots and per-trip export.
+- **Location History** - View daily summaries, trip segmentation with manual merge and split, per-point notes, calendar with activity dots and per-trip export.
+- **Import Your History** - Bring in existing tracks from GeoJSON, Google Timeline, GPX, KML or CSV.
- **Reliable Tracking** - Foreground service, auto-start on boot and exponential backoff retry.
- **Geofencing** - Pause zones that automatically stop recording locations.
- **Tracking Profiles** - Automatically adjust GPS interval, distance filter and sync settings based on conditions like charging, car mode or speed.
@@ -74,7 +75,7 @@ For full setup, server configuration, and integration guides, see the [documenta
## Documentation
-Full docs at **[colota.app](https://colota.app)** covers configuration, server integration (Dawarich, GeoPulse, Home Assistant, OwnTracks, PhoneTrack, Reitti, Traccar and custom backends), geofencing, data export, API reference, battery optimization, troubleshooting and development setup.
+Full docs at **[colota.app](https://colota.app)** covers configuration, server integration (Dawarich, GeoPulse, Home Assistant, OwnTracks, Overland, PhoneTrack, Reitti, Traccar and custom backends), geofencing, data export, API reference, battery optimization, troubleshooting and development setup.
## Build from Source
diff --git a/apps/docs/docs/introduction.md b/apps/docs/docs/introduction.md
index 2313e69e..d51b2a7e 100644
--- a/apps/docs/docs/introduction.md
+++ b/apps/docs/docs/introduction.md
@@ -9,25 +9,27 @@ Colota is a self-hosted GPS tracking app for Android. It sends your location to
## Key Features
-- **Self-Hosted** - Send location data to your own server. Works with Dawarich, GeoPulse, Home Assistant, OwnTracks, PhoneTrack, Reitti, Traccar or any custom backend.
+- **Self-Hosted** - Send location data to your own server. Works with Dawarich, GeoPulse, Home Assistant, OwnTracks, Overland, PhoneTrack, Reitti, Traccar or any custom backend.
- **Privacy First** - No analytics, no telemetry, no third-party SDKs. Open source (AGPL-3.0).
- **Works Offline** - Fully functional without a server. Export as CSV, GeoJSON, GPX, or KML.
- **Offline Maps** - Download map areas to your device for use without an internet connection.
- **Scheduled Export** - Automatic daily, weekly or monthly exports to a local directory with file retention management.
- **Encrypted Backup** - Single password-encrypted archive of locations, settings, geofences and credentials.
-- **Location History** - View daily summaries, trip segmentation, calendar with activity dots, per-trip export and per-point notes or deletion.
+- **Location History** - View daily summaries, trip segmentation with manual merge and split, calendar with activity dots, per-trip export and per-point notes or deletion.
+- **Import Your History** - Bring in existing tracks from GeoJSON, Google Timeline, GPX, KML or CSV.
- **Reliable Tracking** - Foreground service, auto-start on boot and exponential backoff retry.
- **Geofencing** - Pause zones that stop recording locations. Optionally stop GPS entirely when on WiFi or when the device is motionless.
- **Tracking Profiles** - Automatically adjust GPS interval, distance filter and sync settings based on conditions like charging, Android Auto, speed or stationary detection.
- **Flexible Sync** - Instant, batch, Wi-Fi only or offline modes.
- **Display Settings** - Choose between metric and imperial units, 12h or 24h time format. Auto-detected from device locale on first use.
+- **App Shortcuts** - Long-press the app icon to start or stop tracking from the home screen. Compatible with automation apps like Tasker and Samsung Routines.
- **Quick Setup** - Configure devices via `colota://setup` deep links or QR codes.
-- **Authentication** - Basic Auth, Bearer Token or custom headers
+- **Authentication** - Basic Auth, Bearer Token or custom headers. Optional mutual TLS (mTLS) with a PKCS12 client certificate stored in Android Keystore.
- **Dark Mode** - Full light and dark theme support.
## App Screens
-Colota has twenty-two screens, each focused on a specific task:
+Colota has twenty-five screens, each focused on a specific task:
| Screen | Purpose |
| --- | --- |
@@ -38,6 +40,7 @@ Colota has twenty-two screens, each focused on a specific task:
| **Appearance** | Light/dark theme, unit system, time format and custom map tile URLs |
| **API Config** | Endpoint field mapping with templates for Dawarich, GeoPulse, Overland, OwnTracks, PhoneTrack, Reitti, Traccar or custom backends |
| **Auth Settings** | Endpoint authentication (None, Basic Auth, Bearer Token) and custom HTTP headers |
+| **mTLS Settings** | Client certificate (mTLS) import or KeyChain selection and trusted server CA management |
| **Geofences** | Create pause zones by tapping the map, view all zones with pause option indicators |
| **Geofence Editor** | Configure a zone: name, radius, record pause, WiFi pause, motionless pause and timeout, stationary heartbeat |
| **Offline Maps** | Download map areas to the device for use without an internet connection |
@@ -46,11 +49,13 @@ Colota has twenty-two screens, each focused on a specific task:
| **Location History** | Browse recorded locations on a track map with calendar day picker and trip-colored segments, view segmented trips with per-trip stats; tap a point to add a note or delete it |
| **Trip Detail** | Full trip view with dedicated map, stats grid (distance, duration, avg speed, elevation), speed and elevation profile charts, export, and delete |
| **Location Summary** | Aggregated stats (total distance, trips, active days, avg distance) for selectable periods with daily breakdown and tap-to-inspect navigation |
-| **Export Data** | Export tracked locations as CSV, GeoJSON, GPX, or KML |
+| **Export Locations** | Export tracked locations as CSV, GeoJSON, GPX, or KML |
+| **Import Locations** | Import tracks from GeoJSON, Google Timeline, GPX, KML or CSV with a preview before committing |
| **Auto-Export** | Configure scheduled exports: directory, format, frequency, time of day (with weekday or day-of-month for weekly/monthly), export range and file retention |
| **Data Management** | Clear sent history, delete old data, vacuum the database |
| **Backup & Restore** | Create or restore a single password-encrypted `.colota` archive of all data (locations, settings, geofences, credentials) |
| **Setup Import** | Confirmation screen for deep link configuration imports (`colota://setup`) |
+| **Share Setup** | Build a `colota://setup` link or QR code from selected settings to configure another device |
| **Logging** | In-app activity log viewer (level filtering, search, export) plus opt-in persistent file logging |
| **About** | App version, device info, links to repository and privacy policy |
diff --git a/fastlane/metadata/android/en-US/full_description.txt b/fastlane/metadata/android/en-US/full_description.txt
index 63e1e04b..59451d80 100644
--- a/fastlane/metadata/android/en-US/full_description.txt
+++ b/fastlane/metadata/android/en-US/full_description.txt
@@ -3,19 +3,21 @@ Colota is an open-source GPS tracking app that sends your location to your own s
<b>Features</b>
<ul>
-<li><b>Self-Hosted</b> - Works with Dawarich, GeoPulse, Home Assistant, OwnTracks, PhoneTrack, Reitti, Traccar or any custom backend that accepts JSON over HTTP</li>
+<li><b>Self-Hosted</b> - Works with Dawarich, GeoPulse, Home Assistant, OwnTracks, Overland, PhoneTrack, Reitti, Traccar or any custom backend that accepts JSON over HTTP</li>
<li><b>Privacy First</b> - No analytics, no telemetry, no third-party SDKs. Licensed under AGPL-3.0</li>
<li><b>Works Offline</b> - Fully functional without a server. Locations are queued locally and synced when connectivity returns. Export as CSV, GeoJSON, GPX or KML</li>
<li><b>Offline Maps</b> - Download map areas to the device for use without an internet connection</li>
<li><b>Scheduled Export</b> - Automatic daily, weekly or monthly exports to a local directory with file retention management</li>
-<li><b>Location History</b> - Daily summaries, trip segmentation, calendar with activity dots and per-trip export</li>
+<li><b>Location History</b> - Daily summaries, trip segmentation, manual trip merge and split, per-point notes, calendar with activity dots and per-trip export</li>
+<li><b>Import Your History</b> - Bring in existing tracks from GeoJSON, Google Timeline, GPX, KML or CSV</li>
+<li><b>Encrypted Backup</b> - Password-protected archives of locations, settings and geofences</li>
<li><b>Reliable Tracking</b> - Foreground service, auto-start on boot and exponential backoff retry</li>
<li><b>Geofencing</b> - Pause zones that automatically stop recording locations</li>
<li><b>Tracking Profiles</b> - Automatically adjust GPS interval, distance filter and sync settings based on conditions like charging, car mode or speed</li>
<li><b>Flexible Sync</b> - Instant, batch or offline modes. Restrict sync to Wi-Fi, a specific SSID or VPN</li>
<li><b>App Shortcuts</b> - Long-press the app icon to start or stop tracking directly from the home screen. Compatible with automation apps like Tasker and Samsung Routines</li>
<li><b>Quick Setup</b> - Configure devices via colota://setup deep links or QR codes</li>
-<li><b>Authentication</b> - Basic Auth, Bearer Token or custom headers</li>
+<li><b>Authentication</b> - Basic Auth, Bearer Token, client certificates (mTLS) or custom headers</li>
<li><b>Dark Mode</b> - Full light and dark theme support</li>
</ul>