Garmin to Hevy data converter

This is a simple tool to convert Garmin Strength workout data in JSON format to CSV files that can be imported into Hevy. The actual format is the CSV export format from the Strong app (at the time of writing, the only importable data type in Hevy).

Prerequisites

• Either:
  • Download the latest release from the releases page for your platform
• Or Build from source:
  • Go 1.21 or later
  • Git to clone the repo

Usage

1. Get the JSON data from Garmin. I used this Chrome extension.
2. Optionally create a file named "customExerciseNames.json" in the same directory as the tool. This file can be used to map Garmin exercise names to Hevy exercise names. See customExerciseNames.json for an example.
3. Run the tool:

# From an executable the releases page
./GarminToHevy-macos-arm64 <path-to-json-file>

# Directly from the repo
go run . <path-to-json-file>
e.g. 
go run . ./data.json

# Optionally you can specify the output file name as a second argument. 
# By default it will be named "Converted_Garmin_Workouts.csv"
go run . <path-to-json-file> <name-of-csv-file-without-extension>
e.g.
go run . ./data.json myImportFile

4. Use Hevy's import feature to import the CSV file.

Notes

• The tool has been tested once, and probably won't be updated unless I need to use it again.
• Only English language is supported for the Garmin exercise names.
• Only KG is supported. This would be an easy fix though.
• The tool will skip any workouts that are not strength workouts.
• The tool will skip any warmup or rest steps from the Garmin data. Any data without rep values will be set as 1 rep.
• Exercise names picked from Garmin data will prioritize the name with the highest "probability" value. It seems that any manually set exercises have this set to 100 and will thus be picked.
• Only a subset of Garmin Excercises are mapped at the moment. I only mapped the exercises I've done in the last couple of years. PRs are welcome for these.
• Due to Garmin's limited selection of exercises, I had to use some placeholders for my own workouts. Yours might not match. To change these, edit the values in the conversions.go customExercises map.
• The tool tries to avoid creating custom exercises in Hevy, but I ended up with some from my custom setup.

Known Issues

• Currently the following exercises create custom entries in Hevy with identical names to the default ones. Fixing this when I have an idea why it's happening.

  Lying Neck Extension (Weighted)
  Seated Cable Row - Bar Wide Grip
  Seated Cable Row - V Grip (Cable)
  Single Arm Lateral Raise (Cable)
  Walking Lunge (Dumbbell)