byobu(1) byobu byobu(1)
NAME
byobu - wrapper script for seeding a user's byobu configuration and launching screen
SYNOPSIS
byobu [screen options]
Options to byobu are simply passed through screen(1).
DESCRIPTION
byobu is a script that launches GNU screen in the byobu configuration. This enables the display of system information and status notifica-
tions within two lines at the bottom of the screen session. It also enables multiple tabbed terminal sessions, accessible through simple
keystrokes.
Note that BYOBU_CONFIG_DIR=$XDG_CONFIG_HOME/byobu if defined, and $HOME/.byobu otherwise.
STATUS NOTIFICATIONS
byobu supports a number of unique and interesting status notifications across the lowest two lines in the screen. Each status notification
item is independently configurable, enabled and disabled by the configuration utility. The guide below helps identify each status item (in
alphabetical order):
apport - symbol displayed if there are pending crash reports; {!} symbol displayed on the lower bar toward the left, in black on an orange
background
arch - system architecture; displayed on the lower bar toward the left, in the default text color on the default background color
battery - battery information; display on the lower bar toward the right; |-| indicates discharging, |+| indicates charging, |=| indicates
fully charged; when charging or discharging, the current battery capacity as a percentage is displayed; the colours green, yellow, and
red are used to give further indication of the battery's charge state; you may override the detected battery by setting BAT-
TERY=/proc/acpi/battery/BAT0 in $BYOBU_CONFIG_DIR/statusrc
cpu_count - the number of cpu's or cores on the system; displayed in the lower bar toward the right in the default text color on the
default background, followed by a trailing 'x'
cpu_freq - the current frequency of the cpu in GHz; displayed in the lower bar toward the right in white text on a light blue background
cpu_temp - the cpu temperature in Celsius (default) or Fahrenheit, configure TEMP=F or TEMP=C in $BYOBU_CONFIG_DIR/statusrc; displayed in
the lower bar toward the right in yellow text on a black background; you may override the detected cpu temperature device by setting MONI-
TORED_TEMP=/proc/acpi/whatever in $BYOBU_CONFIG_DIR/statusrc
custom - user defined custom scripts; must be executable programs of any kind in $BYOBU_CONFIG_DIR/bin; must be named N_NAME, where N is
the frequency in seconds to refresh the status indicator, and NAME is the name of the script; N should not be less than 5 seconds; the
script should echo a small amount of text to standard out, standard error is discarded; the indicator will be displayed in the lower panel,
in inverted colors to your current background/foreground scheme, unless you manually specify the colors in your script's output; BEWARE,
cpu-intensive custom scripts may impact your overall system performance and could upset your system administrator!
Example: $BYOBU_CONFIG_DIR/bin/1000_uname
#!/bin/sh
printf "