Garmin Health Report

Generate professional daily health reports from Garmin Connect data with advanced running analysis.

Features:

• - Sleep Analysis: Duration, stages (deep/light/REM), scores, and 7-dimension quality ratings
• Heart Rate Monitoring: Resting HR with recovery status
• Activity Tracking: Steps, distance, floors, goal completion
• Professional Running Metrics:

• - 7-Day Trend Analysis: Activity patterns and consistency tracking
• Personalized Recommendations: Sleep tips, step goals, training insights

Regional Support: Works with both Garmin.com (international) and Garmin.cn (China region) accounts.

Quick Start

1. Install Dependencies

This skill requires Python 3.8 or higher and garth library:

CODEBLOCK0

2. Authenticate with Garmin Connect

First time setup requires authentication with Garmin Connect:

CODEBLOCK1

Follow prompts to enter your Garmin Connect username and password. Tokens will be securely stored in ~/.garmin-health-report/tokens.json.

For China Region Users (garmin.cn):

Create a config file before authenticating:

CODEBLOCK2

Then run python3 authenticate.py.

3. Generate Health Report

Generate a report for today or any specific date:

CODEBLOCK3

4. (Optional) Automate with Cron

To automatically generate daily health reports, add to your crontab:

CODEBLOCK4

Usage Examples

CODEBLOCK5

Understanding the Metrics

Heart Rate Zones

TRIMP (Training Impulse)

A measure of training load combining duration and intensity:

• - <100: Light load - recovery days
• 100-200: Moderate load - daily training
• 200-300: High load - needs recovery
• >300: Very high load - recommend rest

VDOT (VDot O₂max)

Estimate of running aerobic capacity (based on Jack Daniels' Running Formula). Higher VDOT = faster race pace potential.

VDOT is used to calculate optimal training paces:

• - E (Easy): Recovery and base building
• M (Marathon): Marathon race pace
• T (Threshold): Tempo/lactate threshold
• I (Interval): Speed intervals
• R (Repetition): Repetitions/sprints

Output Format

The report generates a beautifully formatted text output:

CODEBLOCK6

Configuration

Edit the configuration section at the top of health_daily_report.py:

CODEBLOCK7

Setting USER_RESTING_HR and USER_AGE improves accuracy of:

• - Heart rate zone calculations
• TRIMP (Training Impulse) estimation
• Recovery status assessment

If not set, defaults will be used (Age: 30, Resting HR: 60).

Troubleshooting

Error: garth not installed

CODEBLOCK8

Solution: Install garth:
CODEBLOCK9

Error: Not authenticated

CODEBLOCK10

Solution: Run python3 authenticate.py to authenticate with Garmin Connect.

China Region Issues

CODEBLOCK11

Privacy & Data

• - All data is retrieved from your personal Garmin Connect account
• Tokens are stored locally in INLINECODE7
• No data is sent to third-party servers beyond Garmin's API
• Health history is stored locally in INLINECODE8
• Token files have restricted permissions (600: owner read/write only)

Differences from Original (garmer-based Version)

This version uses garth directly instead of garmer:

✅ Simpler dependency - Only requires garth (a single library)
✅ Same features - All original functionality preserved:
- Sleep analysis
- Heart rate monitoring
- Steps tracking
- Activity analysis
- Professional running metrics (HR Zones, TRIMP, VDOT)
- 7-day trend analysis
- Personalized recommendations

Why the change?

• - Removes complex dependency chain (garmer → garth)
• Uses the underlying Garmin Connect library directly
• Easier to install (pip3 install garth vs dealing with garmer's issues)
• Better error handling and debugging

License

MIT License - See LICENSE file for details.

Credits

• - Uses garth library for Garmin Connect API access
• Jack Daniels VDOT formulas based on "Daniels' Running Formula"
• TRIMP calculation using Banister's equation