hronicle

Chronicle automatically builds rich Strava activity descriptions by combining data from Strava and your connected stat sources.

Key Features

• Auto-processes new activities on a worker heartbeat.
• Writes description templates back to Strava based on activity profile.
• Includes a polished local web app:
  • View (/dashboard) for long-term trends.
  • Plan (/plan) for planning your next move.
  • Build (/editor) for template editing and preview.
  • Sources (/setup) for source credentials and OAuth.
  • Control (/control) for one-click API operations.
• Supports profile-based templates (for different activity types).
• Exposes local API endpoints for automation and reruns.

Screenshots

Quick Start (macOS)

Step 0: Install Docker Desktop for Mac

1. Watch this quick setup video: https://www.youtube.com/watch?v=agkOZr27d3Y
2. Install Docker Desktop and launch it.

Step 1: Open Terminal

• Open Terminal.app.

Step 2: Create a folder and clone Chronicle Project

mkdir -p ~/docker/chronicle
cd ~/docker/chronicle
git clone https://github.com/seanap/Chronicle.git
cd Chronicle
cp .env.example .env

Step 3: Start Chronicle

docker compose up -d

Step 4: Open the app

http://localhost:1609

• Dashboard (View): http://localhost:1609/dashboard
• Plan (Plan): http://localhost:1609/plan
• Template Editor (Build): http://localhost:1609/editor
• Source Setup (Sources): http://localhost:1609/setup
• API Control (Control): http://localhost:1609/control

Step 5: Add your credentials in Sources

• Go to Sources and fill in your source keys/tokens.
• Source setup guide: docs/SOURCES_SETUP.md

Documentation

• API docs: docs/API_DOCUMENTATION.md
• Android widget companion: docs/ANDROID_WIDGET_COMPANION.md
• Android widget APK downloads: GitHub Releases
• Misery Index report: docs/MISERY_INDEX_REPORT.md