Skip to content

agorf/fit2gpx

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

fit2gpx

Convert Garmin .fit files to .gpx

Features:

  • Support bulk-conversion (one or more files)
  • Preserve location (latitude, longitude), time and altitude
  • Preserve heart rate and cadence extensions
  • Name GPX file to follow Garmin's original naming of <time>-<location>-<activity_type>.gpx

Install

Get the source:

git clone https://github.com/agorf/fit2gpx.git
cd fit2gpx

Install it in your machine:

python -m venv .venv
source .venv/bin/activate
pip install .

Note: Requires Python ≥ 3.8. Dependencies (installed automatically): fitdecode, geopy.

You can also use Docker:

docker build -t fit2gpx .

See Usage section on how to run it with Docker.

Usage

Convert a single file in the current directory:

fit2gpx 19608508047_ACTIVITY.fit

Example output:

19608508047_ACTIVITY.fit -> 2025-07-02T04:39:39+00:00-argithea-mountaineering.gpx

Note: Each .gpx file is written under the same directory as its corresponding .fit file.

With Docker:

docker run --rm -v .:/work fit2gpx 19608508047_ACTIVITY.fit

Convert all files in the current directory:

fit2gpx *.fit

With Docker:

docker run --rm -v .:/work fit2gpx *.fit

License

MIT

Author

Angelos Orfanakos

About

Convert Garmin FIT activity files to GPX with extensions support (heart rate, cadence)

Resources

License

Stars

Watchers

Forks