Skip to main content

export fitbit data

Project description

# MyFitbit

Because “Your data belongs to you!”

…and fitbit’s own data export sucks.

![Python version](https://img.shields.io/pypi/pyversions/myfitbit.svg?style=flat) [![Build status](https://img.shields.io/travis/Knio/myfitbit/master.svg?style=flat)](https://travis-ci.org/Knio/myfitbit) [![Coverage status](https://img.shields.io/coveralls/github/Knio/myfitbit/master.svg?style=flat)](https://coveralls.io/r/Knio/myfitbit?branch=master)

## Installation

The recommended way to install myfitbit is with [pip](http://pypi.python.org/pypi/pip/):

sudo pip install myfitbit

[![PyPI version](https://img.shields.io/pypi/v/myfitbit.svg?style=flat)](https://pypi.org/project/myfitbit/) [![PyPI downloads](https://img.shields.io/pypi/dm/myfitbit.svg?style=flat)](https://pypi.org/project/myfitbit/)

Manual installation:

`sh git clone git@github.com: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

<img src=”docs/fitbit_app.png” width=”271” height=”606”>

  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](docs/fitbit.png)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

myfitbit-0.7.0.tar.gz (11.3 kB view details)

Uploaded Source

Built Distribution

myfitbit-0.7.0-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

Details for the file myfitbit-0.7.0.tar.gz.

File metadata

  • Download URL: myfitbit-0.7.0.tar.gz
  • Upload date:
  • Size: 11.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.9

File hashes

Hashes for myfitbit-0.7.0.tar.gz
Algorithm Hash digest
SHA256 d1e697f358b6970ffa4d03791c503003e3b8d179308f88f2369efe9ba2db3a01
MD5 70cf7299804560f47b71f14041434035
BLAKE2b-256 bc193b18015200a6ce24b20bdbd841f6f669d0cba3ecc3daebc72deabbc8f07c

See more details on using hashes here.

File details

Details for the file myfitbit-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: myfitbit-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 11.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.9

File hashes

Hashes for myfitbit-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e1d4580845c381568d5c9be7231bf35b9530b2457957cfab21cf0ab9da7559cf
MD5 0434080adf82cba26d1c37d9bd5d0643
BLAKE2b-256 227c9c47253d9605ca1ba64ea8feb8d86c84aa7b7afff4f0ba8504cbfa6262d4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page