FitNotes2Fit Converter

Status: working proof of concept

This project allows for converting workouts recorded on the FitNotes app to be made into .fit format, applicable in Garmin Connect and Strava for example.

FitNotes has the option to export all workouts into a csv file. So FitNotes2Fit parses the CSV file, divides the rows into workouts with respect to the date recorded, and encodes .fit files for each workout using the FitSDK for Java, containing the sets, reps and weights for each exercise recorded.

Additionally, by supplying an average heart-rate and average rest-time between sets, these can also be encoded into the fit file, to be used by the online platform they get uploaded to. For example, Strava uses the recorded set of heart-rate levels over time to record relative effort for each workout.

Get it from one of the releases

This repository contains Releases, from which you can directly download the latest uber-jar, and run it with Java JRE.

Running

java -jar fitnotes2fit.jar

This will show you the usage.

Converting a CSV into a set of fit files

java -jar fitnotes2fit.jar convert -i <path/to/file.csv> [-o <optional/output/dir/>] [-hr <average heartrate>] [-rt <average rest time (in minutes)>] [-m "<FitNotes exercise name>"=<FIT Exercise name>,"<FitNotes exercise name 2>"=<FIT Exercise name 2>,...]

• This will take the csv provided by -i <path/to/file.csv>, and will convert it to a set of fit files, one for each workout (distinguished by the Date column in the csv).

• The optional argument -o <optional/output/dir/> specifies the output folder. Otherwise the current directory will be used.

• This tool supports a limited set of exercises (not including all of the default exercises in FitNotes) The optional argument -m "<FitNotes exercise name>"=<FIT Exercise name>,... adds exercises to the list of available mappings. Use this to ensure that all your exercises are mappable. Use the list_exercises command to understand the list of possible FIT exercise names.

• The other two optional arguments are for "advanced" usage. If provided an average heart-rate, using -hr <average heartrate>, the converter will generate a set of "heart-rate-monitor" records around that average, and encode them within the output workouts.

• Average rest time in minutes (e.g. 1.5) can be provided with -rt <average rest time>. If provided, a random rest around that time (plus minus 1 minute) will be generated for each set. This helps with encoding a more appropriate time for the workout, which is useful for example in Strava, where the Relative Effort metric uses the heart-rate and time of activity to be calculated.

Listing all possible FIT exercise names

java -jar fitnotes2fit.jar list_exercises

For developers

Building for yourself

Note: Since this project relies on FitSDK, and the sdk is not available from any maven repository, you will have to download it yourself from the FitSDK site.

1. Clone the repo.
2. Download FitSDK, unzip and place the file <fitsdk-dir>/java/fit.jar into <fitnotes2fit-repo-dir>/lib/fit.jar.
3. Go into repo folder cd fitnotes2fit.
4. Run ./mvnw process-resources && ./mvnw install to install dependencies.
5. Run ./mvnw clean compile assembly:single to create a jar with all the dependencies in it. This will create a uber-jar at target/fitnotes2fit.jar.

• If a non-uber jar is required, you can simply run ./mvnw clean package.

Packages

A package for fitnotes2fit is also available to get from the GitHub repository here.

Since the package relies on FitSDK, and the SDK is not available in any repository, you will need to add it as a local dependency in your project. More information should be available in the package documentation.

Important limitations

• Not all default FitNotes exercises are supported out of the box. In the log of running the converter, these uncategorised exercises are mentioned. It is up to the user to provide mappings from the FitNotes exercise names to Fit exercise names. Check out the list_exercises command and the --mappings option of the convert command to understand how. This also allows you to map non-default exercises from FitNotes.

Readme TODO

• Present the mapping between fitnotes default exercises and fit categories.
• Document installation
• Document usage
• Document code

Links

FitNotes App

FitSDK

OpenCSV docs

Additional Fit docs