{"id":30211148,"url":"https://github.com/macardghail/strava-runs-to-csv","last_synced_at":"2026-04-15T15:34:30.501Z","repository":{"id":298540899,"uuid":"850693031","full_name":"MacArdghail/strava-runs-to-csv","owner":"MacArdghail","description":"A Node.js app that allows you to easily fetch all of your running activities from Strava and export them into a neatly formatted CSV file.","archived":false,"fork":false,"pushed_at":"2024-09-01T16:08:06.000Z","size":146,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-13T20:55:37.450Z","etag":null,"topics":["express-js","node-js","strava-api","strava-data","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MacArdghail.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-09-01T14:12:49.000Z","updated_at":"2024-09-03T10:47:06.000Z","dependencies_parsed_at":"2025-06-11T17:47:41.354Z","dependency_job_id":"b0e58787-d455-49a2-8246-b557353f80b4","html_url":"https://github.com/MacArdghail/strava-runs-to-csv","commit_stats":null,"previous_names":["macardghail/strava-runs-to-csv"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MacArdghail/strava-runs-to-csv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MacArdghail%2Fstrava-runs-to-csv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MacArdghail%2Fstrava-runs-to-csv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MacArdghail%2Fstrava-runs-to-csv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MacArdghail%2Fstrava-runs-to-csv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MacArdghail","download_url":"https://codeload.github.com/MacArdghail/strava-runs-to-csv/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MacArdghail%2Fstrava-runs-to-csv/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31847991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["express-js","node-js","strava-api","strava-data","typescript"],"created_at":"2025-08-13T20:32:38.565Z","updated_at":"2026-04-15T15:34:30.483Z","avatar_url":"https://github.com/MacArdghail.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About\n\n![Screenshot of CSV file produced](strava-runs-to-csv-screenshot.png)\n\n**strava-runs-to-csv** is a Node.js application that allows you to easily fetch all of your running activities from Strava and export them into a neatly formatted CSV file. The generated CSV includes useful headers such as run number, activity name, distance, pace, time, kudos count, date of run, and a link to view each run on Strava.\n\nThis tool provides a simple and organized way to view all your runs and stats in one place, without the need to endlessly scroll through Strava. It's a great way to visualize your progress, analyze your running data, and keep track of your achievements.\n\n\n\n# Built With\n\n* [![Node.js][Node.js]][Node-url]\n* [![Express.js][Express.js]][Express-url]\n* [![TypeScript][TypeScript]][TypeScript-url]\n\n  \u003c!-- GETTING STARTED --\u003e\n# Getting Started\n## Prerequisites\n\nBefore you begin, ensure you have the following:\n\n1. **Strava API Account**: To access your running data, you need to create a Strava account and register an API application.\n\n   - Visit the [Strava Developer Portal](https://www.strava.com/settings/api).\n   - Log in with your existing Strava account, or create a new one if needed.\n   - Click on **Create \u0026 Manage Your App** to register a new application.\n   - Complete the required fields such as **Application Name**, **Website**, and **Authorization Callback Domain** (make sure to set this to `localhost:3000`).\n   - Once your application is created, you will be provided with a **Client ID** and **Client Secret**.\n\n2. **Node.js and npm**: Make sure you have [Node.js](https://nodejs.org/) installed on your system, which includes `npm` (Node Package Manager). This project requires Node.js to run the server and `npm` to install dependencies.\n\n## Installation\n\n1. Clone the repo\n   ```sh\n   git clone https://github.com/FionnMcA/strava-runs-to-csv.git\n   ```\n2. Install NPM packages\n   ```sh\n   npm install\n   ```\n3. Enter your Strava API Application credentials in `.env`\n   ```ts\n   STRAVA_CLIENT_ID=YOUR_CLIENT_ID\n   STRAVA_CLIENT_SECRET=YOUR_CLIENT_SECRET\n   STRAVA_REDIRECT_URI=http://localhost:3000\n   ```\n# Usage\n\nOnce you have set up the `strava-runs-to-csv` application and installed all dependencies, you can start using it to fetch your running data from Strava and export it to a CSV file.\n\n## Running the Application\n\n1. **Compile TypeScript Code**  \n   Before running the application, make sure to compile the TypeScript code to JavaScript. Open your terminal, navigate to the project directory, run the following command:\n   ```sh\n   npx tsc\n   ```\n2. **Start the Application**  \n   Then run the following command to start the application:\n   ```sh\n   node dist/runs-to-csv.js`\n   ```\n3. **Authorize with Strava**  \n   Open your web browser and navigate to the following URL to authorize the application with your Strava account:\n   ```sh\n   http://localhost:3000/auth\n   ```\n   You will be redirected to Strava's authorization page. Log in and authorize the application to access your running data.\n\n   After granting authorization, you will be redirected to a confirmation page at `/authorization`. This page will prompt you to close the tab, and the application will begin fetching     your running data and generating the CSV file.\n\n4. **Generate the CSV File**  \n   After authorizing the application, it will automatically fetch your running data and generate a CSV file named `strava_runs.csv` in the project directory. The CSV file will include the following details:\n   \n   - **Run Number**: Sequential number of the run\n   - **Activity Name**: Name of the run activity\n   - **Distance (KM)**: Distance covered in kilometers\n   - **Pace**: Average pace of the run\n   - **Time**: Duration of the run\n   - **Kudos Count**: Number of kudos received\n   - **Date**: Date of the run\n   - **Link to View the Run**: URL to view the run on Strava\n\n   You can open this CSV file with any spreadsheet software or text editor to view and analyze your running data.\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n[Node.js]: https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=nodedotjs\u0026logoColor=white\n[Node-url]: https://nodejs.org/\n[Express.js]: https://img.shields.io/badge/Express.js-000000?style=for-the-badge\u0026logo=express\u0026logoColor=white\n[Express-url]: https://expressjs.com/\n[TypeScript]: https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge\u0026logo=typescript\u0026logoColor=white\n[TypeScript-url]: https://www.typescriptlang.org/\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacardghail%2Fstrava-runs-to-csv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacardghail%2Fstrava-runs-to-csv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacardghail%2Fstrava-runs-to-csv/lists"}