/veloherodown

🚴 Create a local copy of your Velo Hero data

Primary LanguageShellGNU General Public License v3.0GPL-3.0

veloherodown

Create a local copy of your Velo Hero data.

Velo Hero Logo

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

Expert Tip

In addition to PWX and JSON, there are other export formats:

  • CSV
  • GPX
  • Google Earth KML
  • Garmin TCX

If you want to use the other export formats, you have to adjust the source code slightly. Everything is prepared. You only have to remove the comments (starting at line 150).