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

39 lines
1.3 KiB
Markdown

# fmux
**F**unction-key enabled terminal **MU**ltiple**X**er 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:
<code>ln -s /home/$USER/fmux/tmux.conf /home/$USER/.tmux.conf</code>
If your tmux version is 2.9 or greater, use `tmux-2.9.conf` instead. Version 2.9 introduced some [breaking changes](https://github.com/tmux/tmux/issues/1689) to the style formatting.
3. Start a new tmux session, or reload the configuration file in existing session(s).