96 lines
5.5 KiB
Markdown
96 lines
5.5 KiB
Markdown
# Trackbook - Android Movement Recorder
|
|
<img src="https://raw.githubusercontent.com/y20k/trackbook/master/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.png"
|
|
width="192" />
|
|
|
|
**Version 2.1.x ("See Emily Play")**
|
|
|
|
Trackbook is a bare-bones app for recording your movements.
|
|
Trackbook is great for hiking, vacationing, or working out.
|
|
Once started, it traces your movements on a map.
|
|
The map data is provided by [OpenStreetMap (OSM)](https://www.openstreetmap.org/).
|
|
|
|
Trackbook is free software.
|
|
It is published under the [MIT open-source license](https://opensource.org/licenses/MIT).
|
|
Trackbook uses [osmdroid](https://github.com/osmdroid/osmdroid) to display the map, which is also free software published under the [Apache License](https://github.com/osmdroid/osmdroid/blob/master/LICENSE).
|
|
Want to help? Please check out the notes in [CONTRIBUTE.md](https://github.com/y20k/trackbook/blob/master/CONTRIBUTE.md) first.
|
|
|
|
|
|
## Install Trackbook
|
|
You can install it via Google Play and F-Droid - or you can go and grab the latest APK on [GitHub](https://github.com/y20k/trackbook/releases).
|
|
|
|
[<img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png"
|
|
width="192">](https://play.google.com/store/apps/details?id=org.y20k.trackbook)
|
|
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
|
|
width="192">](https://f-droid.org/packages/org.y20k.trackbook/)
|
|
|
|
|
|
## Good To Know
|
|
|
|
### Start Recording via Quick Settings Tile
|
|
<img src="https://user-images.githubusercontent.com/9103935/74753187-09a75f00-5270-11ea-82de-18c5b8737e2b.png"
|
|
width="320" />
|
|
<br/>
|
|
You can start a recording without opening Trackbook.
|
|
Just pull down the System's Quick Settings and tap on the "Start Recording" tile.
|
|
You'll need to manually add Trackbook's Recording tile to Quick Settings first.
|
|
You can find information on customizing Quick Settings [here](https://support.google.com/android/answer/9083864) and [here](https://www.xda-developers.com/get-custom-quick-settings-tiles/).
|
|
|
|
### Save Recordings as GPX
|
|
Recordings can be exported as GPX ([GPS Exchange Format](https://en.wikipedia.org/wiki/GPS_Exchange_Format)).
|
|
Tap on the save button in the lower-right corner of a previously recorded track.
|
|
|
|
### Copy GPX Files Manually
|
|
Trackbook automatically generates GPX files for every recording.
|
|
You can find them in the folder `/Android/data/org.y20k.trackbook/files/gpx/` on your device's storage.
|
|
|
|
### How does Trackbook measure distance?
|
|
Trackbook calculates the distance between markers and adds them up.
|
|
|
|
### How does Trackbook measure altitude?
|
|
Many devices have altitude sensors (of varying accuracy).
|
|
Trackbook compares the altitude of each new marker with the previously stored altitude.
|
|
The difference is added to either the uphill or downhill elevation value.
|
|
|
|
### What does "accuracy threshold" mean?
|
|
Every location fix that Trackbook receives is associated with an accuracy estimate.
|
|
You can look up how Android defines accuracy in the [developer documentation](https://developer.android.com/reference/kotlin/android/location/Location.html#getaccuracy).
|
|
`Accuracy Threshold` is the value from which location fixes are rejected.
|
|
It can be adjusted in Trackbook's settings.
|
|
You can increase the value if your recordings tend to be incomplete.
|
|
Trackbook will then also record less accurate location fixes.
|
|
|
|
## Where are my old recordings?
|
|
The F-Droid version of Trackbook features an auto-importer for old recordings.
|
|
Sadly I was not able to implement the auto-importer for the Play Store version of Trackbook due to SDK requirements / restrictions.
|
|
That is partly my fault and I am very sorry.
|
|
There is a (quite complicated) solution to get back your old recordings.
|
|
Please head over to the [Wiki](https://github.com/y20k/trackbook/wiki) to find out how.
|
|
|
|
## A word on privacy
|
|
Trackbook begins to store location data on a device as soon as a user presses the record button.
|
|
Those recordings are stored in the directory `/Android/data/org.y20k.trackbook/files/`.
|
|
They never leave the device.
|
|
There is no web-service backing Trackbook.
|
|
|
|
Trackbook does not use Google Play Services to get its location data.
|
|
It will, however, try to use data from the [NETWORK_PROVIDER](https://developer.android.com/reference/android/location/LocationManager#NETWORK_PROVIDER) on your device to augment the location data it received via GPS.
|
|
The NETWORK_PROVIDER is a system-wide service that Trackbook has no control over.
|
|
This service will usually query an online database for the location of cell towers or Wi-Fi access points a device can see.
|
|
You can prevent those kinds of requests on your device if you set the location preferences system-wide to `Device Only`.
|
|
Additionally, Trackbook offers a `Restrict to GPS` setting that deactivates the NETWORK_PROVIDER just within the app.
|
|
|
|
## Screenshots (v2.0)
|
|
<img src="https://raw.githubusercontent.com/y20k/trackbook/master/metadata/en-US/phoneScreenshots/01-map-recording-active.png"
|
|
width="240" />
|
|
<img src="https://raw.githubusercontent.com/y20k/trackbook/master/metadata/en-US/phoneScreenshots/02-map-context-menu.png"
|
|
width="240" />
|
|
|
|
<img src="https://raw.githubusercontent.com/y20k/trackbook/master/metadata/en-US/phoneScreenshots/03-track-list.png"
|
|
width="240" />
|
|
<img src="https://raw.githubusercontent.com/y20k/trackbook/master/metadata/en-US/phoneScreenshots/04-track.png"
|
|
width="240" />
|
|
|
|
<img src="https://raw.githubusercontent.com/y20k/trackbook/master/metadata/en-US/phoneScreenshots/05-settings.png"
|
|
width="240" />
|
|
<img src="https://raw.githubusercontent.com/y20k/trackbook/master/metadata/en-US/phoneScreenshots/06-quick-settings-tile.png"
|
|
width="240" />
|