Repository navigation
0.4.0 – more of the morning, fluid and food per activity, Mac guide
More of the morning, what you drank and ate per activity, quicker recovery
when Garmin isn't ready right after a sync, and a guide for the Mac.
Upgrading needs no change to the configuration; the new activity fields are
created by the bridge. To fill fluid and food for past activities from the
local archive (no Garmin requests): backfill --scope activities --from 2026-01-01 --intake --apply.
Changed
- More of the morning. Recovery time, acute load, endurance and hill
scores, cycling VO₂max, fitness age and race predictions now arrive with the
morning read, as Garmin reports them at wake-up, instead of the day after;
the day's final read replaces them with the evening's values. Five more
endpoints in the morning read: about 80 Garmin requests a day instead of 75. GarminSleepSpO2AvgandGarminSleepRespirationAvgare written in the
default profile again (an AI coach reading Garmin's names finds them).- A failed activity is retried after 10 minutes the first time, then after
an hour, 6 hours, a day and a week (it was an hour first). Right after the
watch syncs, Garmin sometimes answers with a server error for an activity
it serves fine minutes later. - Warnings show the HTTP status next to the error type, e.g.
failed with GarminConnectConnectionError (HTTP 503).
Added
- Fluid and food per activity: what you log in Garmin (
waterConsumed
in ml,caloriesConsumedin kcal) goes into the activity fields
GarminFluidIntakeandGarminCaloriesConsumed, created by the bridge.
The summary is read once more half a day after the activity (one request
per activity);backfill --scope activities --from DATE --intakefills
the past from the archive without asking Garmin.
Fixed
healthno longer alerts "weight, bodyFat stopped arriving" after two days
without stepping on the scale. The dropout check now looks only at finished
days (the morning's file for today has no weigh-in yet) and only at what the
device measures by itself, not at what you log or start (weight, food,
drink, Health Snapshots).
Documentation
- A step-by-step guide for the Mac (
docs/MAC.md), like the Windows one:
Python from python.org, the bridge in its own folder, and a LaunchAgent
that keeps it running in the background after login. - README: "Use it with an AI coach (MCP)" with the sister project's install
channels (PyPI viauvx, Docker Hub, Claude Desktop bundle, MCP Registry). - A project icon in the style of the sister project's: the Futureweb Intervals
MCP's bars and endpoints, here as a bridge deck between two endpoints carried
by the bars as piers (docs/assets/icon-bridge*, shown above the README).
Install: pip install -U garmin-intervals-bridge, or the image ghcr.io/futureweb/garmin-intervals-bridge:0.4.0 / futurewebat/garmin-intervals-bridge:0.4.0 (Docker Hub).