0.6.0 - Women's Health & FIT files (Garmin)

[KaliszS]

Highlights

Women's Health

We now support menstrual cycle tracking for Garmin wearables. The new women's health tab is only available if the user has fetched any related data. Otherwise, it is invisible.

Ingest workout samples (high data granularity)

We have added an option to enable second-by-second granularity for certain data from Garmin, such as heart rate, speed, cadence, power, latitude, longitude, elevation and running dynamics (which require a FIT file), as well as air temperature (also requires FIT file to be available).

Caution

This option is disabled by default. To enable it, you must set the INGEST_WORKOUT_SAMPLES environment variable to true.

Warning

According to our tests, this will increase database memory usage by approximately 170 MB per user per month.

FIT file parser and saving to S3

A parser for FIT files has been implemented. Currently, there is no option to upload these files manually; they are processed automatically via Garmin webhooks. However, the same parser will eventually support other providers.

Garmin currently extracts the following data from FIT files and saves it to the database:

• training segments (laps, swim lengths, etc.)
• time spent in each heart rate zone during a workout
• time spent in each power zone during a workout
• air temperature (INGEST_WORKOUT_SAMPLES required)
• running vertical oscillation (INGEST_WORKOUT_SAMPLES required)
• running vertical ratio (INGEST_WORKOUT_SAMPLES required)
• running stride length (INGEST_WORKOUT_SAMPLES required)
• running ground contact time (INGEST_WORKOUT_SAMPLES required)
• running stance time balance (INGEST_WORKOUT_SAMPLES required)

Note

We have added a new environment variable called STORE_FIT_FILES, which is set to false by default. When this is set to true, raw FIT files from Garmin will be saved to a previously configured S3 bucket. See the S3 configuration guide for more information: https://openwearables.io/docs/dev-guides/raw-payload-storage

Many Oura bugs fixed

We have fixed several bugs relating to the Oura integration. We have added time zone offset saving to the database, supported sleep summary metrics, improved data retrieval for current day summaries and migrated HRV from SDNN to RMSSD. Existing SDNN values in the database will be migrated by an automatic script that runs when the application starts.

Added redis TLS support

