galileo(1)

📦 version 0.5.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

galileo 💖 User Commands

okay bestie, sit down, hydrate, and let me tell you about galileo — she's a little command-line queen whose whole job is synchronizing your Fitbit devices ✨. Manual section 1, user commands, we're in it. Let's go 🫶

✨ 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]
[-s SERVERNAME] [--log-size SIZE] [--syslog|--no-syslog]
[sync|daemon|version]

✨ DESCRIPTION ✨

So the whole vibe here is: galileo syncs your Fitbit wearable fitness tracker devices with the Fitbit web service 💅. Then you go to <https://www.fitbit.com>, or you use a Fitbit-compatible app, and you browse all your data like the main character you are. Periodt. 👑

✨ MODES ✨

You pick one, and she does the thing:

  • sync — performs the synchronization of all found trackers, then exits. This is the default mode if none is specified. lowkey the everyday one 🌸
  • daemon — periodically performs synchronization of all found trackers. galileo will keep periodically synchronizing until the daemon is killed 😭. You control the period with the --daemon-period option.
  • version — displays the galileo version and exits. short, sweet, iconic 🎀
  • interactive — this spawns an interactive shell so you can send arbitrary commands to the dongle and the tracker 👀. It exists so you can experiment with new commands, or different command orders. To be used by experts only. fr fr.
  • pair — this mode, in an experimental state, lets you link your tracker with your Fitbit online account. You need this before you can use any new tracker. To use this mode you need an account on the Fitbit online platform, and a tracker. The parameters for this mode are taken from the hardcoded-ui section of the galileorc(5) file 🦋

✨ OPTIONS ✨

  • -h, --help — shows command-line usage and exits. the classic 🫶
  • -c RCCONFIGNAME, --config RCCONFIGNAME — use RCCONFIGNAME as an extra configuration file so you can override settings ✨

The remaining options are first read from the configuration file, and can be overridden by using command line switches. That's why positive and negative versions exist (--foo and --no-foo) — so you can flip a config-file setting back off from the command line 💅. Please see galileorc(5) for more info about the configuration files.

🌸 Logging options:

  • -v, --verbose — displays general information on progress during synchronization 👀
  • -d, --debug — same as --verbose, but also shows internal activity useful for diagnosing problems 🔍
  • -q, --quiet — shows no output except for errors and a summary. This is the default if no other logging options are specified 🤫
  • --syslog — sends 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 ⚠️
  • --no-syslog — sends logging output to stderr 🖥️

🔥 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 🛟 (good to know, bestie)
  • --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 an 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 ⚠️
  • -s SERVERNAME, --fitbit-server SERVERNAME — the server to connect to when performing the synchronization (defaults to api.fitbit.com) 🌐
  • --log-size SIZE — indicate the amount of communication that should be displayed in case of errors. Galileo will keep in memory the last SIZE communications to help debugging if an error happens. This is particularly useful in case of hard-to-reproduce issues, where it is too late to collect debug information 😭. Defaults to 10. Set to 0 to disable this functionality 🧠

✨ REQUIREMENTS ✨

  • An original Fitbit Bluetooth-LE USB synchronization dongle is required. no off-brand shortcuts, bestie 🔌
  • 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 ✨

✨ AUTHOR ✨

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

✨ BUGS ✨

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

and that's the whole page, bestie 💖 This is version 0.5.1, dated June 2014, from the galileo(1) manual — go sync something iconic ✨👑🎀

📦 where this page comes from