Package: garminconnect
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-01-21'
4 -- Get activity data for '2024-01-21' (compatible with garminconnect-ha)
5 -- Get body composition data for '2024-01-21' (compatible with garminconnect-ha)
6 -- Get body composition data for from '2024-01-14' to '2024-01-21' (to be compatible with garminconnect-ha)
7 -- Get stats and body composition data for '2024-01-21'
8 -- Get steps data for '2024-01-21'
9 -- Get heart rate data for '2024-01-21'
0 -- Get training readiness data for '2024-01-21'
- -- Get daily step data for '2024-01-14' to '2024-01-21'
/ -- Get body battery data for '2024-01-14' to '2024-01-21'
! -- Get floors data for '2024-01-14'
? -- Get blood pressure data for '2024-01-14' to '2024-01-21'
. -- Get training status data for '2024-01-21'
a -- Get resting heart rate data for 2024-01-21'
b -- Get hydration data for '2024-01-21'
c -- Get sleep data for '2024-01-21'
d -- Get stress data for '2024-01-21'
e -- Get respiration data for '2024-01-21'
f -- Get SpO2 data for '2024-01-21'
g -- Get max metric data (like vo2MaxValue and fitnessAge) for '2024-01-21'
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-01-14' to '2024-01-21'
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-01-21'
z -- Get progress summary from '2024-01-14' to '2024-01-21' for all metrics
A -- Get gear, the defaults, activity types and statistics
B -- Get weight-ins from '2024-01-14' to '2024-01-21'
C -- Get daily weigh-ins for '2024-01-21'
D -- Delete all weigh-ins for '2024-01-21'
E -- Add a weigh-in of 89.6kg on '2024-01-21'
F -- Get virtual challenges/expeditions from '2024-01-14' to '2024-01-21'
G -- Get hill score data from '2024-01-14' to '2024-01-21'
H -- Get endurance score data from '2024-01-14' to '2024-01-21'
I -- Get activities for date '2024-01-21'
J -- Get race predictions
K -- Get all day stress data for '2024-01-21'
L -- Add body composition for '2024-01-21'
M -- Set blood pressure '120,80,80,notes='Testing with example.py'
N -- Get user profile/settings
O -- Reload epoch data for 2024-01-21
P -- Get workouts and get and download last one to .fit file
Z -- Remove stored login tokens (logout)
q -- Exit
Make your selection:Python 3 API wrapper for Garmin Connect.NOTE: For developers using this packageFromversion 0.2.1 onwards, this package usesgarthto authenticate and perform API calls.This requires minor changes to your login code, look at the code inexample.pyor thereference.ipynbfile how to do that.It fixes a lot of stability issues, so it's well worth the effort!AboutThis package allows you to request garmin device, activity and health data from your Garmin Connect account.
Seehttps://connect.garmin.com/Installationpip3installgarminconnectAuthenticationThe library uses the same authentication method as the app usingGarth.
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_CONSUMERcan be set manually prior to calling api.login() if someone wants to use a custom consumer key and secret.TestingThe test files use the credential tokens created byexample.pyscript, so use that first.exportGARMINTOKENS=~/.garminconnect
sudoaptinstallpython3-pytest(neededsomedistros)makeinstall-test
maketestDevelopmentTo create a development environment to commit code.pip3 install pdm
pip3 install ruff
pdm init

sudo apt install pre-commit
pip3 install pre-commitRun checks before PR/Commit:make format
make lint
make codespellExampleThe tests provide examples of how to use the library.There is a Jupyter notebook calledreference.ipynbprovidedhere.And you can check out theexample.pycode you can findhere, you can run it like so:pip3 install -r requirements-dev.txt
./example.pyCredits:heart: 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