To enable TLS support (rediss://), set the new environment variable REDIS_SSL to true.

The day prefix for sleep start times that began before midnight

From now on, the start time of a sleep session in the sleep section will be prefixed with the previous day’s name if it was before midnight. If a sleep session ends after midnight, it will be displayed under the following day in the admin UI (as it always has been). Please note that this is dynamic and will adjust to the user’s time zone.

Support for synchronising the same data across multiple accounts

We have added dedicated support for users who need to synchronise their devices with several Open Wearables accounts for testing purposes. No configuration is required to use this feature. Simply pair the relevant accounts with your wearables account and synchronise any of them. A badge will appear in each account to indicate which accounts are linked, along with the relevant sync statuses. This shows that, for a given account, the source of the currently syncing data is a linked Open Wearables account. This means that, instead of repeatedly syncing the same data - which is virtually impossible with Garmin during backfilling, for example - it will be synced once and copied to the other accounts.

What's Changed

Garmin FIT files & high granularity data support

• feat(backend): add migration with new jsonb fields for workout_details by @KaliszS in feat(backend): add migration with new jsonb fields for workout_details #1079
• feat(backend): add average_cadence support for Garmin by @KaliszS in feat(backend): add average_cadence support for Garmin #1080
• feat(backend): Garmin workout samples by @KaliszS in feat(backend): Garmin workout samples #1082
• feat(backend): FIT files parser by @KaliszS in feat(backend): FIT files parser #1096
• fix(backend): fit map stride_length -> step_length by @KaliszS in fix(backend): fit map stride_length -> step_length #1097
• feat(backend): Garmin mappings for elevation, GPS & running dynamics + optional saving FIT files to s3 by @KaliszS in feat(backend): Garmin mappings for elevation, GPS & running dynamics + optional saving FIT files to s3 #1099
• fix(backend): stop storing Garmin average HR as heart_rate_min by @knowald in fix(backend): stop storing Garmin average HR as heart_rate_min #1121
• feat(backend): Garmin support for workout segments (laps, swim lengths etc) by @KaliszS in feat(backend): Garmin support for workout segments (laps, swim lengths etc) #1118
• fix(backend): null workout heart_rate_min rows copied from average HR by @knowald in fix(backend): null workout heart_rate_min rows copied from average HR #1133
• feat(backend): HR & Power Zones [Garmin] by @KaliszS in feat(backend): HR & Power Zones [Garmin] #1175

Garmin Women's Health

• feat: Garmin menstrual cycle tracking by @czajkub in feat: Garmin menstrual cycle tracking #1063

Oura bugs

• fix: Oura missed commit and sleep summary metrics by @czajkub in fix: Oura missed commit and sleep summary metrics #1086
• feat(backend): Oura zone_offset extraction by @KaliszS in feat(backend): Oura zone_offset extraction #1168
• fix(backend): polling logic for Oura drops the current day for daily metrics by @bartmichalak in fix(backend): polling logic for Oura drops the current day for daily metrics #1162
• fix(backend): store Oura HRV as RMSSD instead of SDNN by @bartmichalak and @KaliszS in fix(backend): store Oura HRV as RMSSD instead of SDNN #1100

Apple Health bugs

• fix(backend): widen data_source.source to VARCHAR(100) by @chrisedington in fix(backend): widen data_source.source to VARCHAR(100) #1103

Suunto bugs

• feat(integrations): emit resting_heart_rate series from sleep HRMin by @HugoHeneault in feat(integrations): emit resting_heart_rate series from sleep HRMin #1055

Polar bugs

• feat(backend): map INDOOR_CYCLING, JUMP_ROPE, KICKBOXING_MARTIAL_ARTS by @kozikow in feat(backend): map INDOOR_CYCLING, JUMP_ROPE, KICKBOXING_MARTIAL_ARTS #1110

Infrastructure improvements

• fix: mount redis volume at /data so persistence works by @knowald in fix: mount redis volume at /data so persistence works #1127
• feat(backend): support TLS (rediss://) for Redis connections by @kczpl in feat(backend): support TLS (rediss://) for Redis connections #1134

Other improvements

• fix(frontend): stop activity & sleep dates shifting a day for users west of UTC by @bartmichalak and @KaliszS in fix(frontend): stop activity & sleep dates shifting a day for users west of UTC #1160
• refactor: fixed scopes db saving & improved UI by @KaliszS in refactor: fixed scopes db saving & improved UI #1088
• feat: Add webhook management endpoints by @czajkub in feat: Add webhook management endpoints #1049
• fix: update last_synced_at on webhook receive by @czajkub in fix: update last_synced_at on webhook receive #1145
• feat: sharable syncs (the same data) between different OW users by @KaliszS in feat: sharable syncs (the same data) between different OW users #1147
• feat(frontend): OpenWearables version visible under logout button by @KaliszS in feat(frontend): OpenWearables version visible under logout button #1165

Docs & chores

• fix(docs): update GitHub repository links in iOS SDK documentation by @bartmichalak in fix(docs): update GitHub repository links in iOS SDK documentation #1064
• docs: update available providers in readme by @bartmichalak in docs: update available providers in readme #1069
• chore: bump the npm-minor-patch group across 1 directory with 4 updates by @dependabot[bot] in chore: bump the npm-minor-patch group across 1 directory with 4 updates #1057
• chore: update sentry-sdk[fastapi] requirement from >=2.59.0 to >=2.60.0 in /backend by @dependabot[bot] in chore: update sentry-sdk[fastapi] requirement from >=2.59.0 to >=2.60.0 in /backend #1061
• refactor(backend): update deps (redis v8) by @KaliszS in refactor(backend): update deps (redis v8) #1087
• chore: bump the npm-minor-patch group in /frontend with 13 updates by @dependabot[bot] in chore: bump the npm-minor-patch group in /frontend with 13 updates #1102
• docs(mcp): remove formatted duration fields absent from sleep tool output by @knowald in docs(mcp): remove formatted duration fields absent from sleep tool output #1122
• docs: clarify migrations auto-run on deploy temporarily by @bartmichalak in docs: clarify migrations auto-run on deploy temporarily #1129
• docs: note developer program is on hold by @bartmichalak in docs: note developer program is on hold #1130
• docs: drop "| Open Wearables" suffix from page titles by @bartmichalak in docs: drop "| Open Wearables" suffix from page titles #1131
• docs: add Fitbit and Google Health Connect to the coverage matrix by @knowald in docs: add Fitbit and Google Health Connect to the coverage matrix #1137
• refactor(backend): update python dependencies by @KaliszS in refactor(backend): update python dependencies #1163
• refactor(frontend): update react dependencies by @KaliszS in refactor(frontend): update react dependencies #1164

New Contributors

• @chrisedington made their first contribution in fix(backend): widen data_source.source to VARCHAR(100) #1103
• @kozikow made their first contribution in feat(backend): map INDOOR_CYCLING, JUMP_ROPE, KICKBOXING_MARTIAL_ARTS #1110
• @kczpl made their first contribution in feat(backend): support TLS (rediss://) for Redis connections #1134

Full Changelog: 0.5.2...0.6.0

---

This discussion was created from the release 0.6.0 - Women's Health & FIT files (Garmin).