pentest-distro-builder/filesystem/root/.tmux/plugins/tpm
Kaj Forney 582f5b5f5c Add autologin and custom tmux config.
Former-commit-id: 09eacc3f3f761c2b3454d20356ba085d18bdb722
Former-commit-id: 89d8a1302bd2a72239fbe9ad9820be4ecda76cab
2018-09-27 17:40:01 -06:00
..
bin Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
bindings Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
docs Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
scripts Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
tests Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
.travis.yml Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
CHANGELOG.md Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
HOW_TO_PLUGIN.md Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
LICENSE.md Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
README.md Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00
tpm Add autologin and custom tmux config. 2018-09-27 17:40:01 -06:00

Tmux Plugin Manager

Build Status

Installs and loads TMUX plugins.

Tested and working on Linux, OSX, and Cygwin.

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 if tmux is already running
$ tmux source ~/.tmux.conf

That's it!

Installing plugins

  1. Add new plugin to ~/.tmux.conf with set -g @plugin '...'
  2. Press prefix + I (capital 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. Press prefix + alt + u (lowercase u as in uninstall) 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 repository
  • Refreshes TMUX environment

prefix + U

  • updates plugin(s)

prefix + alt + u

  • remove/uninstall plugins 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