Skip to content

dietrichmax/colota

Repository files navigation

Colota Banner

Colota - GPS Location Tracker

Version License: AGPL v3 Google Play IzzyOnDroid

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 | Privacy Policy

Features

  • Self-Hosted - Send location data to your own server. Works with Dawarich, GeoPulse, OwnTracks, PhoneTrack, Reitti, Traccar, Home Assistant 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.
  • Location History - View daily summaries, trip segmentation, calendar with activity dots and per-trip export.
  • Reliable Tracking - Foreground service, auto-start on boot, exponential backoff retry and automatic GPS pause when stationary.
  • 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.
  • 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 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 with AES-256-GCM encryption.
  • Dark Mode - Full light and dark theme support.

Screenshots

Dashboard Location History (Map) Trip Details Trips
Dashboard Location History (Map) Trip Details Trips
Settings TrackingProfiles Authentication Dark Mode
Settings TrackingProfiles Authentication Dark Mode

Quick Start

  1. Install from Google Play or download the APK from GitHub Releases
  2. Grant location permissions (precise, all the time)
  3. Disable battery optimization for Colota
  4. Press Start Tracking

For full setup, server configuration, and integration guides, see the documentation.

Documentation

Full docs at colota.app covers configuration, server integration (GeoPulse, Dawarich, OwnTracks, PhoneTrack, Reitti, Traccar, Home Assistant, 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+

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 for details on reporting issues, submitting pull requests, and code style.

License

AGPL-3.0 - Copyright (C) 2026 Max Dietrich

Support

About

Colota - Android GPS Location tracker

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages