Skip to content

Bulk export your Coros activities to FIT to import them in a 3rd party

License

Notifications You must be signed in to change notification settings

xballoy/coros-api

Repository files navigation

Bulk export Coros activities

⚠️ This repository is using a non-public API from COROS Training Hub that could break anytime.

Bulk export your Coros activities to FIT to import them in a 3rd party

Getting started

  • Install Node.js (see .nvmrc for the supported version)
  • Run npm install
  • Create a .env file (see .env.example) with your email, password and the Coros API URL
  • Run npx nest start -- export-activities -out OUT_DIR.

Options:

  -o, --out [outDir]              Output directory
  --exportType <fileType>         Export data type (choices: "fit", "tcx", "gpx", "kml", "csv", default: "fit")
  --exportSportTypes <sportType>  Export sport types, comma separated (choices: "all", "run", "indoorRun", "trailRun", "trackRun", "hike", "mtnClimb", "bike", "indoorBike", "roadEbike", "gravelRoadBike", "mountainRiding", "mountainEbike", "helmetBike", "poolSwim", "openWater", "triathlon", "strength", "gymCardio", "gpsCardio", "ski", "snowboard", "xcSki", "skiTouring", "skiTouringOld", "multiSport", "speedsurfing", "windsurfing", "row", "indoorRow", "whitewater", "flatwater", "multiPitch", "climb", "indoorClimb", "bouldering", "walk", "jumpRope", "climbStairs", "customSport", default: "all")
  --fromDate <from>               Export activities created after this date (inclusive). Format must be YYYY-MM-DD
  --toDate <to>                   Export activities created before this date (inclusive). Format must be YYYY-MM-DD
  -h, --help                      display help for command

Examples:

# Download all activities in fit format in Downloads folder
npx nest start -- export-activities -o ~/Downloads

# Download all activities between 2025-01-01 and 2025-02-01 in fit format in Downloads folder
npx nest start -- export-activities --fromDate 2025-01-01 --toDate 2025-02-01 -o ~/Downloads

# Download all activities in gpx format in Downloads folder
npx nest start -- export-activities --exportType gpx -o ~/Downloads

# Download all walk and run in gpx format in Downloads folder
npx nest start -- export-activities --exportType gpx --exportSportTypes walk,run -o ~/Downloads

API Documentation

The API used by this project are documented using Bruno in the api folder.

Licence

MIT License

About

Bulk export your Coros activities to FIT to import them in a 3rd party

Topics

Resources

License

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •