Customization/ohmyzsh
1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-12-26 14:21:58 +00:00
Code Releases Activity
ohmyzsh/plugins/tmux
History
张天泽 2c62584b83
fix(tmux): use full offset parameter (#12249)
2024-03-02 09:12:34 +01:00
..
README.md feat(tmux): prioritize tmux terminfo (#12243) 2024-02-28 10:52:09 +01:00
tmux.extra.conf tmux: fix bad tmux config syntax and logical expression error in 86b39cf (#8374) 2019-11-14 13:34:02 +01:00
tmux.only.conf Adding helper tmux config files to tmux plugin. 2013-02-26 22:29:26 -05:00
tmux.plugin.zsh fix(tmux): use full offset parameter (#12249) 2024-03-02 09:12:34 +01:00

README.md

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
tds _tmux_directory_session Creates or attaches to a session for the current path
tkss tmux kill-session -t Terminate named running tmux session
tksv tmux kill-server Terminate all running tmux sessions
tl tmux list-sessions Displays a list of running tmux sessions
tmux _zsh_tmux_plugin_run Start a new tmux session
tmuxconf $EDITOR $ZSH_TMUX_CONFIG Open .tmux.conf file with an editor
ts tmux new-session -s Create a new named tmux session

Configuration Variables

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_CONFIG Set the configuration path (default: $HOME/.tmux.conf, $XDG_CONFIG_HOME/tmux/tmux.conf)
ZSH_TMUX_DEFAULT_SESSION_NAME Set tmux default session name when autostart is enabled
ZSH_TMUX_DETACHED Set the detached mode (default: false)
ZSH_TMUX_FIXTERM Sets $TERM to 256-color term or not based on current terminal support
ZSH_TMUX_FIXTERM_WITHOUT_256COLOR $TERM to use for non 256-color terminals (default: tmux if available, screen otherwise)
ZSH_TMUX_FIXTERM_WITH_256COLOR $TERM to use for 256-color terminals (default: tmux-256color if available, screen-256color otherwise)
ZSH_TMUX_ITERM2 Sets the -CC option for iTerm2 tmux integration (default: false)
ZSH_TMUX_UNICODE Set tmux -u option to support unicode