Forked from Bunnie's Watch Mapper / https://www.bunniestudios.com/blog/?p=5863

Plots Activities (run, walk, swim, etc) from a Garmin device's FIT file on OpenStreetMap using folium and fitparse.

Tested with FIT files extracted from a Garmin Forerunner 245

Works with python 3.9 and above.

pip install watchmap

The FIT files describing your activities can be retrieved by mounting your Garming device as USB mass storage, and looking in $MOUNTPOINT/GARMIN/Activity/*.fit

Simply run the tool, providing the name of the input FIT file and output HTML map:

usage: watchmap [-h] -i INPUT -o OUTPUT_DIR

Plot Garmin Activity on a map

optional arguments:
  -h, --help            show this help message and exit
  -i INPUT, --input INPUT
                        Input FIT file
  -o OUTPUT_DIR, --output_dir OUTPUT_DIR
                        Output directory (output will be written in output_dir/{input}.html)

To run watchmap through docker, use the run_docker.sh script:

./run_docker.sh $INPUTFILE.FIT $OUTPUT_DIRECTORY