byobu(1) byobu byobu(1)

# [NAME](#NAME)

byobu - wrapper script for seeding a user's byobu configuration and launching a text based window manager (either screen or tmux)

# [SYNOPSIS](#SYNOPSIS)

**byobu** \[options]

**byobu-screen** \[screen options]

**byobu-tmux** \[tmux options]

Options to **byobu** are simply passed through [**screen**(1)](/man/os/byobu/screen.1) or [**tmux**(1)](/man/os/byobu/tmux.1).

# [DESCRIPTION](#DESCRIPTION)

**byobu** is a script that launches a text based window manager (either [**screen**(1)](/man/os/byobu/screen.1) or [**tmux**(1)](/man/os/byobu/tmux.1)) in the byobu configuration. This enables the display of system information and status notifications within two lines at the bottom of the screen session. It also enables multiple tabbed terminal sessions, accessible through simple keystrokes.

**byobu** currently defaults to using [**tmux**(1)](/man/os/byobu/tmux.1) (if present) as the backend, however, this can be overridden with the [**byobu-select-backend**(1)](/man/os/byobu/byobu-select-backend.1) utility.

Note that BYOBU\_CONFIG\_DIR=*$XDG\_CONFIG\_HOME/byobu* if defined, and *$HOME/.byobu* otherwise.

# [BACKGROUND COLORS](#BACKGROUND_COLORS)

The background colors of the **byobu** status lines can be adjusted by editing the files *$HOME/.byobu/color* (for **byobu-screen**) and *$HOME/.byobu/color.tmux* (for **byobu-tmux**). The command **Ctrl-Shift-F5** will change the background to a randomly selected color when running in **byobu-tmux** mode. Simply remove those files to return to the default color configuration.

# [STATUS NOTIFICATIONS](#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 BATTERY=/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\_usage** - the percentage of cpu time spent busy (not idle or waiting on I/O) since the previous update, across all cpus (Linux only); 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 MONITORED\_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 default colors, 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! In fact, you can easily copy and modify **any** status script usually found in */usr/lib/byobu/\** to your local *$HOME/.byobu/* directory.  
Example: *$BYOBU\_CONFIG\_DIR/bin/1000\_uname*  
#!/bin/sh  
printf "\\005{= bw}%s\\005{-}" "$(uname -r)"

**date** - the system date in YYYY-MM-DD format, or you can set this to any valid [**strftime**(3)](/man/os/byobu/strftime.3) you like in *$BYOBU\_CONFIG\_DIR/datetime*; displayed in the lower on the far right in the default text color on the default background

**disk** - total disk space available and total used on / directory; displayed in the lower bar on the far right in white text on a light purple background; override the default directory by specifying an alternate mount point with MONITORED\_DISK=/wherever in *$BYOBU\_CONFIG\_DIR/statusrc*; to monitor several disks, list their mount points or devices separated by spaces, such as MONITORED\_DISK="/ /home /dev/sdb1", and each one is shown labeled by the last component of its name, such as **/:94G45% home:1.8T12%**

**disk\_io** - instantaneous read/write througput in kB/s or MB/s over the last 3 seconds; displayed in the lower bar toward the right in white text on a light purple background with a leading '<' sign indicating 'read speed' and '>' sign indicating 'write speed'; override the default monitored disk by specifying an alternate device with MONITORED\_DISK=/dev/sdb (if it lists several disks, only the first is monitored), and override the default DISK\_IO\_THRESHOLD=50 (kB/s) in *$BYOBU\_CONFIG\_DIR/statusrc*

**distro** - OS/distribution name of the release running on the current system as reported by [**lsb\_release(1)**](/man/os/byobu/lsb_release.1) or */etc/issue*; displayed in the lower bar in bold black text toward the left on a grey background; you may override the detected release with DISTRO=Whatever in *$BYOBU\_CONFIG\_DIR/statusrc*

**entropy** - a count of the system's current entropy in bytes; displayed in the lower bar toward the right in yellow text on a dark grey background; there is a leading 'e' to indicate 'entropy'

**raid** - note very prominently if there is a RAID failure detected, in red blinking text on a white background; the term 'RAID' notes that there is something wrong with the RAID, and if there is a rebuild/resync in progress, the percent complete is also shown

