veloherodown

Create a local copy of your Velo Hero data.

This Bash script creates an export of your recorded activities at Velo Hero. The first time all the files are downloaded. For further calls only changes and new files are downloaded. The export is stored as a Training Peaks PWX and JSON file. The JSON file contains all the details except the comments of other users. The PWX file also has many details and can be processed by Golden Cheetah. The filename is the ID of the activity (https://app.velohero.com/workouts/show/<ID>).

Prerequisites

• Bash shell
• curl

Most Linux distributions and macOS meet the requirements.

Setup

1. Sign up at https://app.velohero.com/sso
2. Get yourself a private single sign-on key. That's the long string.
3. Create a .veloherorc file in your home directory. Save the SSO key and the storage location for the export in this file:

VELOHERO_SSO_KEY=[insert your own]
VELOHERO_EXPORT_DIR=[specify location for export]

Usage

Start export:

veloherodown [format]...

with format as one or a set of

• json: Velo Hero generic format
• pwx : Trainings Peaks PWX
• csv : Comma-Seperated Values
• gpx : GPX track
• kml : Google Earth KML
• tcx : Garmin TCX

The default format is JSON.

Example:

veloherodown json pwx