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.
Javier Lopez 7a2614d850 change default uninstall/clean keybinding to prefix + alt +u 8 years ago
scripts change default uninstall/clean keybinding to prefix + alt +u 8 years ago
tests change default uninstall/clean keybinding to prefix + alt +u 8 years ago
.gitignore First version of tests 9 years ago
.travis.yml Add travis.yml 9 years ago Start using C-c to clear the screen 9 years ago Change github organization for this and other plugins 9 years ago Add README and license 10 years ago Update readme with other goodies and twitter link 9 years ago
Vagrantfile Change testing directory structure 9 years ago
run-tests Refactor the tests for travis 9 years ago
tpm add removal procedure 8 years ago Change testing directory structure 9 years ago

Tmux Plugin Manager

Build Status

Installs and loads TMUX plugins.


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

Clone TPM:

$ git clone ~/.tmux/plugins/tpm

Put this at the bottom of your .tmux.conf (backslashes at the end of the lines are required):

# List of plugins
# Supports `github_username/repo` or full git repo URLs
set -g @tpm_plugins '              \
  tmux-plugins/tpm                 \
  tmux-plugins/tmux-sensible       \
# Other examples:
# github_username/plugin_name    \
#     \
#  \

# Initializes TMUX plugin manager.
# Keep this line at the very bottom of tmux.conf.
run-shell '~/.tmux/plugins/tpm/tpm'

Reload TMUX environment so TPM is sourced:

# type this in terminal
$ tmux source-file ~/.tmux.conf

That's it!

Installing plugins

  1. add a new plugin to the @tpm_plugins list
  2. hit prefix + I (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 plugin from @tpm_plugins list
  2. All the plugins are installed to ~/.tmux/plugins/. Find plugin directory there and just remove it.

Key bindings

prefix + I

  • installs new plugins from github or any other git repo
  • refreshes TMUX environment

prefix + U

  • updates plugin(s)

List of plugins

For more plugins, check here.

Wiki pages

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

Creating plugins

How to create a plugin. It's easy.


Tests run on travis.

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

# within project directory
$ ./run-tests

Other goodies

  • tmux-copycat - a plugin for regex searches in tmux and fast match selection
  • tmux-yank - enables copying highlighted text to system clipboard
  • tmux-open - a plugin for quickly opening highlighted file or a url
  • tmux-continuum - automatic restoring and continuous saving of tmux env

You might want to follow @brunosutic on twitter if you want to hear about new tmux plugins or feature updates.