Skip to content

Latest commit

 

History

History
executable file
·
49 lines (29 loc) · 1.33 KB

README.md

File metadata and controls

executable file
·
49 lines (29 loc) · 1.33 KB

WatchMap

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.

screenshot

Supported devices

Tested with FIT files extracted from a Garmin Forerunner 245

Dependencies

Works with python 3.9 and above.

Install python dependencies:

pip install -r requirements.txt

Retrieving FIT files

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

Usage

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

usage: watchmap.py [-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)

Docker

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

./run_docker.sh $INPUTFILE.FIT $OUTPUT_DIRECTORY