cmc/cleberg.net

 1#+date:        [2023-06-23 Fri 00:00:00]
 2#+title:       Byobu: tmux with Less Configuration Overhead
 3#+description: Using Byobu as a tmux wrapper with sane defaults out of the box.
 4#+slug:        byobu
 5#+filetags:    :linux:self-hosting:
 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#+attr_html: :alt The Byobu multiplexer with both nano and eww opened.
24[[https://img.cleberg.net/blog/20230623-byobu/byobu.webp]]
25
26*** Keybindings
27
28You can open the help menu with either of the following commands; they
29will both open the same manpage:
30
31#+begin_src sh
32byobu --help
33# or
34man byobu
35#+end_src
36
37While the manpage contains a ton of information about the functionality
38of byobu (such as status notifications, sessions, and windows), the
39first location to explore should be the keybindings section.
40
41The keybindings are configured as follows:
42
43#+begin_src txt
44byobu  keybindings  can be user defined in /usr/share/byobu/keybindings/ (or
45within .screenrc if byobu-export was used). The common key bindings are:
46
47F2 - Create a new window
48F3 - Move to previous window
49F4 - Move to next window
50F5 - Reload profile
51F6 - Detach from this session
52F7 - Enter copy/scrollback mode
53F8 - Re-title a window
54F9 - Configuration Menu
55F12 -  Lock this terminal
56shift-F2 - Split the screen horizontally
57ctrl-F2 - Split the screen vertically
58shift-F3 - Shift the focus to the previous split region
59shift-F4 - Shift the focus to the next split region
60shift-F5 - Join all splits
61ctrl-F6 - Remove this split
62ctrl-F5 - Reconnect GPG and SSH sockets
63shift-F6 - Detach, but do not logout
64alt-pgup - Enter scrollback mode
65alt-pgdn - Enter scrollback mode
66Ctrl-a $ - show detailed status
67Ctrl-a R - Reload profile
68Ctrl-a ! - Toggle key bindings on and off
69Ctrl-a k - Kill the current window
70Ctrl-a ~ - Save the current window's scrollback buffer
71#+end_src