1GBB(1)                    GNOME Battery Bench Manual                    GBB(1)
2
3
4

NAME

6       gbb - Command line integration client for GNOME Battery Bench
7

SYNOPSIS

9       gbb monitor
10       gbb play <filename>
11       gbb play-local <filename>
12       gbb record [-o | --output <output file]
13       gbb test [-o | --output <output file] [--duration <hours>h<minutes>m<seconds>s] [--min-battery <percent>] [--screen-brightness <percent>] [-v | --verbose] <test-id>
14

DESCRIPTION

16       gbb is a command line client which is provided as part of the GNOME
17       Battery Bench system. For interactive exploration and testing, the
18       GNOME Battery Bench application provides a more polished interface, but
19       gbb can be used for automating tests (gbb tests), developing new tests
20       (gbb record, and gbb play), and debugging the GNOME Battery Bench
21       application code (gbb monitor).
22
23       For more information about GNOME Battery Bench, see the GNOME Battery
24       Bench README file[1]
25

COMMANDS

27   monitor
28       gbb monitor
29
30       Monitors the current battery usage and and prints statistics to
31       standard out. This is the same as gbb test --verbose without actually
32       running a test, and is mostly a tool for debugging the GNOME Battery
33       Bench application code.
34
35   play
36       gbb play <filename>
37
38       Replays an event log recorded with gbb record. This is mostly meant to
39       try out an event log that you recorded without having to create a full
40       test and install it the per-user or system-wide test directories.
41
42   play-local
43       gbb play-local <filename>
44
45       Exactly the same as gbb play, but instead of talking to
46       gnome-battery-bench-helper over D-BUS, it assumes that the current user
47       has privileges to simulate events via /dev/uinput.
48
49   record
50       gbb record [-o | --output <output file>]
51
52       Records events to standard output, or if --output is specified, to the
53       given file.
54
55   test
56       Runs the specified test. Tests are looked for in
57       /usr/share/gnome-battery-bench/tests and in
58       ~/.config/gnome-battery-bench/.tests.
59
60       gbb test [-o | --output <output file] [--duration
61       <hours>h<minutes>m<seconds>s] [--min-battery <percent>]
62       [--screen-brightness <percent>] <test-id>
63
64       --output
65           Specifies the output filename. If not specified, the output will be
66           written in ~/.local/share/gnome-batttery-bench/logs, and will be
67           visible in the list of historical runs in the user interface.
68
69       --duration
70           Specifies how long to run the test for. Any or all of hours,
71           minutes, and seconds can be specified - e.g.  1h, 1h10m, 10m3s,
72           100s.
73
74       --min-battery
75           Specifies that the test will run until the battery reaches the
76           specified percentage. Exclusive with the --duration argument
77
78       --screen-brightness
79           Sets the brightness of the backlight during the test
80
81       --verbose
82           Print verbose statistics in the style of gbb monitor
83

AUTHOR

85       Written by Owen Taylor <otaylor@fishsoup.net[2]>.
86

NOTES

88        1. README file
89           http://git.gnome.org/browse/gnome-battery-bench/plain/README
90
91        2. otaylor@fishsoup.net
92           mailto:otaylor@fishsoup.net
93
94
95
96GNOME Battery Bench Manual        07/19/2023                            GBB(1)
Impressum