**fan\_speed** - cpu or system fan speed as reported by lm-sensors; displayed in the lower bar toward the right in black text on a grey background; there is a trailing 'rpm' for units; you may override the detected fan by setting FAN=/sys/path/to/your/fan1\_input in *$BYOBU\_CONFIG\_DIR/statusrc*

**hostname** - the hostname of the system; displayed in the upper bar on the far right in bold black text on a grey background; there is a leading '@' symbol if the username status is also enabled

**ip\_address** - the IPv4 address of the system in dotted decimal form; displayed in the upper bar on the far right in bold black text on a grey background; you can override and display your IPv6 address by setting 'IPV6=1', and you can show your external ip address by setting 'IP\_EXTERNAL=1' in *$BYOBU\_CONFIG\_DIR/statusrc*

**ip\_address4** - the IPv4 address of the system in dotted decimal form; displayed in the upper bar on the far right in bold black text on a grey background; you can show your external ip address by setting 'IP\_EXTERNAL=1' in *$BYOBU\_CONFIG\_DIR/statusrc*

**ip\_address6** - the IPv6 address of the system; displayed in the upper bar on the far right in bold black text on a grey background; you can show your external ip address by setting 'IP\_EXTERNAL=1' in *$BYOBU\_CONFIG\_DIR/statusrc*

**load\_average** - the system load average over the last 1 minute; displayed in the lower bar toward the right in black text on a yellow background; set LOAD\_AVERAGES=3 in *$BYOBU\_CONFIG\_DIR/statusrc* to display all three intervals (1, 5, and 15 minutes) space-separated

**logo** - an approximation of the current operating system's logo; displayed in the lower bar on the far left; you may customize this logo by setting a chosen logo with LOGO=:-D in *$BYOBU\_CONFIG\_DIR/statusrc*

**mail** - system mail for the current user; the letter '\[M]' is displayed in the lower bar toward the left in black text on a grey background

**memory** - total memory available and used percentage in the system; displayed in the lower bar toward the right in white text on a green background

**menu** - a simple indicator directing new users to use the F9 keybinding to access the byobu menu

**network** - instantaneous upload/download bandwidth in \[GMk]bps over the last 3 seconds; nothing is displayed if traffic is 0; displayed in the lower bar toward the left in white text on a purple background with a leading '^' sign indicating 'up' and 'v' sign indicating 'down'; override the default interface by specifying an alternate interface with MONITORED\_NETWORK=eth1, and override the default units (bits) with NETWORK\_UNITS=bytes, and override the default NETWORK\_THRESHOLD=20 (kbps) in *$BYOBU\_CONFIG\_DIR/statusrc*

**notify\_osd** - Send on-screen notification messages to screen's notification buffer

**packages** - total number of packages installed on the system; displayed in the lower bar in yellow text on a white background inside of square brackets, '\[xxx]'

**processes** - total number of processes running on the system; displayed in the lower bar in white text on a dark yellow background with a trailing '&' indicating 'background processes'

**reboot\_required** - symbol present if a reboot is required following a system update; displayed in the lower bar white text on a blue background by the symbol '(R)'; additionally, reboot\_required will print '<F5>' in white text on a blue background, if Byobu requires you to reload your profile to affect some changes; it will also detect if your system is currently in [**powernap**(8)](/man/os/byobu/powernap.8) state and if so print '.zZ'; if your system is currently performing an [**unattended-upgrade**(1)](/man/os/byobu/unattended-upgrade.1) you will see a white warning sign on a red background.

**release** - OS/distribution name of the release running on the current system as reported by [**lsb\_release(1)**](/man/os/byobu/lsb_release.1) or */etc/issue*; displayed in the lower bar in bold black text toward the left on a grey background; you may override the detected release with RELEASE=Whatever in *$BYOBU\_CONFIG\_DIR/statusrc*; you may also abbreviate the release string to N characters by setting RELEASE\_ABBREVIATED=N in *$BYOBU\_CONFIG\_DIR/statusrc*

