Skip to content
/ myfitbit Public

Fitbit data export - Because your data belongs to you!

License

Notifications You must be signed in to change notification settings

Knio/myfitbit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MyFitbit

Because "Your data belongs to you!"

...and fitbit's own data export sucks.

Python version Build status Coverage status

Installation

The recommended way to install myfitbit is with pip:

sudo pip install myfitbit

PyPI version PyPI downloads

Manual installation:

git clone [email protected]:Knio/myfitbit
cd myfitbit
python3 setup.py install

Setup

  1. Register a new app at https://dev.fitbit.com/apps/new

The app should look like this:

The Callback URL must be exactly http://localhost:8189/auth_code

  1. Configure the API keys

Make a file myfitbit.ini in your working directory with the client ID and secret you got from registering the fitbit app:

[fitbit_auth]
client_id = 123ABCD
client_secret = 0123456789abcdef0a1b2c3d4f5
access_token_file = .myfitbit_access_token
  1. Export your data
python3 -m myfitbit

This will open a web browser and prompt you to allow the app to access your data.

It will then begin exporting to your current working directory.

Note that the fitbit API is rate limited to 150 calls/hour, and you can query only 1 day of heartrate data at a time. If you many days of data, you will be rate limited and see an HTTP 429 error. Simply re-run the command an hour later and it will resume downloading where it left off.

  1. Generate report
python3 -m myfitbit.report --user 123ABC

Use the user id seen in the output from step 2

This will generate report.html in your current working directory.

Fitbit Report

About

Fitbit data export - Because your data belongs to you!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published