41 lines
929 B
Markdown
41 lines
929 B
Markdown
# Garmin Data Fetcher
|
|
|
|
A Python script to download per-second activity data (heart rate, GPS, cadence, etc.) from Garmin Connect and extract it from FIT files for analysis.
|
|
|
|
## Setup
|
|
|
|
1. Create virtual environment:
|
|
```bash
|
|
python -m venv venv
|
|
source venv/bin/activate
|
|
```
|
|
|
|
2. Install dependencies:
|
|
```bash
|
|
pip install garminconnect garmin_fit_sdk
|
|
```
|
|
|
|
3. Set environment variables:
|
|
```bash
|
|
export GARMIN_EMAIL=your_email@example.com
|
|
export GARMIN_PASSWORD=your_password
|
|
```
|
|
|
|
## Usage
|
|
|
|
Run the script to download and extract data:
|
|
```bash
|
|
python scripts/fetch_garmin_data.py
|
|
```
|
|
|
|
The script will:
|
|
- Authenticate with Garmin Connect
|
|
- Download the most recent activity's FIT file
|
|
- Extract per-second record data (heart rate, GPS, cadence, etc.)
|
|
- Save the data as JSON for analysis
|
|
|
|
## Output
|
|
|
|
Data is saved in `garmin_data/` as:
|
|
- `{activity_id}.fit` - Original FIT file
|
|
- `{activity_id}_data.json` - Extracted per-second records |