This repository is a mirror of the original fit-tool project source(bitbucket).

The repository was created to apply minor bugfixes and add additional encoding workout samples.

Setup

This version of fit tool can be added to your Python environment by installing from source official instructions.

Example Install:

# change dir to_location_of_this_readme
# the "." indicates install source from (here)
python -m pip install .

Usage: Encoding a Workout

The supplied write_workout_example.py mechanizes the examples found in the FIT SDK Cookbook. For ease of use each example is within a function:

• create_bike_tempo_workout
• create_run_800_repeats_workout
• create_custom_target_values
• create_pool_swim

To create all examples:

cd examples/
python write_workout_example.py

which should produce an output message:

created: /c/your/path/to/repository/examples/Tempo_Bike_workout.fit
created: /c/your/path/to/repository/examples/Tempo_Bike_workout.csv
created: /c/your/path/to/repository/examples/800m_Repeats_workout.fit
created: /c/your/path/to/repository/examples/800m_Repeats_workout.csv
created: /c/your/path/to/repository/examples/Custom_Target_Values_workout.fit
created: /c/your/path/to/repository/examples/Custom_Target_Values_workout.csv
created: /c/your/path/to/repository/examples/Pool_Swim_workout.fit
created: /c/your/path/to/repository/examples/Pool_Swim_workout.csv

Note

The generated workout files were individually checked by manually uploading the devices to a Garmin Forerunner 945.

1. connect watch to computer
2. using file explorer navigate to /Forerunner 945/Internal Storage/GARMIN/NewFiles
3. copy the fit file
4. disconnect watch and navigate to workout screen

One may also use the FIT CSV Tool obtained from SDK Download.

General Fit Tool README

see: README_FIT_TOOL