fmux/README.md
2019-11-07 11:41:16 -05:00

1.3 KiB

fmux

Function-key enabled terminal MUltipleXer enhancements

This project implements byobu-like function key bindings for common tmux commands, but without as much overhead as byobu. It also adds some useful status-bar widgets on the right, implemented with a bash script.

Key bindings

Function keys:

  • F2: New window
  • F3: Previous window
  • F4: Next window
  • F6: Detach session
  • Ctrl-F6: Kill pane
  • F7: Copy mode
  • F8: Rename window
  • Ctrl-F8: Rename session
  • Shift-F12: Toggle bindings on/off

Alt+arrow keys can be used to switch between panes.

With fmux prefix

  • |: Split window horizontally
  • -: Split window vertically
  • Shift-W/A/S/D: Resize current pane
  • r: Reload config from ~/.tmux.conf~

In case any of these bindings interfere with other commands, they can be temporarily toggled on or off with Shfit-F12.

Installation

  1. Clone this repository to your home folder.
  2. Establish a symbolic link from the tmux.conf file in the repository folder your home folder: ln -s /home/$USER/fmux/tmux.conf /home/$USER/.tmux.conf If your tmux version is 2.9 or greater, use tmux-2.9.conf instead. Version 2.9 introduced some breaking changes to the style formatting.
  3. Start a new tmux session, or reload the configuration file in existing session(s).