galileo 0.3.1

Utility to synchronize a Fitbit tracker with the Fitbit server

Author:

Benoît Allard <[e-mail]>

Version:

0.3.1

license:

LGPL

bug tracker:

https://bitbucket.org/benallard/galileo/issues

mailing list:

[e-mail] (subscribe, archive)

Introduction

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

Note

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.

Installation

The easy way

Warning

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

Note

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.

Example

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.

Acknowledgements

Special thanks to the folks present @ the issue 46 of libfitbit.

Especialy to sansneural for https://docs.google.com/file/d/0BwJmJQV9_KRcSE0ySGxkbG1PbVE/edit and Ingo Lütkebohle for http://pastebin.com/KZS2inpq.