psi-jack
/
tpm
mirror of https://github.com/tmux-plugins/tpm
1
0
Fork 0
Code Issues Releases Wiki Activity
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.
103 Commits
4 Branches
10 Tags
490 KiB
 
Tag: Branch: Tree: 40ba8e58dc
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '40ba8e58dc'
${ noResults }
Bruno Sutic 40ba8e58dc
Enable installing plugins via cli executable 		8 years ago
bin Enable installing plugins via cli executable 8 years ago
bindings Enable installing plugins via cli executable 8 years ago
docs Move all the docs to `docs/` dir 8 years ago
scripts Enable installing plugins via cli executable 8 years ago
tests Use new plugin syntax all around 8 years ago
.gitignore First version of tests 9 years ago
.travis.yml Add travis.yml 9 years ago
CHANGELOG.md Move all the docs to `docs/` dir 8 years ago
HOW_TO_PLUGIN.md Move to a directory 8 years ago
LICENSE.md Add README and license 9 years ago
README.md Update readme 8 years ago
Vagrantfile Change testing directory structure 9 years ago
run-tests Refactor the tests for travis 9 years ago
tpm Enable installing plugins via cli executable 8 years ago
vagrant_provisioning.sh Change testing directory structure 9 years ago

README.md

Tmux Plugin Manager

Build Status

Installs and loads TMUX plugins.

Installation

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

Clone TPM:

$ git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

Put this at the bottom of .tmux.conf:

# 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 'git@github.com/user/plugin'
# set -g @plugin 'git@bitbucket.com/user/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
$ tmux source ~/.tmux.conf

That's it!

(Note: using set -g @tpm_plugins is deprecated, but still works alongside new syntax)

Installing plugins

  1. add new plugin to .tmux.conf with set -g @plugin '...'
  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 (or comment out) plugin from the list
  2. hit prefix + alt + u (u as in uinstall) 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 repo
  • refreshes TMUX environment

prefix + U

  • updates plugin(s)

prefix + alt + u

  • uninstall plugins that are not on the plugin list

More plugins

For more plugins, check here.

Docs

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

Tests

Tests for this project 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.

License

MIT