**services** - users can configure a list of services to monitor, define the SERVICES variable in *$BYOBU\_CONFIG\_DIR/statusrc*, a whitespace separated of services, each service should include the init name of the service, then a pipe, and then an abbreviated name or symbol to display when running (e.g. SERVICES="ssh|ssh apache2|http"); displayed in the lower bar toward the center in cyan on a white background

**session** - byobu session name (only supported in [**byobu-tmux**(1)](/man/os/byobu/byobu-tmux.1)); displayed in the lower bar on the left in underlined black text on a white background

**swap** - total swap space and total used as a percentage of the total available; displayed in the lower bar toward the right in black text on a light green background with a trailing '%' sign

**time** - the system time in HH:MM:SS format (by default), or you can set this to any valid [**strftime**(3)](/man/os/byobu/strftime.3) you like in *$BYOBU\_CONFIG\_DIR/datetime*; displayed in the lower bar on the far right in the default text and default background colors

**time\_binary** - only for the hard core geek, the local system time in binary; requires UTF-8 support in a VERY recent version of GNU Screen; displayed in the lower bar on the far right in the default text and background colors

**time\_utc** - the UTC system time in HH:MM format; displayed in the lower bar on the far right in dark text on a light background

**updates\_available** - the number of updates available on the system; displayed in the lower bar toward the right in white text on a red background with a trailing '!' sign; if any updates are marked 'security updates', then there will be a total of two trailing exclamation points, '!!'

**uptime** - the total system uptime since last boot; displayed in the lower bar toward the right in blue text on a grey background

**users** - the number of remote users logged into the system via sshd, empty if 0 users; displayed in the lower bar toward the right in red text on a grey background with a trailing '#' sign; set USERS\_DISTINCT=1 to instead count the number of distinct users logged into the system (rather than open ssh sessions)

**whoami** - the name of the user who owns the screen session; displayed in the upper bar toward the far right in bold black text on a grey background

**wifi\_quality** - the connection rate and signal quality of the wifi connection; displayed in the lower bar toward the right in black text on a cyan background; the connection rate is in 'Mb/s' and the signal quality is as a percentage with a trailing '%'; override the default interface by specifying an alternate interface with MONITORED\_NETWORK=wlan0 in *$BYOBU\_CONFIG\_DIR/statusrc*

# [STATUS ICONS](#STATUS_ICONS)

**byobu** displays status indicators using different icons depending on your terminal encoding. When using [**byobu-tmux**(1)](/man/os/byobu/byobu-tmux.1) with UTF-8 encoding, Unicode symbols are displayed. Otherwise, ASCII-only icons are used (such as with [**byobu-screen**(1)](/man/os/byobu/byobu-screen.1) or non-UTF-8 terminals).

