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.3.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.3-py3-none-any.whl (20.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for garsync-0.1.3.tar.gz
Algorithm Hash digest
SHA256 429ba688787872d9cffe2554cd351dcb251911139bed57cdb880237803531102
MD5 fb373d353bf43949d0fb41e009579e67
BLAKE2b-256 b0a2089f918f87a7ab23b26bb2b431967602b30e972b53df13a818b2446c1264

See more details on using hashes here.

Provenance

The following attestation bundles were made for garsync-0.1.3.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.3-py3-none-any.whl.

File metadata

  • Download URL: garsync-0.1.3-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.12

File hashes

Hashes for garsync-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 f90b64bc4f991485a659ee916afe854d20bc0ea54688e0c1aaeb9eeeb23ff3ce
MD5 b6558830cea437220c30e3d9a1411899
BLAKE2b-256 6310aacfae65f2899ecc676fad1ef4098b29ddf30030fadb4ff28643aee29a0c

See more details on using hashes here.

Provenance

The following attestation bundles were made for garsync-0.1.3-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