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

2. Ability to display the binary contents of a FIT in a vaguely readable dump 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 relevant to the current FIT editor, if any, and a field-by-field breakdown of the entire file.

Topics

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:

• Backing Up Your Personal Settings And Profiles On Edge Devices

Topics

When you USB-connect your Garmin bike computer (for example, an Edge 1000) to a Macintosh, one of two things will happen:

• 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 Setting "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.
• Garmin devices using recent firmware versions relying on Media Transfer Protocol (MTP) may not auto-mount on your Mac. If this occurs, use an MTP App such as MacDroid - available on the Mac App Store - to mount the device, then click Show in Finder. Another solution is OpenMTP, available from MacUpdate.com. Note the folder Internal Storage, and within that the actual Garmin folder.

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

  The device totals profile, called the Summary Activity Profile and named "" (the emptry string), is stored in profile slot one, with your personal Activity Profiles stored sequentially starting at slot two. This is the order that the Activity Profiles are listed in the profile selector popup menu. So even if you do not explicitly create Activity Profiles there is always one, the Summary Activity Profile, which doesn't necessarily representy device totals, rather, your bike Activity Profile totals, see section Summary Activity Profile for details.

† A note on distance units:

• The distances stored in Totals.fit Activity Profiles (or pseudo Activity Profile) are 32-bit unsigned integers with units of meters, so the maximum distance that can be recorded is 2³²-1 meters, or 4,294,967,295 meters, or 4,294,967.295 kilometers (approximately 2,668,768.94 miles).

• In contrast the Settings.fit odometer distance, while also a 32-bit unsigned integer, has units of ¹/₁₀₀ meter, for a maximum odometer distance of 42,949.67295 kilometers (approximately 26,687.6894 miles). Because this limit was routinely exceeded, an additional Settings.fit field called odometer_rollover was eventually added. Some Edge devices - presumably older ones - do not support odometer_rollover, but, if your device does, Edit Edge Data will honor it.

Topics

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 count, time and calories. 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 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 Setting 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

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)

Topics

After selecting the Activities Editor from the row of Editor tabs, use it similarly to the Totals Editor to change multiple activity values:

• distance
• speed
• vertical
• time

Topics