Edit Edge Data
Garmin FIT Editor
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.

Topics

Capabilities At A Glance

Topics

Disclaimer

You must be deliberate and aware when using Edit Edge Data. Make backup copies off all FIT files that you plan on editing - see this Garmin knowlegde base article:

The essential idea is that you connect the Edge to a computer, wait for it to be mounted, and then copy files from the device to a backup location. Safely store these backup copies in case something becomes FUBAR. Use Edit Edge Data at your own risk, the App is provided on as "AS IS" basis only.

Topics

Overview

When you USB-connect your Edge (for example, an Edge 1000) to a Macintosh, after a short delay, it's mounted and appears in the /Volumes folder. It may also appear as a removable disk on your Desktop if the Finder Preference "show external disks" is enabled. A typical name is Edge 1000. To see the FIT files on the device navigate to the folder named Garmin :

Upon examination, notice all the FIT files and folders of FIT files, in particular Settings/Settings.fit and Totals/Totals.fit. So now what? Here's the short answer :

Topics

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 HistoryTotalsDevice 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. Thus, an Activity Profile contains these items:

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

† A note on distance units:

Topics

The Totals Editor
Sample Usage

Let's look at a concrete example. Suppose that Alice, who was running late for a group ride, forgot to set her Edge 1000 Activity Profile to match the bike she was riding that day. It was only after the ride that she realized there were an extra 100 metric-century-kilometers on her mountain bike that should really be on her road bike. Here is how Alice recovers from that mistake.

  • She connects her Edge 1000 via the Garmin-supplied USB cable to her iMac and uses the Finder to illuminate the full path to Totals.fit.

  • Alice is a prudent person, and using the Finder she makes a new folder on the Deskop named FITBackups, and then drags Totals.fit from the Edge to the backup folder. Remember, files in the backup folder are never edited. The Terminal commands to do this are :
    • mkdir ~/Desktop/FITBackups
    • cp /Volumes/Edge\ 1000/Garmin/Totals/Totals.fit ~/Desktop/FITBackups/Totals.fit

  • She duplicates Totals.fit somewhere that's convenient to edit, perhaps Desktop. This will be the input file to Edit Edge Data.
    • cp /Volumes/Edge\ 1000/Garmin/Totals/Totals.fit ~/Desktop/Totals.fit

  • She runs Edit Edge Data and selects the Totals Editor from the row of Editor tabs, then clicks File → Open FIT ... to choose ~/Desktop/Totals.fit. When she clicks the App's pulldown button she sees her three bike Activity Profiles and the distance traveled by each bike. Notice the distances are in kilometers, but that's a Preference option - you may use miles if desired. So the task at hand is to subtract 100 kilometers from bike profile #3 (the mountain bike) and add 100 kilometers to profile #4 (the road bike).

  • Alice uses her favorite calculator App GO-21 SciRPN, available on the iOS and macOS App Stores 🙂, to compute 741.599 - 100 = 641.599 km and 4403.713 + 100 = 4503.713 km. To make those two edits she first selects bike profile #3, makes the distance change, then clicks Queue This Edit.

  • She repeats the procedure for bike profile #4, resulting in this. Notice the Edit Queue has two entries and the Save To FIT ... button is enabled.

  • She clicks Save To FIT ..., which asks for a filename (perhaps Totals-1.fit), then processes the edit queue and writes the new output file. To double-check the results, Alice opens the new FIT file and sees that, indeed, her distances are back in synch.

  • Lasty, Alice needs to install the new FIT onto her Edge 1000. She does this by dragging Totals-1.fit to Edge 1000 → Garmin → NewFiles → Totals.fit. IMPORTANT: the filename must be Totals.fit, not Totals-1.fit.
    • cp ~/Desktop/Totals-1.fit /Volumes/Edge\ 1000.Garmin/NewFiles/Totals.fit

  • Eject the Edge 1000 and disconnect the USB cable. Restart the Edge 1000. Fini.
