Skip to content

Brijen/tpm

Repository files navigation

Tmux Plugin Manager

Installs and loads TMUX plugins.

Installation

Requirements: tmux version 1.9 (or higher), 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    \
# [email protected]/user/plugin     \
# [email protected]/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

  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.

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

  • pain control - useful standard bindings for controlling panes
  • goto session - faster session switching
  • battery osx - battery status for OSX in Tmux status-right
  • logging - easy logging and screen capturing
  • online status - online status indicator in Tmux status-right. Useful when on flaky connection to see if you're online.

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.

Tests

Requirements: vagrant

Running the test suite:

$ ./run-tests

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.

License

MIT

About

Tmux Plugin Manager

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%