< Tmux < plugins

Tmux/plugins/tpm

Resources
GitHub

TPM (Tmux Plugin Manager) Article description::manages tmux plugins in an automated manner. It is used to install and load tmux plugins.

Important
TPM can only be downloaded via github now. Requirements: tmux version 1.9 (or higher.)

Installation

1. Clone TPM:

user $mkdir -p ~/.tmux/plugins
user $git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

2. Put this at the bottom of .tmux.conf ($XDG_CONFIG_HOME/tmux/tmux.conf works too.):

CODE Config
<syntaxhighlight lang="bash"># List of plugins
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'

# Other examples:
# set -g @plugin 'github_username/plugin_name'
# set -g @plugin 'git@github.com/user/plugin'
# set -g @plugin 'git@bitbucket.com/user/plugin'

# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)
run -b '~/.tmux/plugins/tpm/tpm'</syntaxhighlight>

3. Reload TMUX environment so TPM is sourced (if tmux is already running.):

user $tmux source ~/.tmux.conf

Usage

Note
Prefix is Ctrl + b by default.

Install plugins

  1. Add new plugin to ~/.tmux.conf with set -g @plugin '...'
  2. Press prefix + I (capital I, as in install) to fetch the plugin.

The plugin will cloned to ~/.tmux/plugins/ and sourced.

Important
TPM not config the plugin.

Uninstall plugins

  1. Remove (or comment out) plugins from the list.
  2. Press prefix + Alt + u (lowercase U as in uninstall) to remove the plugin.

All the plugins are installed to ~/.tmux/plugins/ so alternatively you can find plugin directory there and remove it.

Key bindings

  • prefix + I: Install new plugins from GitHub or any other git repository. And Refreshes TMUX environment.
  • prefix + U: Update plugins.
  • prefix + Alt + u: Remove/uninstall plugins not on the plugin list.

More plugins

For more plugins, check tmux-plugins

Removal

Remove files:

user $rm -r ~/.tmux/plugins/tpm

Then clear TPM settings in ~/.tmux.conf.

This article is issued from Gentoo. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.