mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-12-29 16:52:31 +08:00

* fix: Update tmux plugin to use modern terminfo.

* doc: Update documentation for tmux plugin.

2020-01-31 01:32:53 +01:00

tmux

This plugin provides aliases for tmux, the terminal multiplexer. To use it add tmux to the plugins array in your zshrc file.

plugins=(... tmux)

The plugin also supports the following -

determines if tmux is installed or not, if not, prompts user to install tmux
determines if the terminal supports the 256 colors or not, sets the appropriate configuration variable
sets the correct local config file to use

Aliases

Alias	Command	Description
`ta`	tmux attach -t	Attach new tmux session to already running named session
`tad`	tmux attach -d -t	Detach named tmux session
`ts`	tmux new-session -s	Create a new named tmux session
`tl`	tmux list-sessions	Displays a list of running tmux sessions
`tksv`	tmux kill-server	Terminate all running tmux sessions
`tkss`	tmux kill-session -t	Terminate named running tmux session
`tmux`	`_zsh_tmux_plugin_run`	Start a new tmux session

Variable	Description
`ZSH_TMUX_AUTOSTART`	Automatically starts tmux (default: `false`)
`ZSH_TMUX_AUTOSTART_ONCE`	Autostart only if tmux hasn't been started previously (default: `true`)
`ZSH_TMUX_AUTOCONNECT`	Automatically connect to a previous session if it exits (default: `true`)
`ZSH_TMUX_AUTOQUIT`	Automatically closes terminal once tmux exits (default: `ZSH_TMUX_AUTOSTART`)
`ZSH_TMUX_FIXTERM`	Sets `$TERM` to 256-color term or not based on current terminal support
`ZSH_TMUX_ITERM2`	Sets the `-CC` option for iTerm2 tmux integration (default: `false`)
`ZSH_TMUX_FIXTERM_WITHOUT_256COLOR`	`$TERM` to use for non 256-color terminals (default: `tmux`)
`ZSH_TMUX_FIXTERM_WITH_256COLOR`	`$TERM` to use for 256-color terminals (default: `tmux-256color`
`ZSH_TMUX_CONFIG`	Set the configuration path (default: `$HOME/.tmux.conf`)
`ZSH_TMUX_UNICODE`	Set `tmux -u` option to support unicode