gbb - Man Page

gbb monitor

Monitors the current battery usage and and prints statistics to standard out. This is the same as gbb test --verbose without actually running a test, and is mostly a tool for debugging the GNOME Battery Bench application code.

gbb play <filename>

Replays an event log recorded with gbb record. This is mostly meant to try out an event log that you recorded without having to create a full test and install it the per-user or system-wide test directories.

gbb play-local <filename>

Exactly the same as gbb play, but instead of talking to gnome-battery-bench-helper over D-BUS, it assumes that the current user has privileges to simulate events via /dev/uinput.

gbb record [-o | --output <output file>]

Records events to standard output, or if --output is specified, to the given file.

Runs the specified test. Tests are looked for in /usr/share/gnome-battery-bench/tests and in ~/.config/gnome-battery-bench/.tests.

gbb test [-o | --output <output file] [--duration <hours>h<minutes>m<seconds>s] [--min-battery <percent>] [--screen-brightness <percent>] <test-id>

--output

Specifies the output filename. If not specified, the output will be written in ~/.local/share/gnome-batttery-bench/logs, and will be visible in the list of historical runs in the user interface.

--duration

Specifies how long to run the test for. Any or all of hours, minutes, and seconds can be specified - e.g. 1h, 1h10m, 10m3s, 100s.

--min-battery

Specifies that the test will run until the battery reaches the specified percentage. Exclusive with the --duration argument

--screen-brightness

Sets the brightness of the backlight during the test

--verbose

Print verbose statistics in the style of gbb monitor