GarSync

Personal fitness data pipeline that syncs Garmin Connect data to a local SQLite database and visualizes it through a modern Astro dashboard.

Explore the full documentation at: mlorentedev.github.io/garsync

The Problem

Garmin Connect provides great data, but it's locked in a proprietary cloud.

• Data Silos: Hard to export full history for custom analysis.
• Limited Visualization: You are stuck with the official app's charts.
• No Local Ownership: If you lose access or the service is down, your training history is gone.

Value Proposition

Quick Start

1. Prerequisites

• Python 3.12+ and Poetry
• Node.js 22+ (for the dashboard)
• SOPS + Age (for secrets)

2. Setup

make setup

3. Configure Secrets

Edit your Garmin credentials using SOPS. The file is encrypted to garsync's dedicated age identity (see docs/runbooks/onboard-new-machine.md), and sops must be told the format, because it cannot infer it from .enc:

SOPS_AGE_KEY_FILE=~/.config/age/garsync.txt \
  sops --input-type dotenv --output-type dotenv secrets.env.enc

4. Sync & Launch

make sync DAYS=30
make dev

Visit http://localhost:4321 (Dev UI).

Architecture

Garmin Connect Cloud → GarSync CLI → SQLite DB → FastAPI → Astro Dashboard

License

MIT — see LICENSE.

Documentation

Project-bound knowledge lives in docs/ (docs-as-code): ADRs, runbooks, troubleshooting, and lessons.