Skip to content

labcif/FIT2GPS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FIT2GPS

Repository for script to decode FIT files to coordinates and store them in a file and generate a map with the coordinates

Requirements

  • Python 3
  • Python libraries: fitdecode, folium, argparse, xlsxwriter, geopy

What is FIT

"FIT" is a commonly used acronym in the context of fitness apps and trackers, where it stands for "Flexible and Interoperable Data Transfer".

The FIT format in the context of fitness apps is a binary file format used to store health and fitness data such as workout information, heart rate data, and GPS data. It was developed by Garmin and is used by a variety of fitness trackers and apps, including Garmin devices, Strava, and many others.

The FIT format is designed to be flexible and interoperable, which means that it can be easily used and shared across different devices and platforms. It is also designed to be efficient and lightweight, so that it can be quickly processed and transmitted even on low-power devices like smartwatches.

Overall, the FIT format has become a popular standard for fitness data interchange, and is widely used by fitness enthusiasts, athletes, and trainers to track and analyze their performance and progress over time.

Parameters

- f, --file: FIT file
- t, --type: Type of output file. Options: html, kml
- e, --excel: Generate an excel file with the data (requires Internet connection)

Usage

python3 decode.py -f <file> -t <type>

Important

This script was done to decode the FIT files from the fitness application Strava, however we tested it with FIT files of other application such as Garmin and it worked, so we are pretty sure it will work for a wide range of fitness applications that generate FIT files.

Output

The script will create a file called coordinates.txt with the coordinates, a general.txt file with additional data found related to the activity and a map called map.html or a Google Earth file called map.kml.

License

This code is under the GNU General Public License v3.0. See the LICENSE file for more information.

About

Repository to decode FIT files

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages