GO-21 Help

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 1000 bike computer. Edit Edge Data operates on the FIT ( Flexible and Interoperable Data Transfer ) files stored on the Edge 1000 by first displaying a FIT's content, then allowing you to change any of those fields.



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.



Capabilities At A Glance

For this initial release Edit Edge Data has a single, specific, use:

  • Edit odometer and bike profile distances found in Setting.fit and Totals.fit only.
In subsequent versions Edit Edge Data will allow generalized editing of all Garmin FIT files, such as:
  • Locations.fit file that stores saved locations.
  • Records.fit file that stores personal records you have achieved.
  • Settings.fit file that stores user profile, device settings and bike profiles.
  • Sports folder that contains each activity profile as a separate FIT file.
  • Totals.fit file that stores activity profile totals for time and distance.
  • Weight.fit files obtained from a Tanita platform.



When you USB-connect your 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 :

  • Use the Finder and click to Edge 1000 → Garmin.
  • Use the Terminal command line and cd /Volumes/Edge\ 1000/Garmin.
Upon examination, notice all the FIT files and folders of FIT files. So now what? Here's the short answer :
  • If you haven't done so already, make a backup copy the target FIT file, as described in the Disclaimer section. Because that's a backup, now make a second copy of the file - the version that you will actually edit! Trust me on this.
  • Run Edit Edge Data and click File → Open FIT ....
  • Select a stanza from the popup menu, make your change, and click Queue This Edit. You can make multiple changes which are queued for later processing.
  • Save the FIT to yet another file. During the save operation the edit queue of modifications is applied, on-the-fly.
  • Copy the edited FIT to the Edge 1000 → Garmin → NewFiles folder and rename it to its original name.
  • Eject the Edge 1000 and disconnect the USB cable.
  • Restart the Edge 1000. During startup files in the NewFiles folder are copied to their proper destinations and installed. You should see your changes on the device.


The Distance Editor

The Edge 1000 has one odometer that tracks the total distance the device has traveled, and which you can see by touching HistoryTotalsDevice Totals. This information is kept in the file Totals.fit. (Oddly, there is another odometer distance in the file Settings.fit, whose function is currently unkown; however, the Distance Editor can edit that field if you find the need.) But having just a single odometer is problematic for folks who have multiple bicycles and want to tally distance on a per-bike basis. The typical work-around is to create an Activity Profile for each bike, which, among other things, keeps a distance total for that activity. Thus, as long as you remember to select the profile corresponding to the bike you are riding, distance per bike is accurate. As with the odometer, activity profile distances are also maintained in the Totals.fit file. In short, to modify any Edge distance pertinent to the typical cyclist, edit Totals.fit.

Now 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 62 metric-century-miles 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 somwhere 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 clicks File → Open FIT ... and selects ~/Desktop/Totals.fit. When she clicks the App's pulldown button she sees her three bike profiles and the distance traveled by each bike. Notice the distances are in miles, but that's a Preference option - you may use kilometers if desired. So the task at hand is to subtract 62 miles from bike profile #3 (the mountain bike) and add 62 miles to profile #4 (the road bike).

  • Alice whips out her iPhone and uses her favorite calculator App GO-21 SciRPN (available on the iOS App Store) to compute 461 - 62 = 399 and 2,736 + 62 = 2,798. 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.

  • NOTE: the device total odometer distance is stored in bike profile #1. Verify that it is the same value as the sum of your bike profile distances.

  • 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.


Other Edit Edge Data FIT Editors

Only the Distance Editor is available at this time.



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



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