1byobu(1) byobu byobu(1)
2
6 byobu - wrapper script for seeding a user's byobu configuration and
7 launching a text based window manager (either screen or tmux)
8
11 byobu [options]
12 byobu-screen [screen options]
14 byobu-tmux [tmux options]
16 Options to byobu are simply passed through screen(1) or tmux(1).
18
21 byobu is a script that launches a text based window manager (either
22 screen(1) or tmux(1)) in the byobu configuration. This enables the
23 display of system information and status notifications within two lines
24 at the bottom of the screen session. It also enables multiple tabbed
25 terminal sessions, accessible through simple keystrokes.
26 byobu currently defaults to using tmux(1) (if present) as the backend,
28 however, this can be overridden with the byobu-select-backend(1) util‐
29 ity.
30 Note that BYOBU_CONFIG_DIR=$XDG_CONFIG_HOME/byobu if defined, and
32 $HOME/.byobu otherwise.
33
36 The background colors of the byobu status lines can be adjusted by
37 editing the files $HOME/.byobu/color (for byobu-screen) and
38 $HOME/.byobu/color.tmux (for byobu-tmux). The command Ctrl-Shift-F5
39 will change the background to a randomly selected color when running in
40 byobu-tmux mode. Simply remove those files to return to the default
41 color configuration.
42
45 byobu supports a number of unique and interesting status notifications
46 across the lowest two lines in the screen. Each status notification
47 item is independently configurable, enabled and disabled by the config‐
48 uration utility. The guide below helps identify each status item (in
49 alphabetical order):
50 apport - symbol displayed if there are pending crash reports; {!} sym‐
52 bol displayed on the lower bar toward the left, in black on an orange
53 background
54 arch - system architecture; displayed on the lower bar toward the left,
56 in the default text color on the default background color
57 battery - battery information; display on the lower bar toward the
59 right; - indicates discharging, + indicates charging, = indicates fully
60 charged; when charging or discharging, the current battery capacity as
61 a percentage is displayed; the colours green, yellow, and red are used
62 to give further indication of the battery's charge state; you may over‐
63 ride the detected battery by setting BATTERY=/proc/acpi/battery/BAT0 in
64 $BYOBU_CONFIG_DIR/statusrc
65 cpu_count - the number of cpu's or cores on the system; displayed in
67 the lower bar toward the right in the default text color on the default
68 background, followed by a trailing 'x'
69 cpu_freq - the current frequency of the cpu in GHz