diff --git a/README.md b/README.md index acf1002..74631cf 100644 --- a/README.md +++ b/README.md @@ -1,96 +1,18 @@ -# Trackbook - Android Movement Recorder - +trkpt +===== -**Version 2.1.x ("See Emily Play")** +This is a fork of [Trackbook](https://codeberg.org/y20k/trackbook) by y20k. Thank you y20k for this great project. -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/). +The goal of this fork is to make 24/7 recording easier. I want to be able to run trkpt nearly all of the time. The main differences between trkpt and Trackbook are: -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. +1. trkpt stores points in an SQLite database instead of json files. + • Instead of storing the database in the app's private area (`/Android/data/...`), you can put the database in a folder that you sync to your PC with [Syncthing](https://f-droid.org/en/packages/com.nutomic.syncthingandroid/). -## 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). +2. trkpt does not store "tracks" as objects. Instead, tracks are rendered and exported on the fly by querying the database of trackpoints. -[](https://play.google.com/store/apps/details?id=org.y20k.trackbook) -[](https://f-droid.org/packages/org.y20k.trackbook/) +3. trkpt adds the feature of "homepoints". When you are near a homepoint, trackpoints are not recorded. You can put a homepoint at your house or other places where you spend lots of time, so that you don't get large clouds of useless trackpoints at those locations. + • Although Trackbook has a feature to omit points that are close together, natural GPS inaccuracy and drift is large enough to create points that are far apart, leading to clouds over time. -## Good To Know - -### Start Recording via Quick Settings Tile - -
-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) - - - - - - - - +4. trkpt removes the feature of "starring" waypoints. I recommend using [OsmAnd](https://f-droid.org/en/packages/net.osmand.plus/) to store your favorite places.