https://github.com/dietrichmax/colota
Colota - Android GPS Location tracker
https://github.com/dietrichmax/colota
android google-timeline gps-tracker gps-tracking location location-tracker react-native
Last synced: 2 days ago
JSON representation
Colota - Android GPS Location tracker
- Host: GitHub
- URL: https://github.com/dietrichmax/colota
- Owner: dietrichmax
- License: agpl-3.0
- Created: 2026-01-20T16:12:32.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-06-06T14:57:58.000Z (9 days ago)
- Last Synced: 2026-06-06T16:12:50.214Z (9 days ago)
- Topics: android, google-timeline, gps-tracker, gps-tracking, location, location-tracker, react-native
- Language: TypeScript
- Homepage: https://colota.app/
- Size: 133 MB
- Stars: 272
- Watchers: 3
- Forks: 7
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - dietrichmax/colota - Colota - Android GPS Location tracker (TypeScript)
README
# Colota - GPS Location Tracker
[](https://github.com/dietrichmax/colota/releases) [](https://www.gnu.org/licenses/agpl-3.0) [](https://play.google.com/store/apps/details?id=com.Colota&hl=en-US) [](https://f-droid.org/de/packages/com.Colota) [](https://apt.izzysoft.de/fdroid/index/apk/com.Colota)
**Self-hosted GPS tracking app for Android.**
Colota sends your location to your own server over HTTP(S). It works offline, supports geofencing, and has no analytics or telemetry.
[Documentation](https://colota.app/docs/introduction) | [Privacy Policy](https://colota.app/privacy-policy)
## Features
- **Self-Hosted** - Send location data to your own server. Works with Dawarich, GeoPulse, Home Assistant, OwnTracks, 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, calendar with activity dots and per-trip export.
- **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.
- **Flexible Sync** - Instant, batch or offline modes. Restrict sync to Wi-Fi, a specific SSID or VPN.
- **App Shortcuts** - Long-press the app icon to start or stop tracking directly 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. Optional mutual TLS (mTLS) with a PKCS12 client certificate stored in Android Keystore.
- **Dark Mode** - Full light and dark theme support.
## Screenshots
Dashboard
Location History (Map)
Trip Details
Trips
Settings
TrackingProfiles
Authentication
Dark Mode
## Quick Start
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
5. Press **Start Tracking**
For full setup, server configuration, and integration guides, see the [documentation](https://colota.app).
## 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.
## Build from Source
> **Requirements:** Node.js >= 22, Android SDK, JDK 17+
```bash
git clone https://github.com/dietrichmax/colota.git
cd colota
npm ci
npm run build -w @colota/shared
cd apps/mobile/android
./gradlew assembleGmsRelease # Google Play variant
./gradlew assembleFossRelease # F-Droid variant (no Google Play Services)
```
## Contributing
See the [Contributing Guide](https://colota.app/docs/contributing) for details on reporting issues, submitting pull requests, and code style.
## License
[AGPL-3.0](LICENSE) - Copyright (C) 2026 Max Dietrich
## Support
- [GitHub Issues](https://github.com/dietrichmax/colota/issues)
- [GitHub Discussions](https://github.com/dietrichmax/colota/discussions)