Skip to content

0.4.0 – more of the morning, fluid and food per activity, Mac guide

Choose a tag to compare

@futureweb futureweb released this 11 Oct 17:15
· 126 commits to main since this release

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.
  • GarminSleepSpO2Avg and GarminSleepRespirationAvg are 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, caloriesConsumed in kcal) goes into the activity fields
    GarminFluidIntake and GarminCaloriesConsumed, 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 --intake fills
    the past from the archive without asking Garmin.

Fixed

  • health no 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 via uvx, 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).