[**Unicode Icons** (displayed when BYOBU\_BACKEND=tmux and BYOBU\_CHARMAP=UTF-8):](#Unicode)

[**updates\_available:**](#updates_available:)

! = regular updates available; ⚠ = distribution upgrades available; ‼ = security updates available

[**reboot\_required:**](#reboot_required:)

⟳ = system reboot required; ⚠ = unattended upgrade in progress; 🗹 = kernel is live-patched

[**disk\_io:**](#disk_io:)

◂ = disk read activity; ▸ = disk write activity

[**network:**](#network:)

▴ = network upload activity; ▾ = network download activity

[**mail:**](#mail:)

⍌ = new mail waiting

[**session:**](#session:)

〣 = session indicator

[**trash:**](#trash:)

♸ = items in trash

[**ASCII Icons** (displayed with screen backend or non-UTF-8 terminals):](#ASCII)

[**updates\_available:**](#updates_available:~2)

! = regular updates; /!\\\\ = upgrades; !! = security updates

[**reboot\_required:**](#reboot_required:~2)

(R) = reboot required; /!\\\\ = upgrade running; \[/] = live-patched

[**disk\_io:**](#disk_io:~2)

< = read; > = write

[**network:**](#network:~2)

^ = upload; v = download

[**mail:**](#mail:~2)

\[M] = new mail

[**session:**](#session:~2)

| = session indicator

[**trash:**](#trash:~2)

T = trash

[To see detailed explanations of all active status indicators, press **Ctrl-a $** while running byobu.](#To)

# [SESSIONS](#SESSIONS)

Byobu name screen sessions "byobu", if unspecified. To hide sessions from [**byobu-select-session**(1)](/man/os/byobu/byobu-select-session.1), prepend a "." to the beginning of the session name, like:

byobu -S .hidden

In [**byobu-tmux**(1)](/man/os/byobu/byobu-tmux.1), running **byobu** to attach to an already-running session does not, by default, reattach to that exact session object. Instead it creates a new session in the same tmux *session group* as the existing one, sharing the same set of windows and panes while giving each attaching terminal its own independent current-window focus and scrollback view. tmux names each member of the group by appending "-2", "-3", and so on to the original session's name, and the "session" status indicator (see STATUS NOTIFICATIONS above) counts every member of the group, not just one -- so opening and detaching from byobu repeatedly is expected to grow this count, and switching between group members with the window-switching keybindings will not show different window content, since the windows are shared. Every session in the group other than the original has tmux's **destroy-unattached** option set, so it is automatically destroyed as soon as you switch away from it, which is why the indicator eventually settles back down on its own.

To make **byobu** reattach to the exact same session instead of creating a new grouped one on every invocation, create an empty file at *$BYOBU\_CONFIG\_DIR/.reuse-session*:

touch $BYOBU\_CONFIG\_DIR/.reuse-session

# [WINDOWS](#WINDOWS)

Each open window in the screen session is displayed in the upper bar toward the far left. These are numbered, and include indicators as to activity in the window (see "activity" in [**screen**(1)](/man/os/byobu/screen.1) and [**tmux**(1)](/man/os/byobu/tmux.1) for symbol definitions). The current active window is highlighted by inverting the background/text from the rest of the window bar.

Users can create a list of windows to launch at startup in *$BYOBU\_CONFIG\_DIR/windows* and *$BYOBU\_CONFIG\_DIR/windows.tmux*. This file is the same syntax as *~/.screenrc* and *~/.tmuxrc*, each line specifying a window, as described in [**screen**(1)](/man/os/byobu/screen.1) or [**tmux**(1)](/man/os/byobu/tmux.1).

User can also launch Byobu with unique window sets. Users can store these as *$BYOBU\_CONFIG\_DIR/windows.\[NAME]* and *$BYOBU\_CONFIG\_DIR/windows.tmux.\[NAME]*, and launch Byobu with the environment variable **BYOBU\_WINDOWS**=NAME.

For example:  
$ cat $BYOBU\_CONFIG\_DIR/windows.ssh\_sessions  
screen -t localhost bash  
screen -t aussie ssh root@aussie  
screen -t beagle ssh root@beagle  
screen -t collie ssh root@collie

Then:  
$ BYOBU\_WINDOWS=ssh\_sessions byobu

For example:  
$ cat $BYOBU\_CONFIG\_DIR/windows.tmux.split4  
new-session 'bash' ;  
new-window -n term1 ;  
new-window -n term2 ;  
new-window -n ssh ssh 10.9.8.7 ;  
split-window ;  
split-window ;  
split-window ;  
select-layout tiled ;  
select-pane -t 0

Then:  
$ BYOBU\_WINDOWS=split4 byobu

# [UNITS OF MEASURE](#UNITS_OF_MEASURE)

byobu uses binary for capacity measurements of KB, MB, GB, and TB. This means multiples of 1024 rather than multiples of 1000, in accordance with JEDEC Standard 100B.01 for memory capacity measurements. See:  
\* http://en.wikipedia.org/wiki/JEDEC\_memory\_standards

byobu uses decimal for measurements of network data transfer, meaning multiple of 1000, rather than 1024. See:  
\* http://en.wikipedia.org/wiki/Data\_rate\_units

# [KEYBINDINGS](#KEYBINDINGS)

Add your own tmux keybindings to *$BYOBU\_CONFIG\_DIR/keybindings.tmux* and other tmux settings to *$BYOBU\_CONFIG\_DIR/.tmux.conf* (usually ~/.byobu or ~/.config/byobu); byobu loads both after its defaults and never overwrites them. Don't edit *profile.tmux*, which loads byobu's defaults. The common key bindings are:

**F2** - Create a new window

**F3** - Move to previous window

**F4** - Move to next window

**F5** - Reload profile

**F6** - Detach from this session

**F7** - Enter copy/scrollback mode

**F8** - Re-title a window

**F9** - Configuration Menu

**F12** - Lock this terminal

**shift-F2** - Split the screen horizontally

**ctrl-F2** - Split the screen vertically

**shift-F3** - Shift the focus to the previous split region

**shift-F4** - Shift the focus to the next split region

**shift-F5** - Join all splits

**ctrl-F6** - Remove this split

**ctrl-F5** - Reconnect GPG and SSH sockets

**shift-F6** - Detach, but do not logout

**alt-pgup** - Enter scrollback mode

**alt-pgdn** - Enter scrollback mode

**Ctrl-a $** - show detailed status

**Ctrl-a R** - Reload profile

**Ctrl-a !** - Toggle key bindings on and off (screen backend)

**Shift-F12** - Toggle byobu F-key bindings on and off (tmux backend)

**F12** then any F-key - Send that F-key to the running application, eg. Midnight Commander, instead of running byobu's binding (tmux backend)

**Ctrl-a k** - Kill the current window

**Ctrl-a ~** - Save the current window's scrollback buffer

# [SCROLLBACK, COPY, PASTE MODES](#SCROLLBACK,_COPY,_PASTE_MODES)

Each window in Byobu has up to 100,000 lines of scrollback history in [**byobu-tmux**(1)](/man/os/byobu/byobu-tmux.1), or 10,000 lines in [**byobu-screen**(1)](/man/os/byobu/byobu-screen.1), which you can enter and navigate using the **alt-pgup** and **alt-pgdn** keys. Exit this scrollback mode by hitting **enter**. You can also easily copy and paste text from scrollback mode. To do so, enter scrollback using **alt-pgup** or **alt-pgdn**, press the **spacebar** to start highlighting text, use **up/down/left/right/pgup/pgdn** to select the text, and press **enter** to copy the text. You can then paste the text into any Byobu window using **F12 ]**, or **alt-insert** in [**byobu-tmux**(1)](/man/os/byobu/byobu-tmux.1); **ctrl-a ]** works too if you have set ctrl-a to Screen mode (see [**byobu-ctrl-a**(1)](/man/os/byobu/byobu-ctrl-a.1)). This pastes from Byobu's own buffer; to copy to your desktop's clipboard as well, your terminal must accept OSC 52 clipboard requests.

In [**byobu-tmux**(1)](/man/os/byobu/byobu-tmux.1), scrollback mode shows a position indicator in the top right corner of the window, such as **14:10 \[24/32]**. Inside the brackets, the first number is how many lines you have scrolled up from the bottom (0 is the live view), and the second is the number of lines of history available, so the two are equal once you reach the top. Since tmux 3.4, the indicator also shows the time at which the line at the top of the screen was printed (**14:10**). While searching, it shows the number of matches. Since tmux 3.6, its format can be changed with tmux's **copy-mode-position-format** option; see [**tmux**(1)](/man/os/byobu/tmux.1).

# [BUGS](#BUGS)

For Byobu colors to work properly, older versions of GNU Screen require a 1-line patch to adjust MAX\_WINMSG\_REND in screen.c. The change is in GNU Screen's upstream source control system as of 2010-01-26, but GNU Screen has not released a new upstream version in several years. You can disable colors entirely by setting MONOCHROME=1 in *$BYOBU\_CONFIG\_DIR/statusrc*. For more information, see:  
\* http://savannah.gnu.org/bugs/?22146

PuTTY users have reported that the F2, F3, and F4 shortcut keys are not working properly. PuTTY sends the same escape sequences as the linux console for F1-F4 by default. You can fix this problem in the PuTTY config, Terminal -> Keyboard -> Function keys: Xterm R6. See: *http://www.mail-archive.com/screen-users@gnu.org/msg01525.html*

PuTTY users should configure enable UTF-8 characters in order to fix status refresh issues. You can fix this problem in the PuTTY configuration, Window -> Translation: select UTF-8.

PuTTY users should avoid resizing their window to one character tall, as this can sometimes crash **byobu-screen**.

Apple macOS users: by default the Option key types special characters instead of acting as Alt. To use Byobu's Alt keybindings, enable 'Use Option as Meta key' in Terminal (Settings > Profiles > Keyboard), or set the Left Option key to 'Esc+' in iTerm2 (Settings > Profiles > Keys). If Ctrl-F2 or Shift-F2 behave like plain F2, the terminal is not sending modified function keys. Byobu's prefix bindings still work: **F12** then **%** for a vertical split, or **F12** then **"** for a horizontal split. macOS also reserves some Ctrl-F-keys as system shortcuts (System Settings > Keyboard > Keyboard Shortcuts), and the F-keys may need **fn** unless 'Use F1, F2, etc. keys as standard function keys' is enabled.

URxvt users have reported that Ctrl+Shift+F-key combinations do not work by default, because URxvt does not send the expected escape sequences for those key chords. You can fix this by adding the following to *~/.Xresources* (then running **xrdb -merge ~/.Xresources**):

```


  URxvt.keysym.S-C-F1:  string:\033[11@


  URxvt.keysym.S-C-F2:  string:\033[12@


  URxvt.keysym.S-C-F3:  string:\033[13@


  URxvt.keysym.S-C-F4:  string:\033[14@


  URxvt.keysym.S-C-F5:  string:\033[15@


  URxvt.keysym.S-C-F6:  string:\033[17@


  URxvt.keysym.S-C-F7:  string:\033[18@


  URxvt.keysym.S-C-F8:  string:\033[19@


  URxvt.keysym.S-C-F9:  string:\033[20@


  URxvt.keysym.S-C-F10: string:\033[21@


  URxvt.keysym.S-C-F11: string:\033[23@


  URxvt.keysym.S-C-F12: string:\033[24@
```

See: *https://github.com/dustinkirkland/byobu/issues/108*

Users of a non-UTF-8 locale (such as cs\_CZ charset ISO-8859-2), may need to add "defutf8 off" to *~/.screenrc*, if some characters are rendering as "?".

Users who customize their PS1 prompt need to put this setting in *~/.bashrc*, rather than *~/.profile*, in order for it to work correctly with Byobu.

If you run [**byobu**(1)](/man/os/byobu/byobu.1) under [**sudo**(8)](/man/os/byobu/sudo.8), you **must** use the -H option, such that the user's $HOME directory environment variable is set properly. Otherwise, [**byobu**(1)](/man/os/byobu/byobu.1) will create a bunch of directories in the $SUDO\_USER's $HOME, but will be owned by root. To prevent this from happening, [**byobu**(1)](/man/os/byobu/byobu.1) will simply refuse to run if $USER does not own $HOME.

Byobu requires a suitable [**ulimit**(3)](/man/os/byobu/ulimit.3) values to run. If you get an error at startup saying, 'pipe: too many open files', then check your ulimit -a values, as your "open files" or "max user processes" are too low. In this case, you will probably need to run simple [**screen**(1)](/man/os/byobu/screen.1)

# [SEE ALSO](#SEE_ALSO)

[**screen**(1)](/man/os/byobu/screen.1), [**byobu-config**(1)](/man/os/byobu/byobu-config.1), [**byobu-export**(1)](/man/os/byobu/byobu-export.1), [**byobu-status**(1)](/man/os/byobu/byobu-status.1), **byobu-status-detail(1), byobu-enable(1), byobu-launch(1), byobu-select-backend(1), tmux(1)**

[*https://byobu.org*](https://byobu.org)

# [AUTHOR](#AUTHOR)

This manpage and the utility were written by Dustin Kirkland <kirkland@byobu.org> for Ubuntu systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document and the utility under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.

The complete text of the GNU General Public License can be found in */usr/share/common-licenses/GPL* on Debian/Ubuntu systems, or in */usr/share/doc/fedora-release-\*/GPL* on Fedora systems, or on the web at *http://www.gnu.org/licenses/gpl.txt*.

19 June 2009 byobu

---

Document: byobu(1) from byobu 7.22-r0 (Chainguard OS)
Source: https://github.com/dustinkirkland/byobu