NAME

galileorc - configuration files for the galileo Fitbit synchronization utility

DESCRIPTION

The galileorc file is used to provide default settings to the galileo(1) utility. Any settings that would normally be passed as command-line arguments to galileo can, instead, be present in this configuration file to prevent having to repeat them again and again.

Settings provided in the configuration files can be overridden by run-time command-line switches. See galileo(1)

FILES

The following files will be read if present. Later one override previous settings and settings provided on the command-line override settings defined in configuration files.

• /etc/galileo/config
• $XDG_CONFIG_HOME/galileo/config (The XDG_CONFIG_HOME environment variable default to ~/.config if not defined)
• ~/.galileorc
• any file specified with the -c command-line switch

SYNTAX

The settings file is defined in YAML format. Blank lines and comments (from the first hash character '#' to the end of the line) are ignored.

The configuration file is parsed as a dictionary of settings, which means that each setting is defined using a keyword followed by a colon character. For single-value settings (the majority), the value follows the colon, for example:

do-upload: true

For settings of type list (such as the tracker ID inclusion and exclusion lists), the values appear with an indentation on subsequent lines and prefixed with a dash, for example:

include:


  - '123456789ABC'


  - '9876543210AB'

SETTINGS

The following settings can be added to the configuration files - not all options have to be specified; any that are not mentioned will leave the defaults in effect. See galileo(1) for details about the default values.

logging

controls the amount of progress output. Can be verbose to display progress during synchronization, debug for more detailed information useful for diagnosing problems, or quiet to display only a warning and error messages.

syslog

setting this to true will send all logging output to the syslog facility. Due to the rate-limiting of some syslog servers, this option might not work in combination with the debug log level.

include

the list of tracker IDs to synchronize. If this is specified then only trackers from this list will be synchronised.

exclude

the list of tracker IDs not to synchronize.

force-sync

setting this to true causes trackers to be synchronized even if they report that they already have been synchronized recently.

daemon-period

this defines, in milliseconds, the period at which a synchronisation attempt will be performed when galileo is run in daemon mode.

keep-dumps

setting this to true causes galileo to save the data retrieved from trackers to the directory specified in dump-dir.

dump-dir

the directory used for saving tracker data if the keep-dumps option is set.

do-upload

setting this to false will prevent galileo from sending tracker data to the Fitbit web service.

fitbit-server

this setting allow to specify the name of the server to connect to when performing the synchronization.

https-only

setting this to false will allow galileo to fallback to unencrypted HTTP if HTTPS fails for sending tracker data to the Fitbit web service.

hardcoded-ui

This is a structured section that includes the answers needed during the pairing/firmware update process.

EXAMPLE

The following is an example configuration file:

daemon-period: 60000
keep-dumps: false
do-upload: true
dump-dir: ~/.galileo-tracker-data
logging: verbose
force-sync: false
https-only: false
include:


  - '123456789ABC'


  - '9876543210AB'
exclude:


  - 'AABBCCDDEEFF'


  - '881144BB1234'

SEE ALSO

<http://www.yaml.org>

The official YAML homepage, with more background information on the YAML file format.

galileo(1)

The galileo utility which uses these configuration files for default settings.

<https://bitbucket.org/benallard/galileo>

The galileo homepage where additional information is available.

AUTHOR

Written and maintained by Benoît Allard, with contributions from other authors.

BUGS

Tracker IDs which consist of only numbers must be surrounded with single quotes (as in the EXAMPLE section above). It's probably a good idea to always quote tracker IDs to avoid possible confusion.

Please report additional bugs to <https://bitbucket.org/benallard/galileo/issues>.