colota - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #llm #machine-learning #linux #awesome #cli #awesome-list #vue #security #pytorch #open-source

colota

(★ 575)

Colota - Android GPS Location tracker

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.md
  - config.yml
  - feature_request.md
- - build-check.yml
  - build-latest-release.yml
  - build-release.yml
  - codeql.yml
  - deploy-docs.yml
  - docs-check.yml
  - pr-labeler.yml
  - prepare-release.yml
- codeql-config.yml
- FUNDING.yml
- labeler.yml
- release-drafter.yml
- - .gitignore
  - docusaurus.config.ts
  - package.json
  - README.md
  - sidebars.ts
  - tsconfig.json
- - app.json
  - App.tsx
  - babel.config.js
  - eslint.config.js
  - index.js
  - jest.config.js
  - jest.setup.js
  - metro.config.js
  - package.json
  - tsconfig.json
- - .gitignore
  - package.json
  - tsconfig.json
- - Samsung Galaxy S21 Ultra Screenshot 1.png
  - Samsung Galaxy S21 Ultra Screenshot 2.png
  - Samsung Galaxy S21 Ultra Screenshot 3.png
  - Samsung Galaxy S21 Ultra Screenshot 4.png
  - Samsung Galaxy S21 Ultra Screenshot 5.png
  - Samsung Galaxy S21 Ultra Screenshot 6.png
  - Samsung Galaxy S21 Ultra Screenshot 7.png
- sync-screenshots.py
.gitignore
.nvmrc
.pre-commit-config.yaml
.prettierignore
.prettierrc.json
LICENSE
package-lock.json
package.json
README.md
renovate.json
SECURITY.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/dietrichmax/colota

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd colota

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

./gradlew assembleGmsRelease # Google Play variant

Gradle로 빌드를 진행합니다.

./gradlew assembleFossRelease # F-Droid variant (no Google Play Services)

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm ci

이 명령어를 터미널에 그대로 입력해 실행하세요.

npm run build -w @colota/shared

배포용으로 코드를 최적화해서 빌드 파일을 생성합니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="/packages/shared/logo/banner.svg" width="100%" alt="Colota Banner" />
</p>

# 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) [![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.**

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, 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, 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.
- **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

<table>
  <tr>
    <td><img src="screenshots/mobile/original/Dashboard.png" alt="Dashboard" width="200"/></td>
    <td><img src="screenshots/mobile/original/LocationHistory.png" alt="Location History (Map)" width="200"/></td>
    <td><img src="screenshots/mobile/original/TripDetails.png" alt="Trip Details" width="200"/></td>
    <td><img src="screenshots/mobile/original/Trips.png" alt="Trips" width="200"/></td>
  </tr>
  <tr>
    <td align="center">Dashboard</td>
    <td align="center">Location History (Map)</td>
    <td align="center">Trip Details</td>
    <td align="center">Trips</td>
  </tr>
</table>

<table>
  <tr>
    <td><img src="screenshots/mobile/original/Settings.png" alt="Settings" width="200"/></td>
    <td><img src="screenshots/mobile/original/TrackingProfiles.png" alt="TrackingProfiles" width="200"/></td>
    <td><img src="screenshots/mobile/original/Authentication.png" alt="Authentication" width="200"/></td>
    <td><img src="screenshots/mobile/original/DarkMode.png" alt="Dark Mode" width="200"/></td>
  </tr>
  <tr>
    <td align="center">Settings</td>
    <td align="center">TrackingProfiles</td>
    <td align="center">Authentication</td>
    <td align="center">Dark Mode</td>
  </tr>
</table>

## 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 (optional; on Android 13+ refusing it hides the status notification)
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, Overland, PhoneTrack, Reitti, Traccar and custom backends), geofencing, data export, API reference, battery optimization, troubleshooting and development setup.

## Build from Source

> **Requirements:** Node.js 24 (see `.nvmrc`), 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)