Skip to main content

# MyFitbit

Because “Your data belongs to you!”

…and fitbit’s own data export sucks.

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

## Installation

pip install nostalgia_fitbit

## Setup

nostalgia_fitbit assumes a registered app.

To get started, follow the prompts after running (will open a browser):

nostalgia_fitbit

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”>

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.

## Generate report

Note: This is not officially supported by nostalgia

` python3 -m nostalgia_fitbit.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)

Metadata

Release files for nostalgia-fitbit 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nostalgia-fitbit 0.6.0
File Size Uploaded
nostalgia_fitbit-0.6.0.tar.gz 1.5 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for nostalgia-fitbit 0.6.0
File Interpreter ABI Platform
nostalgia_fitbit-0.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.5 MB

Release files / nostalgia_fitbit-0.6.0.tar.gz

Download URL nostalgia_fitbit-0.6.0.tar.gz
Size 1.5 MB
Tags Source
SHA-256 checksum
How to use checksums
04bd810339d6bfc16f6fc1131da6e0eaeee268cd6e85a8a2a0f410119719b41b
BLAKE2b-256 checksum
How to use checksums
faefbaff3bdfd6561e475c876afa327d57dc7045d35788658458945258857d20
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.7.0a0

Release files / nostalgia_fitbit-0.6.0-py3-none-any.whl

Download URL nostalgia_fitbit-0.6.0-py3-none-any.whl
Size 27.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
01c33e5a66a7696fe6db6886bb4becb131d273f269a250da729e185a56efbbaf
BLAKE2b-256 checksum
How to use checksums
f3926def20b13b2fca1208e56558062a17e5cc72cb45c900213beaeee9abbf9e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.7.0a0

Release history Release notifications | RSS feed

This release

0.6.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page