tmuxrc

tmuxrc is a collection of RUNCOM & Plugins dedicated to the terminal multiplexer Tmux.

• I use this configuration with my custom bash environment to always work in Tmux locally and in SSH sessions.

---

Features

• Plugins (included as submodules):
  • tpm: Plugin Manager.
  • tmux-prefix-highlight: highlights when you press tmux prefix key.
  • tmux-menus: Popup menus.
  • extrakto: select, copy/insert/complete text without a mouse (prefix Tab).
  • tmux-sidebar: directory tree for the current path.
• Prefix rebinded to Ctrl+x (Ctrl+w for remote/ssh sessions).
• Toggle Sync mode for visible panes with Prefix-a.
• Toggle Zoom current Pane with Prefix-Z. Next & Previous: Prefix-e,Prefix-z.
• Open a popup session changer with Prefix-Ctrl+j.
• Open a popup Scratch session with Prefix-Ctrl+g.
• Nice status (display current command) & color theme with true colors.
• Compatible with my environment config: bashrc.
• Check more in the conf file …

Requirements

• Tmux 3.3+:
  • libevent 2.x (apt or build)
  • ncurses (apt or build)
• Gitmux
• Fzf 0.35+ for fzf-tmux
• exa for the tmux-sidebar: sudo apt install exa

Recommended

• bash 5+
• bash_completion
• My environment config: bashrc

Installation

Tmux

• With APT:

# check version and repository with apt
sudo apt show -a tmux 2> /dev/null | grep -E 'Version:|APT-Sources:'

# if your apt repositories deliver at least 3.3, you can install it
sudo apt install tmux
# or if there is a specific repository
sudo apt -t repo-backports install tmux

• Or build & install:

mkdir -p $HOME/Builds && cd $HOME/Builds
wget https://github.com/tmux/tmux/releases/download/3.3a/tmux-3.3a.tar.gz
tar -zxf tmux-*.tar.gz
cd tmux-*/
./configure
make && sudo make install

Gitmux

• Copy it manually to /usr/local/bin: https://github.com/arl/gitmux/releases

• Or you need jq to parse the latest release in cli:

# for linux_amd64
sudo apt install jq
_RELEASES=$(curl -s https://api.github.com/repos/arl/gitmux/releases/latest)
_URL=$(echo "$_RELEASES" | jq -r '.assets[] | select( .name | match("linux_amd64")) | .browser_download_url')
wget -c -nv "$_URL" -O - | sudo tar --no-same-owner -xzv -C /usr/local/bin gitmux

Fzf

• With APT:

# check version and repository with apt
sudo apt show -a fzf 2> /dev/null | grep -E 'Version:|APT-Sources:'

# if your apt repositories deliver at least 0.35, you can install it
sudo apt install fzf
# or if there is a specific repository
sudo apt -t repo-backports install fzf

• Or build & install:

mkdir -p $HOME/Builds && cd $HOME/Builds
git clone --depth 1 https://github.com/junegunn/fzf.git
cd fzf
sudo ./install --all --no-bash --no-zsh --no-fish
sudo cp shell/completion.bash /etc/bash_completion.d/fzf
sudo cp bin/* /usr/local/bin/

tmuxrc

# backup current files
mkdir -p $HOME/.backups
cp -r --backup=t {"$HOME"/.tmux/,"$HOME"/.tmux.conf,"$HOME"/.config/tmux/} $HOME/.backups/
rm -Rf "$HOME"/.tmux/ "$HOME"/.tmux.conf "$HOME"/.config/tmux/

# install
mkdir -p $HOME/.config
cd $HOME/.config
git clone --depth=1 --recurse-submodules https://git.tkapias.net/tkapias/tmuxrc tmux
cp tmux/gitmux.conf $HOME/.config/

Configuration

TERM name, true color and osc 52 copy

You may need to modify the name of your $TERM in the "terminal-features" & "terminal-overrides" inside tmux.conf.

Your terminal need features related to 256 or true colors and OSC 52 copy.

URxvt - Rxvt-unicode

Urxvt is an old terminal but it is currently my favorite due to the amount of customizations available and it's performance.

By default it can not perform OSC 52 or display some font icons. Please refer to my other repository urxvtrc.

SSH/Remote

If you install this configuration on a remote system, you will need another prefix than on the local tmux (ctrl+x).

You can change the prefix to ctrl+w on the remote system like this:

sed -i -e 's/C-x/C-w/g' -e 's/Ctrl-x/Ctrl-w/g' $HOME/.config/tmux/tmux.conf

---