Installation

With package managers:

On Debian based distros:

$ wget https://github.com/greymd/tmux-xpanes/releases/download/v4.1.3/tmux-xpanes_v4.1.3.deb
$ sudo apt install tmux
$ sudo dpkg -i tmux-xpanes_v4.1.3.deb

On Ubuntu:

# Install `add-apt-repository` command, if necessary.
$ sudo apt install software-properties-common

$ sudo add-apt-repository ppa:greymd/tmux-xpanes
$ sudo apt update
$ sudo apt install tmux-xpanes

Add PPA repository and install with apt command. Supported Ubuntu version is here.

On macOS with Homebrew:

$ brew install tmux-xpanes

With yum (CentOS7, RHEL7, Amazon Linux AMI, Amazon Linux 2):

$ sudo yum install https://github.com/greymd/tmux-xpanes/releases/download/v4.1.3/tmux-xpanes_v4.1.3.rpm

With dnf (Fedora 30/31, RHEL8, CentOS8)

## RHEL8, CentOS8 users may need to enable EPEL8.
$ sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

$ sudo dnf install xpanes

On Arch Linux based distros:

$ yay tmux-xpanes

Please install base-devel with pacman --sync --refresh base-devel if necessary. The package is registered to AUR.

On Gentoo based distros:

$ emerge --ask tmux-xpanes

Package is here. Execute echo 'ACCEPT_KEYWORDS="~amd64"' >> /etc/portage/make.conf, if necessary.

With Zsh plugin managers:

Attention: With this way, tmux have to be installed manually.

If you are using Zsh plugin managers, edit .zshrc. After the plugin is enabled, zsh completion for xpanes command is activated as well.

zplug

Add this line to ~/.zshrc.

zplug "greymd/tmux-xpanes"

Antigen

Add this line to ~/.zshrc.

antigen bundle "greymd/tmux-xpanes"

Installing Zsh completion

Completion for xpanes command is available. If you use Zsh usually, it is highly recommended way. Not only suggesting command line options, but also it suggests the possible arguments followed by the options and possible host names from ~/.ssh/config when --ssh option is typed.

The completion feature is already activated with the above installation ways for Zsh plugin managers. If you do not choose any above ways however, please follow the following instructions.

# Clone the repository
$ git clone https://github.com/greymd/tmux-xpanes.git /path/to/tmux-xpanes

And add such the line to ~/.zshrc.

source /path/to/tmux-xpanes/completion.zsh

Manual Installation

Attention: With this way, tmux have to be installed manually.

If you cannot choose any above ways, execute following commands. Clone the source code.

$ git clone https://github.com/greymd/tmux-xpanes.git /path/to/tmux-xpanes

Add this line to ~/.bashrc.

source /path/to/tmux-xpanes/activate.sh

Installing without messing up PATH

Attention: With this way, tmux have to be installed manually.

xpanes command is portable command. Even if PATH does not include xpanes file, it works.

# Download from Github
$ wget https://raw.githubusercontent.com/greymd/tmux-xpanes/v4.1.3/bin/xpanes -O ./xpanes

# Let it be executable.
$ chmod +x ./xpanes

# Execute
$ ./xpanes ARG1 ARG2 ARG3 ...