History

hughbarney 9a9625c112 Run: fixed distance calculation		2022-01-22 00:20:06 +00:00
..
ChangeLog	Run: fixed distance calculation	2022-01-22 00:20:06 +00:00
README.md	docs	2022-01-13 09:21:40 +00:00
app-icon.js	Add 'run' app	2022-01-12 15:46:38 +00:00
app.js	Run: fixed distance calculation	2022-01-22 00:14:10 +00:00
app.png	Add 'run' app	2022-01-12 15:46:38 +00:00
metadata.json	Run: fixed distance calculation	2022-01-22 00:20:06 +00:00
screenshot.png	add screenshot, minor tweaks	2022-01-12 15:59:30 +00:00
settings.js	Run: added settings menu, set pace and time format to mm:ss, h:mm:ss	2022-01-17 22:00:24 +00:00

README.md

Run App

This app allows you to display the status of your run, it shows distance, time, steps, cadence, pace and more.

To use it, start the app and press the middle button so that the red STOP in the bottom right turns to a green RUN.

Display

DIST - the distance travelled based on the GPS (if you have a GPS lock).
- NOTE: this is based on the GPS coordinates which are not 100% accurate, especially initially. As the GPS updates your position as it gets more satellites your position changes and the distance shown will increase, even if you are standing still.
TIME - the elapsed time for your run
PACE - the number of minutes it takes you to run a kilometer based on your run so far
HEART - Your heart rate
STEPS - Steps since you started exercising
CADENCE - Steps per second based on your step rate over the last minute
GPS - this is green if you have a GPS lock. GPS is turned on automatically so if you have no GPS lock you just need to wait.
The current time is displayed right at the bottom of the screen
RUN/STOP - whether the distance for your run is being displayed or not

Recording Tracks

Run doesn't directly allow you to record your tracks at the moment. However you can just install the Recorder app, turn recording on in that, and then start the Run app.

TODO

Allow this app to trigger the Recorder app on and off directly.
Keep a log of each run's stats (distance/steps/etc)