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