Skip to content

Colota - Android GPS Location tracker

Clarify geofence pause zones stop recording, not GPS

Max Dietrich587697978f0c
diff --git a/README.md b/README.md
index fd96d4bc..528da43c 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ Colota sends your location to your own server over HTTP(S). It works offline, su
- **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.
- **Reliable Tracking** - Foreground service, auto-start on boot, exponential backoff retry.
-- **Geofencing** - Pause zones that automatically pause tracking.
+- **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.
- **Flexible Sync** - Instant, batch, Wi-Fi only, or offline modes.
- **Quick Setup** - Configure devices via `colota://setup` deep links or QR codes.
diff --git a/apps/docs/docs/guides/battery-optimization.md b/apps/docs/docs/guides/battery-optimization.md
index 344a2d2a..ec9849c0 100644
--- a/apps/docs/docs/guides/battery-optimization.md
+++ b/apps/docs/docs/guides/battery-optimization.md
@@ -18,7 +18,7 @@ Settings and tips to reduce battery usage without losing GPS fixes.
1. **Increase GPS interval** - 5s to 30s saves significant battery
2. **Enable accuracy filtering** - Reject poor GPS fixes to avoid unnecessary processing
3. **Use batch sync** instead of instant - Reduces network usage and wake-ups
-4. **Create geofences** for home/work - GPS stops completely in zones
+4. **Create geofences** for home/work - Stops recording locations in zones
5. **Enable movement threshold** - 10-50m, skip stationary updates
6. **Disable battery optimization** for Colota in Android settings to prevent the OS from killing the service
diff --git a/apps/docs/docs/guides/geofencing.md b/apps/docs/docs/guides/geofencing.md
index c357f2c8..54547057 100644
--- a/apps/docs/docs/guides/geofencing.md
+++ b/apps/docs/docs/guides/geofencing.md
@@ -4,12 +4,12 @@ sidebar_position: 1
# Geofencing
-Create zones where tracking pauses automatically. These "pause zones" save battery and stop recording at places you visit often.
+Create zones where location recording stops automatically. These "pause zones" stop saving and syncing locations at places you visit often. GPS stays active to detect when you leave the zone.
## Use Cases
- **Home** - Don't track when at home
-- **Work** - Pause tracking during work hours
+- **Work** - Stop recording during work hours
- **Frequent locations** - Save battery in places you visit often
## Setup
@@ -29,7 +29,7 @@ Create zones where tracking pauses automatically. These "pause zones" save batte
## How It Works
- Zone detection uses the Haversine formula (1-2ms per check)
-- When entering a pause zone, GPS stops updating
+- When entering a pause zone, location recording and syncing stops
- The notification shows "Paused: [Zone Name]"
- When exiting the zone, tracking automatically resumes
- Zone checks happen every location update with minimal overhead
diff --git a/apps/docs/docs/introduction.md b/apps/docs/docs/introduction.md
index 2e99fa98..6a1b1697 100644
--- a/apps/docs/docs/introduction.md
+++ b/apps/docs/docs/introduction.md
@@ -13,7 +13,7 @@ Colota is a self-hosted GPS tracking app for Android. It sends your location to
- **Privacy First** - No analytics, no telemetry, no third-party SDKs, no cloud services. Open source under AGPL-3.0.
- **Works Offline** - Works without a server. Store location history locally and export as CSV, GeoJSON, GPX, or KML.
- **Background Tracking** - Foreground service, auto-start on boot, retry with exponential backoff, battery-critical shutdown.
-- **Geofencing** - Create pause zones where tracking automatically pauses to save battery.
+- **Geofencing** - Create pause zones where location recording automatically stops.
- **Tracking Profiles** - Automatically switch GPS interval, distance filter, and sync settings based on conditions like charging, car mode, or speed thresholds.
- **Sync Modes** - Instant, batch, or offline. Wi-Fi only sync, configurable intervals with automatic retry.
- **Data Export** - Export location history in CSV, GeoJSON, GPX, or KML formats.
diff --git a/apps/mobile/android/app/fastlane/metadata/android/en-US/full_description.txt b/apps/mobile/android/app/fastlane/metadata/android/en-US/full_description.txt
index ab4ebebe..ae4b3c5c 100644
--- a/apps/mobile/android/app/fastlane/metadata/android/en-US/full_description.txt
+++ b/apps/mobile/android/app/fastlane/metadata/android/en-US/full_description.txt
@@ -7,7 +7,7 @@ Colota is an open-source GPS tracking application that sends your location to yo
<li><b>Privacy First</b> - No analytics, no telemetry, no third-party SDKs. Licensed under AGPL-3.0</li>
<li><b>Works Offline</b> - Locations are queued locally and synced when connectivity returns. Export as CSV, GeoJSON, GPX, or KML</li>
<li><b>Reliable Tracking</b> - Foreground service with auto-start on boot, exponential backoff for failed syncs</li>
-<li><b>Geofencing</b> - Define pause zones to automatically stop tracking in specific areas</li>
+<li><b>Geofencing</b> - Define pause zones to automatically stop recording locations in specific areas</li>
<li><b>Flexible Sync</b> - Instant send, periodic batch sync, or fully offline mode</li>
<li><b>Authentication</b> - Basic Auth, Bearer Token, or custom headers with AES-256-GCM encryption</li>
<li><b>Quick Setup</b> - Configure devices instantly via colota:// deep links or QR codes</li>
diff --git a/apps/mobile/src/screens/GeofenceScreen.tsx b/apps/mobile/src/screens/GeofenceScreen.tsx
index 45212b80..096c8b88 100644
--- a/apps/mobile/src/screens/GeofenceScreen.tsx
+++ b/apps/mobile/src/screens/GeofenceScreen.tsx
@@ -389,7 +389,7 @@ export function GeofenceScreen({}: ScreenProps) {
<View style={styles.empty}>
<Text style={[styles.emptyText, { color: colors.textSecondary }]}>No geofences yet</Text>
<Text style={[styles.emptyHint, { color: colors.textLight }]}>
- Create a geofence to pause tracking in specific areas
+ Create a geofence to stop recording locations in specific areas
</Text>
</View>
) : null