Summary Activity Profile

Admittedly, the previous example was contrived, it was designed for simplicity and to illustrate essential Edit Edge Data concepts. For instance, Alice only adjusted bike distance and failed to even consider changing ride time. But more importantly, the device totals stored in the Summary Activity Profile remained the same because there was a symmetric change in two bike Activity Profiles - adding 100 km to one profile and subtracting 100 km from another did not change the overall device odometer distance.

Perhaps a more typical case would involve editing a single bike Activity Profile, which means the sum of your personal bike Activity Profiles data would no longer match the Summary Activity Profile values. You can certainly edit the Summary Activity Profile just like any other profile, but that's a manual action prone to error; the Totals Editor can do that work for you, automatically. First, there is a Preference setting that you may enable so that the Summary Activity Profile always reflects the edits you make to the bike Activity Profiles. Even if this preference is off, the Save To FIT ... operation gives you the chance to make the update, which is highly recommended:

When you choose Yes an implict edit to update the Summary Activity Profile is generated on your behalf and added to the Edit Queue for processing when the new FIT is saved:

Topics

The Settings Editor

After selecting the Settings Editor from the row of Editor tabs, use it similarly to the Totals Editor to change multiple Settings.fit values:

Here is what the Settings Editor looks like when macOS is running with its Dark appearance:

Topics

Compatible Devices

Edit Edge Data has been tested on FIT files from these Edge Bike Computers :

  • Edge 130
  • Edge 520
  • Edge 820 Touring
  • Edge 1000
  • Edge 1030
My testing and verification really requires community input, I am constanly searching for FIT files from devices I do not own. If you have an unlisted device, please consider sending me at least its Totals.fit file. Thanks, support@bigcatos.com!

Topics

Acknowledgment

Many thanks to Kiyokazu SUTO suto@ks-and-ks.ne.jp for his fantastically thorough Perl modules that manipulate FIT bits.

Thanks to these folks who sent me test FIT files from devices I do not have:

  • Carsten Voss
  • Bob Perchonoko
  • Arsen Dzodzaev
  • Howard Postlethwaite

Topics

What's New?

2.5 - 2020.06.02

  • Support Edge 820 Touring Totals.fit and Settings.fit files, and hopefully other devices that do not support Activity Profiles.
  • Ability to dump a FIT.
  • Ensure conformance with Apple's 2020.06.30 App Store guidelines.
  • Update for macOS 10.15.4.

2.4 - 2019.09.15

  • Fix to support Edge 130 Totals.fit files.
  • Support the Settings.fit odometer_rollover field so distance over 42,949.67295 km is possible.
  • Update for macOS 10.15 Catalina.

2.3 - 2019.08.15

  • Update for macOS 10.14.6.
  • Fix to support Edge 1030 Totals.fit files.

2.2 - 2019.03.21

  • Update for macOS 10.14.3.
  • Documentation now supports BigCatOs Appearances.
  • Minimum macOS version is now 10.11 El Capitan.

2.1 - 2018.11.18

  • A new Settings Editor for editing a Settings.fit file : age, height, weight and odometer.
  • The Totals Editor now updates the Edge device totals stored in the Summary Profile.
  • Restore Cut / Copy / Paste.
  • Number format is locale dependant, e.g. 1234.56 for USA, 1234,56 for Germany.
  • Update for macOS 10.14.1.
  • Minor bug fixes.

2.0 - 2018.11.05

  • A new Totals Editor for editing a Totals.fit file : distance, time, rides and calories.
  • Add support for the Edge 520.
  • Now runs on earlier versions of macOS - 10.10 Yosemite and up.
  • Compatible with macOS Light and Dark appearances.

1.0 - 2018.10.05

  • Initial release for macOS 10.14 Mojave. The Distance Editor is capable of editing only odometer and bike profile distances found in Settings.fit and Totals.fit files.

Topics



Copyright (©) 2018 - 2020 BigCatOs. All rights reserved.   |   Contact