Skip to content

README.md

Latest commit

 

History

History
142 lines (95 loc) · 3.27 KB

README.md

File metadata and controls

142 lines (95 loc) · 3.27 KB
Raw

🚴 Strava Activity Exporter

A web application to export your Strava activities to GPX, TCX, or FIT formats. Export multiple activities at once, making it easy to import them into platforms that don't support direct Strava sync.

Home

App

App2

📱 Features

  • 🔐 Strava OAuth: Secure authentication with your Strava account.
  • 📋 Activity Browser: View all your activities with search, filters, and sorting.
  • 📥 Multiple Formats: Export to FIT (original), GPX, or TCX.
  • 📦 Batch Export: Download multiple activities at once as a ZIP file.
  • 🎯 Smart Filters: Filter by sport type, date range, or activity name.
  • 🏷️ Custom Filename Template: Define your own naming pattern using variables like {date}, {name}, {type}, and {id}, with selectable date formats.

⚙️ Tech Stack

  • Backend: Node.js 18+, Express
  • Frontend: Vanilla HTML, CSS, JavaScript
  • APIs: Strava API v3
  • Libraries: JSZip (client-side ZIP generation)

🚀 Getting Started

1. Clone the repository

git clone https://github.com/luisandrelemos/strava-activity-exporter.git
cd strava-activity-exporter

2. Create Strava API Application

  1. Go to Strava API Settings
  2. Create a new application:
    • Application Name: Any name
    • Website: http://localhost:3000
    • Authorization Callback Domain: localhost
  3. Copy your Client ID and Client Secret

3. Configure Environment

cp .env.example .env

Edit .env with your credentials:

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret

4. Install and Run

Requires Node.js 18 or higher (uses the native fetch API)

npm install
npm start

Open http://localhost:3000 in your browser.

📂 Project Structure

/public
  /css            → stylesheets
  /js             → frontend JavaScript modules
  /img            → images and icons
server.js         → Express server with OAuth handling

📄 Export Formats

Format Description
FIT Original file from your device
GPX GPS track with coordinates and elevation
TCX Training data with heart rate, cadence, and power

🏷️ Custom Filename Template

Click the ⚙️ button next to Download to configure how exported files are named.

Available variables:

Variable Description Example
{date} Activity date 2026-02-23
{name} Activity name Morning_Run
{type} Sport type Run
{id} Strava activity ID 12345678

Date formats: YYYY-MM-DD, YYYYMMDD, DD-MM-YYYY, MM-DD-YYYY

Default template: {date}_{name} → 2026-02-23_Morning_Run.gpx

Note: Custom filenames apply to GPX and TCX exports only. FIT (original) files are downloaded directly from Strava and cannot be renamed.

⚠️ Rate Limits

Strava API limits:

  • 100 requests / 15 minutes
  • 1000 requests / day

The app handles rate limiting automatically.

📄 License

MIT

Made with ❤️ by Luís Lemos