rsto / python-garminconnect

Python 3 API wrapper for Garmin Connect to get activity statistics

Python: Garmin Connect

$ ./example.py
*** Garmin Connect API Demo by cyberjunky ***

1 -- Get full name
2 -- Get unit system
3 -- Get activity data for '2024-07-06'
4 -- Get activity data for '2024-07-06' (compatible with garminconnect-ha)
5 -- Get body composition data for '2024-07-06' (compatible with garminconnect-ha)
6 -- Get body composition data for from '2024-06-29' to '2024-07-06' (to be compatible with garminconnect-ha)
7 -- Get stats and body composition data for '2024-07-06'
8 -- Get steps data for '2024-07-06'
9 -- Get heart rate data for '2024-07-06'
0 -- Get training readiness data for '2024-07-06'
- -- Get daily step data for '2024-06-29' to '2024-07-06'
/ -- Get body battery data for '2024-06-29' to '2024-07-06'
! -- Get floors data for '2024-06-29'
? -- Get blood pressure data for '2024-06-29' to '2024-07-06'
. -- Get training status data for '2024-07-06'
a -- Get resting heart rate data for 2024-07-06'
b -- Get hydration data for '2024-07-06'
c -- Get sleep data for '2024-07-06'
d -- Get stress data for '2024-07-06'
e -- Get respiration data for '2024-07-06'
f -- Get SpO2 data for '2024-07-06'
g -- Get max metric data (like vo2MaxValue and fitnessAge) for '2024-07-06'
h -- Get personal record for user
i -- Get earned badges for user
j -- Get adhoc challenges data from start '0' and limit '100'
k -- Get available badge challenges data from '1' and limit '100'
l -- Get badge challenges data from '1' and limit '100'
m -- Get non completed badge challenges data from '1' and limit '100'
n -- Get activities data from start '0' and limit '100'
o -- Get last activity
p -- Download activities data by date from '2024-06-29' to '2024-07-06'
r -- Get all kinds of activities data from '0'
s -- Upload activity data from file 'MY_ACTIVITY.fit'
t -- Get all kinds of Garmin device info
u -- Get active goals
v -- Get future goals
w -- Get past goals
y -- Get all Garmin device alarms
x -- Get Heart Rate Variability data (HRV) for '2024-07-06'
z -- Get progress summary from '2024-06-29' to '2024-07-06' for all metrics
A -- Get gear, the defaults, activity types and statistics
B -- Get weight-ins from '2024-06-29' to '2024-07-06'
C -- Get daily weigh-ins for '2024-07-06'
D -- Delete all weigh-ins for '2024-07-06'
E -- Add a weigh-in of 89.6kg on '2024-07-06'
F -- Get virtual challenges/expeditions from '2024-06-29' to '2024-07-06'
G -- Get hill score data from '2024-06-29' to '2024-07-06'
H -- Get endurance score data from '2024-06-29' to '2024-07-06'
I -- Get activities for date '2024-07-06'
J -- Get race predictions
K -- Get all day stress data for '2024-07-06'
L -- Add body composition for '2024-07-06'
M -- Set blood pressure '120,80,80,notes='Testing with example.py'
N -- Get user profile/settings
O -- Reload epoch data for 2024-07-06
P -- Get workouts 0-100, get and download last one to .FIT file
R -- Get solar data from your devices
S -- Get pregnancy summary data
T -- Add hydration data
U -- Get Fitness Age data for 2024-07-06
Z -- Remove stored login tokens (logout)
q -- Exit
Make your selection:

Python 3 API wrapper for Garmin Connect.

About

This package allows you to request garmin device, activity and health data from your Garmin Connect account. See https://connect.garmin.com/

Installation

pip3 install garminconnect

Authentication

The library uses the same authentication method as the app using Garth. The login credentials generated with Garth are valid for a year to avoid needing to login each time.
NOTE: We obtain the OAuth tokens using the consumer key and secret as the Connect app does. garth.sso.OAUTH_CONSUMER can be set manually prior to calling api.login() if someone wants to use a custom consumer key and secret.

Testing

The test files use the credential tokens created by example.py script, so use that first.

export GARMINTOKENS=~/.garminconnect
sudo apt install python3-pytest (needed some distros)

make install-test
make test

Development

To create a development environment to commit code.

make .venv
source .venv/bin/activate

pip3 install pdm
pip3 install ruff
pdm init

sudo apt install pre-commit isort black mypy
pip3 install pre-commit

Run checks before PR/Commit:

make format
make lint
make codespell

Publish

To publish new package (author only)

sudo apt install twine
vi ~/.pypirc
[pypi]
username = __token__
password = <PyPI token>

make publish

Example

The tests provide examples of how to use the library.
There is a Jupyter notebook called reference.ipynb provided here.
And you can check out the example.py code you can find here, you can run it like so:

pip3 install -r requirements-dev.txt
./example.py

Credits

❤️ Special thanks to all people contributed, either by asking questions, reporting bugs, coming up with great ideas, or even by creating whole Pull Requests to add new features! This project deserves more attention, but I'm struggling to free up time sometimes, so thank you for your patience too!

Donations