Skip to main content

Utility to synchronize a Fitbit tracker with the Fitbit server

Project description


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

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


Download files

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

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page