Helper to use vim/neovim as a terminal multiplexer

Demo video:

install

Add and install the following vim plugin:

Plug 'yazgoo/vmux'

Then build vmux

cd ~/.config/nvim/plugged/vmux
cargo build --release

Then add the following to your .zshrc or .bashrc

source ~/.config/nvim/plugged/vmux/plugin/setup_vmux.sh

Or if you want to use vim instead of nvim (you need vim compiled with +clientserver flag) :

source ~/.config/nvim/plugged/vmux/plugin/setup_vmux.sh vim

usage

Run vmux for vmux command usage help Run :help vmux from within vim for more in depth help.

detaching

You can detach from the session with ^g

After detaching / or quitting vim, you will be prompted, via sk to:

• switch session
• create a new session
• exit

customizing

session name

You can define a custom way to setup a new session via ~/.config/vmux/hooks/session_name.sh The script just needs to print environment variables of the form:

key=value

it takes the session name as argument.

For example, this script will print the content of envrc and set working directory to ~/dev/$1

mydir=$HOME/dev/"$1"
[ -e "$mydir"/.envrc ] && cat "$mydir"/.envrc
echo PWD="$mydir"

list sessions names

You can define a list of new session names via ~/.config/vmux/hooks/list_sessions_names.sh The script just needs to output session names one by line.

For example, this script will list all directories names in ~/dev

find -L ~/dev -maxdepth 1 -type d | while read d; do basename $d; done

wallpaper

You can put images which will be used as wallpapers inside ~/.config/vmux/wallpapers/.

tabbar

Having a nice tabbar (based on Caagr98/c98tabbar.vim):

Plug 'git@github.com:yazgoo/c98tabbar.vim'
Plug 'yazgoo/vmux-c98tabbar'

Leave terminal insert mode by typing escap twice:

tnoremap <Esc><Esc> <C-\><C-n>

detailed setup notes

docker run -it --entrypoint bash rust apt update apt install neovim install vim-plug sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'

mkdir ~/.config/nvim

edit init.vim

carrog insall updtae Updating crates.io index

call plug#begin() Plug 'yazgoo/vmux', {'do': 'cargo install vmux' } call plug#end()

ln -s ~/.local/share/nvim/plugged/vmux/target/release/vmux /usr/bin/