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

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

Capabilities At A Glance

Edit Edge Data consists of various FIT editors, each designed for a specific, simple task, often directed at an Edge Activity Profile:

  • The Settings Editor changes age, height, weight and odometer values.
  • The Totals Editor targets a specific Activity Profile and changes profile distance, ride count, ride time and calories.
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.
  • Sports folder that contains each activity profile as a separate FIT file.
  • Weight.fit files obtained from a Tanita platform.

Topics

Introduction

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 :

  • 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 ... to open the desired FIT file.
  • Select a profile from the popup menu, make your changes, and click Queue This Edit. You can make multiple changes which are queued for later processing.
  • Use File → Save To FIT ... to 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.

Topics

The Totals Editor
Overview

The Edge bike computer 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; use the Settings Editor to edit that field if you find the need.) Additionally, the Edge tracks total ride count, total ride time and total calories.

But having just a device total for this data is problematic for folks who have multiple bicycles and want to tally distance / rides / time / calories on a per-bike basis. The typical work-around is to create an Activity Profile for each bike to individually tablulate this information. Thus, as long as you remember to select the profile corresponding to the bike you are riding, distance / rides / time / calories per bike is accurate.

The device totals profile, called the Summary Profile, is stored in profile slot one, with your personal activity profiles stored sequentially starting at slot two. This is the order that the profiles are listed in the profile selector popup menu.

Sample Usage

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 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 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 grabs her iPhone and uses her favorite calculator App ( GO-21 SciRPN, available on the iOS App Store 🙂 ) 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 Profile Details

Admittedly, the previous example was contrived, it was designed for simplicity and to illustrate essential Edge Editor 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 Profile remained the same because there was a symmetric change in two activity profiles - adding 100 km to one profile and subtracting 100 km from another did not change the overall device distance.

Perhaps a more typical case would involve editing a single bike profile, which means the sum of your personal bike profile data would no longer match the Summary Profile values. You can certainly edit the Summary 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 Profile always reflects the edits you make to the bike 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 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:

  • age
  • height
  • weight
  • odometer (not related to Totals.fit Activity Profile distances)
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 520
  • Edge 1000

Topics

Acknowledgment

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

Topics

Support

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

Topics