Skip to content

Record a GPS run

Your phone records a run into your Workouts collection. The run shows its route as a map, with its distance, time and pace.

A run is not a special feature. It is a preset from the Library, made of general blocks that you can open and change: a property that records, three formulas and a button. The same blocks make a bike ride, a hike or a dog walk.

You need: the Kaizendex phone app (iPhone or Android) to record. Any app to see the runs.

The Start run button starts recording on the Route property. The phone records location into Route, or a watch or a GPX file fills it. Three formulas read Route: Distance 5.2 km, Time 28:00 and Pace 5:23 per km. When Route stops recording, an automation notifies you.Start run buttonPhonerecords locationWatch or fileApple Health, GPXRouteJSON, Map formatdraws the mapAutomationon stop: notify meDistance · 5.2 kmFormula: distance()Time · 28:00Formula: duration()Pace · 5:23 /kmFormula: Time / Distance
The route is data in a JSON property. Distance, Time and Pace are formulas that read it.

The Run preset

The Run preset for Workouts holds these blocks. Each one is a general block that works in any collection.

Block What it is Example value
Route a JSON property with the Map format and Record from: location the points of your run, drawn as a map
Distance a Formula: distance(prop("Route")) 5.2 km
Time a Formula: duration(prop("Route")) 28:00
Pace a Formula: prop("Time") / prop("Distance") 5:23 per km
Start run a card button whose one change is “start recording” on Route. See Card and row designs. —
Run finished (optional) an automation: when Route stops recording, notify me “5.2 km in 28:00”

Title and Entry date are built into every entry (“Morning run”, 27 Oct, 7:00 to 7:28).

Record a run

  1. Copy the Run preset from the Library into your Workouts collection. It adds the blocks above. The Start run button and the automation arrive switched off, like anything from the Library that can do something. Turn them on.

  2. On your phone, make a new Workouts entry from the Run preset and call it “Morning run”.

  3. Tap Start run. The first time, the phone asks you to let Kaizendex use your location. Kaizendex uses it only while a recording runs.

  4. The first time you record on this phone, a one-time battery setup screen opens. Some phone makers stop apps in the background to save battery. The screen tells you which setting to change on your phone, with a button that opens it. Change it once, and your recordings keep going.

  5. Put the phone away. It keeps recording with the screen off, and without a connection.

  6. Look at the phone during the run if you want. The entry fills the screen: the map grows, and Distance, Time and Pace update as you go. Tap Pause and Resume at a red light. Paused time does not count.

  7. Tap Stop. The automation runs once and notifies you: “5.2 km in 28:00”.

  8. Open “Morning run” on any device. The entry page shows the map and the three formulas.

A recording survives the phone

The phone saves each point to its own disk the moment it arrives. So if the app crashes, or the phone stops it in the background, you lose nothing. When the app comes back, the recording goes on. This is true for every recording, not only runs.

Fix a wrong distance

GPS is sometimes wrong, for example when you forget to tap Stop and walk home. Distance, Time and Pace are formulas, so you never type a number into them. You fix the route instead: remove the wrong points from the Route’s JSON. Distance, Time and Pace follow at once.

How the map lets you trim a route with a finger is not decided yet.

Runs from a watch or a file

  • From a watch. A run you record on a watch arrives through a connector (Apple Health or Health Connect) and fills the same Route property. The map and the formulas work the same. An automation can start on it with the Data comes in trigger. See Triggers.
  • From a file. Drop a GPX or GeoJSON file on a JSON property with the Map format. Its points fill the property. This works on every device, the computer included. (GPX and GeoJSON are common file formats for routes. Most sports apps can export them.)
  • Your past runs (later). Bringing in your whole history comes in a later stage. Then Health Connect asks for your full history when you first connect it (without it, Health Connect gives only 30 days). On the desktop app, an importer reads the export file from Apple Health in parts, and a Garmin importer reads your Garmin history with your own Garmin key (a code from Garmin that lets an app read your data). All three fill ordinary properties, such as Route, through the same Data comes in machinery as a connector.

Make it yours: a bike ride or dog walk with the same blocks

The blocks are general, so other activities need no new feature. Copy the Run preset, rename it, and change what you want.

Preset What changes Example
Bike ride Pace becomes Speed, a Formula: prop("Distance") / (prop("Time") / 60) 24.5 km/h
Hike nothing new; add a Tags property Trail if you like “Ridge loop”, 12.4 km in 3:40
Dog walk drop Pace; add a Relation to your Pets collection “Evening walk with Bruno”, 2.1 km
Gym session a JSON property Heart rate with Record from: heart rate and the Line format; Formulas average(prop("Heart rate"), "bpm") and max(prop("Heart rate"), "bpm") average 128, highest 171

Heart rate comes from a watch, through the phone.

Each JSON property records from one sensor. Starting two recordings with one tap (Route and Heart rate on the same run) is not decided yet.

More ideas:

On which devices

You want to… Phone apps Desktop app Web app
Record a run yes no: a computer has no GPS no: a browser stops when the screen is off
See the map and the formulas yes yes yes
Edit the route, chart your runs yes yes yes
Drop a GPX or GeoJSON file yes yes yes

On a computer, the Start run button says “Recording needs the phone app”.