Skip to main content

No project description provided

Project description

GarSync

CI Docs Python License

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

Feature Garmin Connect App GarSync
Data Ownership Proprietary Cloud Local SQLite (Full Control)
Customization Fixed Dashboards Extensible Astro + Chart.js
Access Web/Mobile Only REST API + SQL + CLI
Automation Manual Export Scheduled Incremental Sync

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:

sops 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

garsync-0.1.2.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

garsync-0.1.2-py3-none-any.whl (20.6 kB view details)

Uploaded Python 3

File details

Details for the file garsync-0.1.2.tar.gz.

File metadata

  • Download URL: garsync-0.1.2.tar.gz
  • Upload date:
  • Size: 14.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for garsync-0.1.2.tar.gz
Algorithm Hash digest
SHA256 25feced083f4ded440f6dfe27425b29991cf7b4db45eb49f1de3b29c6fc4e9d2
MD5 9e7b09e64c3248bc37b1a5f47632b3a8
BLAKE2b-256 480f30f501cb6ca0a750a23944ec790dd6b92a5ef7bb4d139d690212b4bd48b8

See more details on using hashes here.

Provenance

The following attestation bundles were made for garsync-0.1.2.tar.gz:

Publisher: release.yml on mlorentedev/garsync

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file garsync-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: garsync-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 20.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for garsync-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bd30ee5fb29c3764f87c468ebe7e94cf970ad2d737c53d17713699605b204490
MD5 6955d6cd86aba4b5b093035d655404b8
BLAKE2b-256 a8f94ea0530d79ce1c961485424d77c1e99082b19e6a4786227b7474876f4424

See more details on using hashes here.

Provenance

The following attestation bundles were made for garsync-0.1.2-py3-none-any.whl:

Publisher: release.yml on mlorentedev/garsync

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page