Tmux Plugin Manager
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Bruno Sutic 693e5a2a0f
Style fix
2 years ago
bin Enable removing plugins via CLI executable 8 years ago
bindings Move all helpers to 'helpers/' dir 8 years ago
docs Explain XDG-compatible plugin path in docs 3 years ago
lib New tmux-test version 8 years ago
scripts Style fix 2 years ago
tests Test for 'set-option' plugin definition 8 years ago
.gitattributes Force `LF` eol with .gitattributes 8 years ago
.gitignore Switch to using `tmux-test` framework 8 years ago
.gitmodules Switch to using `tmux-test` framework 8 years ago
.travis.yml Upgrade to tmux-test version that installs tmux 2.0 8 years ago correct spelling mistake 6 years ago Move to a directory 8 years ago Add README and license 9 years ago Merge branch 'master' into add-branch-to-plugin 2 years ago
tpm Use XDG-compatible plugin path when available 3 years ago

Tmux Plugin Manager

Build Status

Installs and loads tmux plugins.

Tested and working on Linux, OSX, and Cygwin.

See list of plugins here.


Requirements: tmux version 1.9 (or higher), git, bash.

Clone TPM:

$ git clone ~/.tmux/plugins/tpm

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

# 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 'github_username/plugin_name#branch'
# set -g @plugin ''
# set -g @plugin ''

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

Reload TMUX environment so TPM is sourced:

# type this in terminal if tmux is already running
$ tmux source ~/.tmux.conf

That's it!

Installing 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.

You're good to go! The plugin was cloned to ~/.tmux/plugins/ dir and sourced.

Uninstalling plugins

  1. Remove (or comment out) plugin 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

  • Installs new plugins from GitHub or any other git repository
  • Refreshes TMUX environment

prefix + U

  • updates plugin(s)

prefix + alt + u

  • remove/uninstall plugins not on the plugin list


More advanced features and instructions, regular users probably do not need this:


Tests for this project run on Travis CI.

When run locally, vagrant is required. Run tests with:

# within project directory
$ ./run_tests