Tmux Plugin Manager
Go to file
Bruno Sutic a99d8b8f7e Merge pull request #14 from majutsushi/globfix
Fix unexpanded glob case
2014-11-19 14:31:44 +01:00
scripts Fix unexpanded glob case 2014-11-19 11:12:10 +13:00
tests Add tests for updating plugins 2014-08-05 21:44:43 +02:00
.gitignore First version of tests 2014-07-17 20:36:54 +02:00 Manually expand tilde and $HOME in TMUX_SHARED_MANAGER_PATH 2014-10-25 15:45:04 +02:00 Change github organization for this and other plugins 2014-07-28 16:04:11 +02:00 Add README and license 2014-05-19 11:43:00 +02:00 Document more advanced features 2014-10-17 23:16:02 +02:00
Vagrantfile Change testing directory structure 2014-07-17 22:55:42 +02:00
run-tests Change testing directory structure 2014-07-17 22:55:42 +02:00
tpm U key binding shows a list of installed plugins 2014-08-05 18:45:59 +02:00 Change testing directory structure 2014-07-17 22:55:42 +02:00

Tmux Plugin Manager

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


Requirements: vagrant

To run a test suite:

$ ./run-tests