selectric/fmux
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
fmux/README.md
Lloyd W. Slade 6eee93e0e9 changed default branch, updated readme
2021-08-10 15:24:45 -04:00

2.3 KiB
Raw Permalink Blame History

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.

Important Notice

This README, as well as the various versions for different versions of tmux, are currently a shambles. I'm hoping to fix it up soon, but you might notice some irregularities.

Key bindings

Function keys

These keys work without the tmux prefix (Ctrl-B by default).

  • 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 tmux prefix

  • |: Split window horizontally
  • -: Split window vertically
  • Shift-W/A/S/D: Resize current pane
  • r: Reload config from ~/.tmux.conf
  • Alt-Left or Right arrows: Move window left or right, repsectively

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

Local configuration options

This configuration file sources ~/.tmux-local.conf if you want to make additional modifications.

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 below, use tmux-2.9.conf instead. Version 3.0 introduced several changes in configuration file parsing. (tmux 2.9 also introduced some changes to the style formatting, but they do not break functionality. I do hope to fix this soon.)

  3. Run touch ~/.tmux-local.conf.

  4. Start a new tmux session, or reload the configuration file in existing session(s).

Errata

Most of my work on this repository is done on my personal Git server. It may take some time for updates to be pushed from there to GitHub or other locations.