Content-type: text/html
Man page of galileo
galileo
Section: User Commands (1)
Updated: March 2014
Index
Return to Main Contents
NAME
galileo - synchronize Fitbit devices
SYNOPSIS
galileo
[-h]
[-c FILENAME]
[--dump-dir DIR]
[--daemon-period PERIOD]
[-I ID[ ID ... ] ]
[-X ID[ ID ... ] ]
[-v|-d|-q]
[--force|--no-force]
[--dump|--no-dump]
[--upload|--no-upload]
[--https-only|--no-https-only]
[sync|daemon|version]
DESCRIPTION
Synchronize Fitbit wearable fitness tracker devices with the Fitbit web service.
Visit <
https://www.fitbit.com
>, or use a Fitbit-compatible app in order
to browse your data.
MODES
- sync
-
Perform the synchronization of all found trackers, then exit. This is
the default mode if none is specified.
- daemon
-
Periodically perform synchronization of all found trackers.
galileo
will periodically perform synchronization until the daemon is killed. The
period can be controlled via the
--daemon-period
option.
- version
-
Display the
galileo
version and exit.
OPTIONS
- -h, --help
-
show command-line usage and exit.
- -c RCCONFIGNAME, --config RCCONFIGNAME
-
use RCCONFIGNAME as extra configuration file in order to allow overriding
of settings.
The remaining options are first read from configuration file, and can be
overridden by using command line switches. For this reason, positive and
negative versions are available (--foo and --no-foo). Please
see
galileorc(5)
for more information about the configuration files.
Logging options:
- -v, --verbose
-
display general information on progress during synchronization.
- -d, --debug
-
as --verbose, but also shows internal activity useful for
diagnosing problems.
- -q, --quiet
-
show no output except for errors and a summary. This is the default
if no other logging options are specified.
Synchronization control options:
- -I ID [ID ...], --include ID [ID ...]
-
list of tracker IDs to synchronize (if not set, all found trackers are
synchronized).
- -X ID [ID ...], --exclude ID [ID ...]
-
list of tracker IDs to avoid synchronizing (no trackers are excluded
by default).
- --force
-
a tracker will not be synchronized with the Fitbit web service if it reports
that it was recently synchronized. This option overrides that behavior.
- --no-force
-
if the configuration file includes the force-sync option to
always force synchronization, this option will restore the default
behaviour.
- --daemon-period PERIOD
-
set the time to wait between synchronizations when running in
daemon mode. The period is specified in milliseconds and
defaults to 15000 (15 seconds).
Tracker data saving options:
- --dump
-
save a copy of the tracker data. Tracker data is stored under a
tracker-specific subdirectory of a directory that is set using the
--dump-dir option. This is the default behavior.
- --no-dump
-
disables the saving of tracker data.
- --dump-dir DIR
-
the directory used to store the tracker dumps (defaults to
~/.galileo).
Data transfer options:
- --upload
-
synchronize tracker data with the Fitbit web service. This is the
default.
- --no-upload
-
prevent the uploading of tracker data to the Fitbit web service. Data
is not deleted from trackers until it is acknowledged by the fitbit server
so this will not result in data loss.
- --https-only
-
data sent to the Fitbit web service will be transferred via a secure connection
using HTTPS. This is the default.
- --no-https-only
-
if HTTPS connection is not possible, this will allow the fallback to HTTP.
This should only be required if problems with encryption libraries prevent
data transfer without this option.
REQUIREMENTS
An original Fitbit Bluetooth-LE USB synchronization dongle is
required.
The Fitbit tracker must already be registered to your Fitbit account
(see the BUGS section).
FILES
- /etc/galileo/config, $XDG_CONFIG_HOME/galileo/config, ~/.galileorc
-
The configuration files used for default settings. See
galileorc(5)
for further details about those files
SEE ALSO
- <http://www.fitbit.com>
-
The Fitbit web service where synchronized tracker data may be viewed.
- <https://bitbucket.org/benallard/galileo>
-
The galileo homepage where additional information is available.
- galileorc(5)
-
The format of the configuration file providing default settings.
AUTHOR
Written and maintained by Benoît Allard, with contributions from other
authors.
BUGS
galileo
doesn't currently support linking (pairing) trackers with the Fitbit
web service account. Before a new tracker can be synchronized it must
first be linked to your Fitbit account using another method such as a
Fitbit mobile or tablet app, or the official Fitbit Windows or
Macintosh desktop clients.
There are no current facilities to make use of the data stored with
the --dump command.
Please report additional bugs to
<https://bitbucket.org/benallard/galileo/issues>
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- MODES
-
- OPTIONS
-
- Logging options:
-
- Synchronization control options:
-
- Tracker data saving options:
-
- Data transfer options:
-
- REQUIREMENTS
-
- FILES
-
- SEE ALSO
-
- AUTHOR
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 22:02:08 GMT, March 31, 2014