{"id":16164012,"url":"https://github.com/cyclenerd/veloherodown","last_synced_at":"2025-07-13T20:38:11.691Z","repository":{"id":20184581,"uuid":"89095436","full_name":"Cyclenerd/veloherodown","owner":"Cyclenerd","description":"🚴 Create a local copy of your Velo Hero data","archived":false,"fork":false,"pushed_at":"2025-06-16T06:22:08.000Z","size":324,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-16T07:29:37.147Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.velohero.com/","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cyclenerd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-04-22T19:54:54.000Z","updated_at":"2025-06-16T06:22:05.000Z","dependencies_parsed_at":"2025-03-31T18:32:12.127Z","dependency_job_id":"a0684089-51cd-471c-918a-821615ea011d","html_url":"https://github.com/Cyclenerd/veloherodown","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Cyclenerd/veloherodown","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyclenerd%2Fveloherodown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyclenerd%2Fveloherodown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyclenerd%2Fveloherodown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyclenerd%2Fveloherodown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cyclenerd","download_url":"https://codeload.github.com/Cyclenerd/veloherodown/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyclenerd%2Fveloherodown/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265201493,"owners_count":23726999,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","bash-script","bike","curl","cycling","download","downloader","export","gpx","running","triathlon"],"created_at":"2024-10-10T02:44:59.059Z","updated_at":"2025-07-13T20:38:11.682Z","avatar_url":"https://github.com/Cyclenerd.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# veloherodown\n\nCreate a local copy of your [Velo Hero](https://www.velohero.com/) data.\n\n![Velo Hero Logo](https://www.velohero.com/static/touchicon.png)\n\nThis command line application creates an export of your recorded activities to Velo Hero.\n\nThe first time all the files are downloaded.\nFor further calls only changes and new files are downloaded.\n\nThe export is stored in your chosen format(s): `JSON`, `PWX`, `CSV`, `GPX`, `KML`, or `TCX`.\n\nThe JSON file contains all the details except the comments of other users.\nThe PWX file also has many details and can be processed by [Golden Cheetah](http://www.goldencheetah.org/).\nThe filename is the ID of the activity (`https://app.velohero.com/workouts/show/\u003cID\u003e`).\n\n## Setup\n\n1. Create a directory for your Velo Hero export\n1. [Download](https://github.com/Cyclenerd/veloherodown/releases/latest) the veloherodown application for your operating system and CPU architecture. If you are unsure, usually `x86_64` will work.\n    * \u003cimg src=\"https://www.microsoft.com/favicon.ico\" width=16 height=16/\u003e **Windows**\n        * [x86_64](https://github.com/Cyclenerd/veloherodown/releases/latest/download/veloherodown-windows-x86_64.exe) Intel or AMD 64-Bit CPU\n        * [arm64](https://github.com/Cyclenerd/veloherodown/releases/latest/download/veloherodown-windows-arm64.exe) Arm-based 64-Bit CPU\n    * \u003cimg src=\"https://developer.apple.com/favicon.ico\" width=16 height=16/\u003e **macOS**\n        * [x86_64](https://github.com/Cyclenerd/veloherodown/releases/latest/download/veloherodown-macos-x86_64) Intel 64-bit CPU\n        * [arm64](https://github.com/Cyclenerd/veloherodown/releases/latest/download/veloherodown-macos-arm64) Apple silicon 64-bit CPU (M1, M2...)\n    * \u003cimg src=\"https://www.kernel.org/theme/images/logos/favicon.png\" width=16 height=16/\u003e **Linux**\n        * [x86_64](https://github.com/Cyclenerd/veloherodown/releases/latest/download/veloherodown-linux-x86_64) Intel or AMD 64-Bit CPU\n        * [arm64](https://github.com/Cyclenerd/veloherodown/releases/latest/download/veloherodown-linux-x86_64) Arm-based 64-Bit CPU (i.e. Raspberry Pi)\n1. Rename it to:\n    * `veloherodown` (macOS, Linux)\n    * `veloherodown.exe` (Windows)\n1. Go to \u003chttps://app.velohero.com/sso\u003e to get your private single sign-on key\n1. Run the application - it will prompt you to enter your SSO key\n    * Open a command line window (see below for instructions).\n    * Navigate to the folder where you saved `veloherodown`.\n    * Run the tool. It will ask you for your secret key. You can also create a file called `.veloherorc` in that folder and add the key there.\n    * Alternatively, create a `.veloherorc` file in the directory with:\n        ```ini\n        VELOHERO_SSO_KEY=[insert your SSO key]\n        ```\n\n## Usage\n\nThis project require you to use a command-line interface.\nDon't worry, it's easier than it looks!\nHere's how to open one:\n\n## Windows (PowerShell)\n\n1. Press the \u003ckbd\u003eWindows key\u003c/kbd\u003e + \u003ckbd\u003eX\u003c/kbd\u003e.\n1. Choose \"Windows PowerShell\".\n1. Type `cd` followed by the path to your folder (e.g., `cd C:\\Users\\YourName\\Documents\\VeloHero`) and press Enter.\n1. Type `veloherodown.exe` and press Enter.\n\nScreenshot:\n\n![Screenshot: Windows PowerShell](./img/veloherodown-windows.png)\n\nVideo:\n\nhttps://github.com/user-attachments/assets/dc3cf10a-be99-40c6-a7cd-3b927109f025\n\n## macOS (Terminal)\n\n1. Press \u003ckbd\u003eCommand\u003c/kbd\u003e + \u003ckbd\u003eSpace\u003c/kbd\u003e.\n1. Type \"Terminal\" and press Enter.\n1. Type `cd` followed by the path to your folder (e.g., `cd /Users/YourName/Documents/VeloHero`) and press Enter.\n1. Type `chmod +x veloherodown` and press Enter. (This makes the tool work).\n1. Type `./veloherodown` and press Enter.\n\nScreenshot:\n\n![Screenshot: macOS Terminal](./img/veloherodown-macos.png)\n\n## Export Format\n\nYou can choose what kind of files you want to save.\n\n**To use different formats:**\n\n* Windows:\n    ```powershell\n    veloherodown.exe [FORMAT]\n    ```\n* macOS and Linux:\n    ```bash\n    ./veloherodown [FORMAT]\n    ```\n\nReplace `[FORMAT]` with one or more of these:\n\n* `json`: Velo Hero generic JSON format (with all details)\n* `pwx` : Training Peaks PWX file with laps (can be processed by Golden Cheetah)\n* `csv` : Comma-Seperated Values CSV file\n* `gpx` : GPX file (only the geo coordinates)\n* `kml` : Google Earth KML file\n* `tcx` : Garmin TCX file\n\nThe default format is PWX.\n\nExample (This saves your data in both JSON and PWX formats):\n\n```bash\nveloherodown json pwx\n```\n\nAll files will be downloaded to the current directory where the `.veloherorc` file is located.\n\n## Features\n\n* Downloads only new or changed activities since the last run\n* Supports multiple export formats\n* Automatically skips already downloaded files\n* Respects server load with appropriate delays between requests\n* Simple configuration with a single SSO key\n\n## Notes\n\nThe application stores a tracking file `.velohero_last_export.do_not_remove` in the current directory to keep track of the last export timestamp. Do not delete this file if you want incremental updates.\n\n## License\n\nThis project is licensed under the [GNU General Public License v3](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyclenerd%2Fveloherodown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyclenerd%2Fveloherodown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyclenerd%2Fveloherodown/lists"}