Fit2gpx

From OpenStreetMap Wiki
Jump to navigation Jump to search

General

fit2gpx cross-platform utility for converting new track and workout files from Garmin, Suunto, Bryton, Wahoo, etc. devices from FIT to GPX and CSV formats.

Converter Garmin .FIT files to GPX, CVS, HR, HRV, SpO2, Stress.

Features

The fit2gpx converter has two modes of operation: console and graphic. When running without files in parameters, a dialog box opens for selecting the file to convert. If you use the file name as an argument at startup, the conversion occurs without launching dialog boxes. If the conversion is successful, no information is returned to the console. The console mode can be used in various automation scripts.

Converter supports batch mode file processing for this in console mode, specify all file names as arguments to the program. In dialog mode, simply select multiple files in the selection dialog.

By default, without parameters, the FIT training file is converted to a GPX file.

To work with the fit2gpx Converter, you need Java RE, version 11 and higher. The Converter is written in Java and does not require any additional libraries, interpreters, or modules.

Usage:

    java -jar fit2gpx.jar --help

Console mode:

    java -jar fit2gpx.jar [options] <file Garmin .FIT> [[<file Garmin .FIT>] …]

Graphic dialog mode:

    java -jar fit2gpx.jar [options]

options:

       --statistic     | -s    output of final statistics to the console
            --csv           | -c    the output file will be in CSV format
            --hr-only       | -r    the output file will be in CSV format, content: heart rate and time only
            --monitor       | -m    parsing heart rate monitoring files (not training), the output file will be in CSV format
            --hrv           | -v    parsing training files and writing R-R intervals to CSV for variability analysis
            --hrv-filter    | -f    same as --hrv, but threshold filter is used to eliminate spikes
                    --filter=n      where: n - threshold filter value (for -f) in % from 1 to 99 (default 35)

            --oxy           | -o    parsing monitoring files and writing SpO2 oxygenation values in CSV
            --stress        | -i    parsing monitoring files and writing Stress values in CSV
                    fields in CSV: Date time; Garmin Stress Index; Body Battery; unknown; unknown

            --no-dialog     | -n    do not display the file selection dialog
            --save-empty    | -e    save files without coordinates (empty tracks)
            --full-dump 

Download

The source code of the fit2gpx converter is available on the project page on GitHub.

Binary file fit2gpx.jar is available there.

License

Apache-2.0 License

Version

7.02.2015 - the beginning of the development repository on GitHub

version 0.0.1 - 10.02.2015

version 0.1.0 (summer 2020) - 16.08.2020 - The first release of the Converter with basic features

[development] version 0.1.5 - autumn 2020 - working with erroneous and incorrect data

Issues

Error messages and suggestions for development are accepted on the project tracker.