trkpt/README.md

<p align="center"><img src="https://raw.githubusercontent.com/voussoir/trkpt/master/trkpt_squircle_128x128.png"/></p>

trkpt
=====

This is a fork of [Trackbook](https://codeberg.org/y20k/trackbook) by y20k. Thank you y20k for this great project.

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. I have written more about this at [voussoir.net/writing/obsessed_with_gpx](https://voussoir.net/writing/obsessed_with_gpx). The main differences between trkpt and Trackbook are:

1. trkpt stores points in an SQLite database instead of json files.

    &bull; 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/).

2. trkpt does not store "tracks" as objects. Instead, tracks are rendered and exported on the fly by querying the database of trackpoints.

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.

    &bull; 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, especially while indoors, leading to clouds over time. You can choose the radius of your homepoint to eliminate these clouds.

## Power management

trkpt has three states of power management. The states transition like this:

1. **FULL POWER**: receives location updates as fast as Android provides them.

    Stay near homepoint for a few minutes → Sleep

    Unable to receive fix for several minutes and not charging → Dead

2. **SLEEPING**: receives location updates at a slower pace.

    Motion sensors → Full power

    Location leaves homepoint → Full power (presumably motion sensors will trigger, but just in case)

    Unplugged from charger → Full power (maybe you are getting ready to depart)

    Unable to receive fix for several minutes and not charging → Dead (time is doubled to accommodate slower sleeping pace)

3. **DEAD**: disables location updates.

    Motion sensors → Full power

    Plugged in to charger → Full power

Although saving battery power is important, capturing trackpoints is the #1 priority. I'd rather have too many wakeups than too few.

If your device doesn't support the motion sensors used here, then trkpt will always run at full power. It will not sleep or kill the GPS. Maybe we can find another solution to improve battery performance for devices in this scenario.

## Mirrors

https://github.com/voussoir/trkpt

https://gitlab.com/voussoir/trkpt

https://codeberg.org/voussoir/trkpt
Add power management to readme. 2023-04-02 00:53:34 +00:00			`<p align="center"><img src="https://raw.githubusercontent.com/voussoir/trkpt/master/trkpt_squircle_128x128.png"/></p>`

checkpoint 2023-03-14 00:34:40 +00:00			`trkpt`
			`=====`
initial commit 2016-08-29 12:50:41 +00:00
checkpoint 2023-03-14 00:34:40 +00:00			`This is a fork of [Trackbook](https://codeberg.org/y20k/trackbook) by y20k. Thank you y20k for this great project.`
Kotlin Rewrite - everything is new 2020-01-02 17:00:37 +00:00
Add power management to readme. 2023-04-02 00:53:34 +00:00			`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. I have written more about this at [voussoir.net/writing/obsessed_with_gpx](https://voussoir.net/writing/obsessed_with_gpx). The main differences between trkpt and Trackbook are:`
Fix grammar in .md files 2020-08-01 01:55:54 +00:00
checkpoint 2023-03-14 00:34:40 +00:00			`1. trkpt stores points in an SQLite database instead of json files.`
initial commit 2016-08-29 12:50:41 +00:00
Add "when was I here?" button. 2023-03-25 05:37:16 +00:00			`• 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/).`
initial commit 2016-08-29 12:50:41 +00:00
checkpoint 2023-03-14 00:34:40 +00:00			`2. trkpt does not store "tracks" as objects. Instead, tracks are rendered and exported on the fly by querying the database of trackpoints.`
now available on Google Play 2016-09-12 16:06:29 +00:00
checkpoint 2023-03-14 00:34:40 +00:00			`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.`
changed the install canary 2016-09-12 13:09:08 +00:00
Add power management to readme. 2023-04-02 00:53:34 +00:00			`• 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, especially while indoors, leading to clouds over time. You can choose the radius of your homepoint to eliminate these clouds.`

			`## Power management`

Describe exact power management state transitions in readme. 2023-04-03 00:14:45 +00:00			`trkpt has three states of power management. The states transition like this:`
Add power management to readme. 2023-04-02 00:53:34 +00:00
Describe exact power management state transitions in readme. 2023-04-03 00:14:45 +00:00			`1. FULL POWER: receives location updates as fast as Android provides them.`
Add power management to readme. 2023-04-02 00:53:34 +00:00
Describe exact power management state transitions in readme. 2023-04-03 00:14:45 +00:00			`Stay near homepoint for a few minutes → Sleep`

			`Unable to receive fix for several minutes and not charging → Dead`

			`2. SLEEPING: receives location updates at a slower pace.`

			`Motion sensors → Full power`

			`Location leaves homepoint → Full power (presumably motion sensors will trigger, but just in case)`

			`Unplugged from charger → Full power (maybe you are getting ready to depart)`

			`Unable to receive fix for several minutes and not charging → Dead (time is doubled to accommodate slower sleeping pace)`

			`3. DEAD: disables location updates.`

			`Motion sensors → Full power`

			`Plugged in to charger → Full power`

Don't use title case for strings on settings page. 2023-04-03 01:54:35 +00:00			`Although saving battery power is important, capturing trackpoints is the #1 priority. I'd rather have too many wakeups than too few.`
F-Droid release - yay 2016-09-15 14:48:19 +00:00
Add power management to readme. 2023-04-02 00:53:34 +00:00			`If your device doesn't support the motion sensors used here, then trkpt will always run at full power. It will not sleep or kill the GPS. Maybe we can find another solution to improve battery performance for devices in this scenario.`
Add "when was I here?" button. 2023-03-25 05:37:16 +00:00
			`## Mirrors`

			`https://github.com/voussoir/trkpt`

			`https://gitlab.com/voussoir/trkpt`

			`https://codeberg.org/voussoir/trkpt`