content/blog/2023-06-23-byobu.org

 1#+date:        <2023-06-23 Fri 00:00:00>
 2#+title:       Using Byobu Terminal Multiplexer: Installation and Operational Guide
 3#+description: Detailed overview of Byobu terminal multiplexer features, configuration settings, session management, and keybindings to enhance command-line efficiency.
 4#+slug:        byobu
 5#+filetags:    byobu:terminal-multiplexer:productivity
 6
 7* Byobu
 8
 9[[https://www.byobu.org][byobu]] is a command-line tool that allows you
10to use numerous screens within a single terminal emulator instance. More
11specifically, it's a text based window manager, using either =screen= or
12=tmux=.
13
14This post is mostly just a self-reference as I explore byobu, so I may
15come back later and update this post with more content.
16
17** Screenshot
18
19Take a look below at my current multi-window set-up in byobu while I
20write this blog post:
21
22#+caption: byobu
23[[https://img.cleberg.net/blog/20230623-byobu/byobu.png]]
24
25*** Keybindings
26
27You can open the help menu with either of the following commands; they
28will both open the same manpage:
29
30#+begin_src sh
31byobu --help
32# or
33man byobu
34#+end_src
35
36While the manpage contains a ton of information about the functionality
37of byobu (such as status notifications, sessions, and windows), the
38first location to explore should be the keybindings section.
39
40The keybindings are configured as follows:
41
42#+begin_src txt
43byobu  keybindings  can be user defined in /usr/share/byobu/keybindings/ (or
44within .screenrc if byobu-export was used). The common key bindings are:
45
46F2 - Create a new window
47F3 - Move to previous window
48F4 - Move to next window
49F5 - Reload profile
50F6 - Detach from this session
51F7 - Enter copy/scrollback mode
52F8 - Re-title a window
53F9 - Configuration Menu
54F12 -  Lock this terminal
55shift-F2 - Split the screen horizontally
56ctrl-F2 - Split the screen vertically
57shift-F3 - Shift the focus to the previous split region
58shift-F4 - Shift the focus to the next split region
59shift-F5 - Join all splits
60ctrl-F6 - Remove this split
61ctrl-F5 - Reconnect GPG and SSH sockets
62shift-F6 - Detach, but do not logout
63alt-pgup - Enter scrollback mode
64alt-pgdn - Enter scrollback mode
65Ctrl-a $ - show detailed status
66Ctrl-a R - Reload profile
67Ctrl-a ! - Toggle key bindings on and off
68Ctrl-a k - Kill the current window
69Ctrl-a ~ - Save the current window's scrollback buffer
70#+end_src