https://github.com/owntracks/android

OwnTracks Android App
https://github.com/owntracks/android

android client geolocation http java json mqtt owntracks

Last synced: 3 days ago
JSON representation

OwnTracks Android App

• Host: GitHub
• URL: https://github.com/owntracks/android
• Owner: owntracks
• License: epl-1.0
• Created: 2014-02-03T12:56:26.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2024-10-28T19:53:17.000Z (3 months ago)
• Last Synced: 2024-10-29T17:12:13.285Z (3 months ago)
• Topics: android, client, geolocation, http, java, json, mqtt, owntracks
• Language: Kotlin
• Homepage: http://owntracks.org
• Size: 16.1 MB
• Stars: 1,366
• Watchers: 75
• Forks: 475
• Open Issues: 73
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# OwnTracks for Android

This is the OwnTracks Android app. See our [booklet](http://owntracks.org/booklet/features/android/) for details on how to get started with OwnTracks, as well some details about behaviour specific to the Android app.

![GitHub License](https://img.shields.io/github/license/owntracks/android) ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/owntracks/android/build-and-test.yaml?branch=master) [![Get it on Google Play](https://img.shields.io/endpoint?color=green&logo=google-play&logoColor=green&url=https%3A%2F%2Fplay.cuzi.workers.dev%2Fplay%3Fi%3Dorg.owntracks.android%26gl%3DUS%26hl%3Den%26l%3D%24name%26m%3D%24version)](https://play.google.com/store/apps/details?id=org.owntracks.android&hl=en_GB) [![F-Droid Version](https://img.shields.io/f-droid/v/org.owntracks.android)](https://f-droid.org/en/packages/org.owntracks.android/) [](https://apt.izzysoft.de/packages/org.owntracks.android)

## Build flavours

There are two build flavours for OwnTracks:

* `gms`: This is the build published to the [Google Play Store](https://play.google.com/store/apps/details?id=org.owntracks.android). It links to and requires the Google Play Services libraries for location (using the Google location APIs), as well as the Google Maps SDK for drawing the main map.

* `oss`: This is an "un-Googled" build, which does not require or depend on Google Play Services. It uses the built-in android location capabilities and defaults to [OpenStreetMap](https://www.openstreetmap.org/) for the main map. Available via [F-Droid](https://f-droid.org/packages/org.owntracks.android/).

Both flavours are published as an APK to Github releases.

### Signing keys

* Google Play store-distributed builds are signed with Google's App signing key: `02:FD:16:4A:95:46:17:F0:B7:94:57:97:37:C9:7A:07:B8:31:83:1D:0A:05:90:C3:8D:07:2B:FE:29:01:08:F1`

* APKs attached to Github Releases are signed with our own key: `1F:C4:DE:52:D0:DA:A3:3A:9C:0E:3D:67:21:7A:77:C8:95:B4:62:66:EF:02:0F:AD:0D:48:21:6A:6A:D6:CB:70`

* F-Droid builds are signed with their own key, details at 

## Contributing

Pull requests welcome! Please see [CONTRIBUTING.md](https://github.com/owntracks/android/blob/master/CONTRIBUTING.md) for details on how to build the project locally.

If you spot a translation issue or want to help contribute translating the app into other languages, you can visit [POEditor](https://poeditor.com/projects/view?id=419041) and help out.