Tmux Plugin Manager

Installs and loads TMUX plugins.

Installation

Requirements: git

Clone TPM:

$ git clone https://github.com/bruno-/tpm ~/.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 "              \
  bruno-/tpm                       \
  bruno-/tmux_pain_control         \
"
# Other examples:
# github_username/plugin_name    \
# git@github.com/user/plugin     \
# git@bitbucket.com/user/plugin  \

# initializes TMUX plugin manager
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

add a new plugin to the @tpm_plugins list
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.

Key bindings

TPM provides only 1 key binding: prefix + I. Here's what it does:

clones new plugins from github or any other git repo
pulls updates for already installed plugins
refreshes TMUX environment

After you press prefix + I, everything should be up to date.

List of plugins

List of plugins.

If you create a plugin, feel free to create a pull request that adds it to the list.

Creating plugins

How to create a plugin. It's easy.

About

Truth be told, there aren't too many TMUX plugins out there. People mostly just copy code snippets from each others' .tmux.conf files.

I hope TMUX plugin manager (TPM) inspires people to do better and more creative things with TMUX. See below for instructions how to create your own plugin.

License

MIT

1.8 KiB Raw Blame History