Utility to synchronize a Fitbit tracker with the Fitbit server
This is a Python utility to synchronize a Fitbit device with the Fitbit web service. It allows you to browse your data on their website, and their apps.
All Bluetooth-based trackers are supported. Those are:
- Fitbit One
- Fitbit Zip
- Fitbit Flex
- Fitbit Force
The Fitbit Ultra tracker is not supported as it communicates using the ANT protocol. To synchronize it, please use libfitbit.
This utility is mainly targeted at Linux because Fitbit does not provide any Linux-compatible software but, as Python is cross-platform and the libraries used are available on a broad variety of platforms, it should not be too difficult to port it to other platforms.
The easy way
If you want to run the utility as a non-root user, you will have to install the udev rules manually (See The more complicated way or follow the instructions given when it fails).
$ pip install galileo $ galileo
If you don’t want to install this utility system-wide, you may want to install it inside a virtualenv, the behaviour will not be affected.
The more complicated way
First, you need to clone this repository locally, (or download the galileo.py script to you local machine), and install the required dependencies:
- pyusb (tested with 1.0.0b1)
- requests (tested with 2.0.1)
You should copy the file 99-fitbit.rules to the directory /etc/udev/rules.d in order to be able to run the utility as a non-root user.
Don’t forget to:
- restart the udev service: sudo service udev restart
- unplug and re-insert the dongle to activate the new rule.
Then simply run galileo.py.
An example trace can be found in the file trace.txt.
Run the utility with the --help argument to see a list of available options to control the synchronization behavior.
Special thanks to the folks present @ the issue 46 of libfitbit.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|galileo-0.3-py2.6.egg (17.7 kB) Copy SHA256 hash SHA256||Egg||2.6||Jan 26, 2014|
|galileo-0.3-py2.7.egg (17.6 kB) Copy SHA256 hash SHA256||Egg||2.7||Jan 26, 2014|
|galileo-0.3.tar.gz (8.5 kB) Copy SHA256 hash SHA256||Source||None||Jan 26, 2014|