App: Edit Edge Data
Developer: Stephen Lidie
Genres: Sport, Dienst­programme

Edit Edge Data for macOS is a binary editor that changes the values of common data items found on your Garmin Edge bike computer. Edit Edge Data operates on the Flexible and Interoperable Data Transfer (FIT) files stored on the Edge by first displaying a FIT's content, then allowing you to change any of those fields.

This App exists primarily because of a particular demand to manipulate an Edge's various device and trip odometer values stored in the Settings and Totals FITs, see the section Edge Odometers for details.

Capabilities At A Glance

- Various FIT editors, each designed to perform a simple task upon a specific type of Garmin Edge FIT file:

      + Settings.fit - the Settings Editor changes age, height, weight and device odometer.

      + Totals.fit - the Totals Editor targets a specific Activity Profile and changes the profile trip odometer, ride count, ride time and calories. Even if your Edge device does not explicitly support Activity Profiles it likely contains a single, unadvertised, pseudo Activity Profile.

      + Activities FIT - the Activities Editor changes an activity's ride distance, speed, vertical and time. These FITs are named with the ride's starting date and time; e.g. 2021-03-29-18-04-13.fit. Remember that an Activities FIT is not the same as an Activity Profile: each ride generates a timestamp-named Activities FIT, while Activity Profiles summarize all of your ride Activities.

- Ability to display the binary contents of a FIT in a vaguely readable format:

      + Opening an unsupported FIT type will fail, but then allow you to dump the file.

      + During FIT editing click its filename, or use the File menu item Display FIT to dump the file.

      The FIT dump includes all extracted data structures, if any, and a field-by-field breakdown of the entire file.

The FIT dump includes all extracted data structures relevant to the current FIT editor, if any, and a field-by-field breakdown of the entire file.

Visit https://www.bigcatos.com for FIT technical information and a detailed usage example with illustrations.

Edge Odometers

The Edge bike computer has two odometers, analagous to an automobile, one that tracks the total distance the device has traveled and typically cannot be reset, and another trip odometer that can be reset to zero. You can examine the Edge device odometer by touching History → Totals → Device Totals. Additionally, the Edge maintains resettable ride count, ride time and calories.

But having just one instance of this data is problematic for folks who have multiple bicycles and want to tally distance / rides / time / calories on a per-bike basis. Assuming your device supports it, the typical work-around is to create and uniquely name a user Activity Profile that tablulates this information for each bike. Thus, as long as you remember to select the Activity Profile corresponding to the bike you are riding, distance / rides / time / calories per bike is accurate. An Activity Profile contains these items:

- unique name
- odometer
- count
- time
- calories

Interestingly, exactly where all this information is stored depends, indeed, on whether your Edge device supports user Activity Profiles:

- NO
The device odometer is stored in Settings.fit and there is one pseudo Activity Profile in Totals.fit with the trip odometer, ride count, ride time and calories. The reason this is called a pseudo Activity Profile is because there is no unique name associated with it.

- YES
The device odometer and all trip odometers are associated with multiple, uniquely named Activity Profiles, and those profiles are stored in Totals.fit, as well as ride count, ride time and calories for each Activity Profile. The old fashioned device odometer in Settings.fit is vestigial and not used.

Release notes:
- Re-fix preferences bug that could mix units for first-time users.
- Update for macOS 13.1.