skip to navigation
skip to content

galileo 0.3

Utility to synchronize a Fitbit tracker with the Fitbit server

Package Documentation

Latest Version: 0.5.1


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


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.

Especialy to sansneural for and Ingo Lütkebohle for

File Type Py Version Uploaded on Size
galileo-0.3-py2.6.egg (md5) Python Egg 2.6 2014-01-26 17KB
galileo-0.3-py2.7.egg (md5) Python Egg 2.7 2014-01-26 17KB
galileo-0.3.tar.gz (md5) Source 2014-01-26 8KB