This script converts fitness data downloaded from the Festina app into GPX format, which can be used with various fitness and mapping applications.
- Node.js (version 14 or higher)
- NPM (usually comes with Node.js)
- Clone the repository or download and extract the ZIP archive.
- Open a terminal/command prompt and navigate to the project directory.
- Run
npm install
to install the required dependencies.
- Export your fitness data from the Festina app in JSON format.
- Save the exported JSON file to a location on your computer.
- Open a terminal/command prompt and navigate to the project directory.
- Run the following command to convert the JSON data to GPX format:
npm run convert -- /path/to/your/fitness-data.json
Replace /path/to/your/fitness-data.json
with the actual path to the exported JSON file.
- The script will create a new GPX file in the same directory as the input JSON file, with the same filename but with a
.gpx
extension. For example, if the input file is namedfitness-data.json
, the output file will be namedfitness-data.gpx
. - You can now import the generated GPX file into your preferred fitness or mapping application.
- The script combines location data with the last known heart rate value for each location data point.
- The GPX file generated by this script is compatible with various fitness and mapping applications, such as Strava, Garmin Connect, and Google Earth.
- This script is provided as-is, and there is no guarantee it will work with all fitness data exported from the Festina app. Please make sure to double-check the generated GPX file before using it with any other applications.
- The lion's share of the work was done by GPT-4 :)