Code Yarns ‍👨‍💻
Tech BlogPersonal Blog

Byobu keyboard shortcut not working

📅 2016-Feb-22 ⬩ ✍️ Ashwin Nanjappa ⬩ 🏷️ byobu, keyboard shortcut ⬩ 📚 Archive


Byobu has support for a long list of keyboard shortcuts. The full list of keybindings can be found listed in /usr/share/byobu/keybindings/f-keys.tmux. However, you may find that one or more of those do not work. For example, I found that pressing Shift+F1 to view help and pressing Ctrl+F2 to do a horizontal split did not work.


There are many reasons why Byobu is not receiving or failing on executing the hotkey you are pressing.

One possibility is that your desktop environment, window manager or terminal program is already using that keyboard shortcut. You will need to disable those keyboard shortcuts for it to work in Byobu. This was how I got Ctrl+F2 working in Byobu.

Here are some places where you can check:

Another possibility is that Byobu is receiving the keybinding you pressed, but it is executing a shell command that is failing.

This was the case for Shift-F1 to fail, the culprit was my Fish shell. The command executed by this hotkey can be seen in /usr/share/byobu/keybindings/f-keys.tmux. It is executing a command that will work only in Sh or Bash.

To override this, I created a ~/.byobu/keybindings.tmux, copied the line and edited to add a sh -c prefix to it so that it used the correct shell.

Tried with: Byobu 5.74 and Ubuntu 14.04