Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
Byobu is a suite of enhancements to tmux, as a command line
tool providing live system status, dynamic window management,
and some convenient keybindings:
F1 * Used by X11 *
Shift-F1 Display this help
F2 Create a new window
Shift-F2 Create a horizontal split
Ctrl-F2 Create a vertical split
Ctrl-Shift-F2 Create a new session
F3/F4 Move focus among windows
Alt-Left/Right Move focus among windows
Alt-Up/Down Move focus among sessions
Shift-Left/Right/Up/Down Move focus among splits
Shift-F3/F4 Move focus among splits
Ctrl-F3/F4 Move a split
Ctrl-Shift-F3/F4 Move a window
Shift-Alt-Left/Right/Up/Down Resize a split
F5 Reload profile, refresh status
Alt-F5 Toggle UTF-8 support, refresh status
Shift-F5 Toggle through status lines
Ctrl-F5 Reconnect ssh/gpg/dbus sockets
Ctrl-Shift-F5 Change status bar's color randomly
F6 Detach session and then logout
Shift-F6 Detach session and do not logout
Alt-F6 Detach all clients but yourself
Ctrl-F6 Kill split in focus
F7 Enter scrollback history
Alt-PageUp/PageDown Enter and move through scrollback
Shift-F7 Save history to $BYOBU_RUN_DIR/printscreen
F8 Rename the current window
Ctrl-F8 Rename the current session
Shift-F8 Toggle through split arrangements
Alt-Shift-F8 Restore a split-pane layout
Ctrl-Shift-F8 Save the current split-pane layout
F9 Launch byobu-config window
Ctrl-F9 Enter command and run in all windows
Shift-F9 Enter command and run in all splits
Alt-F9 Toggle sending keyboard input to all splits
F10 * Used by X11 *
F11 * Used by X11 *
Alt-F11 Expand split to a full window
Shift-F11 Zoom into a split, zoom out of a split
Ctrl-F11 Join window into a vertical split
F12 Escape sequence
Shift-F12 Toggle on/off Byobu's keybindings
Alt-F12 Toggle on/off Byobu's mouse support
Ctrl-Shift-F12 Mondrian squares
/usr/share/doc/byobu/help.tmux.txt (END)
official site:
http://byobu.co
10 min video tutorial:
http://people.canonical.com/~kirkland/byobu.mp4
@toaomatis

This comment has been minimized.

Copy link

toaomatis commented Jul 12, 2018

http://people.canonical.com/~kirkland/byobu.mp4 does not work (anymore)

@junaid-ali

This comment has been minimized.

Copy link

junaid-ali commented Aug 20, 2018

@oriolrius

This comment has been minimized.

Copy link

oriolrius commented Oct 11, 2018

I usually have two nested byobu sessions, then I don't know how to send FX key commands to the second sessions. I tried with ctrl+a+a and the FX key but it doesn't work, any idea? thanks.

@greenlaw110

This comment has been minimized.

Copy link

greenlaw110 commented Dec 7, 2018

How do disable the function keys in the current session?

@didibus

This comment has been minimized.

Copy link

didibus commented Jan 30, 2019

To quit (exit) Scrollback mode after pressing F7, try the following:

  • ESC
  • q
  • Ctrl-c
  • ENTER
@oneindelijk

This comment has been minimized.

Copy link

oneindelijk commented Aug 1, 2019

I usually have two nested byobu sessions, then I don't know how to send FX key commands to the second sessions. I tried with ctrl+a+a and the FX key but it doesn't work, any idea? thanks.

Try maybe with Shift-F12 to turn off the byobu in focus' keybindings ?
I suppose then the underlying byobu would receive them ?

If I end up in a nested session, for example a local byobu-session and one in an ssh session, I open a new ssh-session and do a byobu detach (either by firing up byobu and pressing Ctrl-a D or running byobu -d)

@McFlat

This comment has been minimized.

Copy link

McFlat commented Aug 3, 2019

these keybindings are no longer working for me, doesn't matter if backend is tmux or screen, using debian stretch from a macbook

these do work for me

F7 to enter scrollback
Ctrl+U and Ctrl+D (half page up and down)
Ctrl+B and Ctrl+F (full page up and down)

@sdeastham

This comment has been minimized.

Copy link

sdeastham commented Dec 3, 2019

I almost always have to rely on Ctrl-a + [?] commands, as I don't seem to be able to use the function key shortcuts. Is there a list anywhere showing how to execute these commands using Ctrl-a rather than function keys?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.