psi-jack/tpm
1
0
Fork 0
mirror of synced 2024-11-16 14:35:36 -05:00
Code Issues Releases Wiki Activity
Tmux Plugin Manager
216 commits 4 branches 10 tags 493 KiB
Shell 100%
Find a file
Geoffrey van Wyk d615aa526e fix(cli,install): authenticity of host 'github.com' can't be established 
This occurs because the URL used to connect to GitHub is for SSH. This is not necessary. HTTPS is enough.
This causes the `install_plugins` command to hang when used noninteractively on automation platforms such
as GitHub Actions or Ansible.

Resolves #219
2024-04-17 06:32:34 +02:00
bin Enable removing plugins via CLI executable 2015-08-03 00:33:38 +02:00
bindings Move all helpers to 'helpers/' dir 2015-08-03 17:56:45 +02:00
docs prepend > prefix 2023-02-26 19:21:30 +00:00
lib New tmux-test version 2015-08-04 17:03:12 +02:00
scripts fix(cli,install): authenticity of host 'github.com' can't be established 2024-04-17 06:32:34 +02:00
tests Test for 'set-option' plugin definition 2015-10-08 01:24:08 +02:00
.gitattributes Force LF eol with .gitattributes 2015-09-20 01:55:42 +02:00
.gitignore Switch to using tmux-test framework 2015-08-01 22:19:06 +02:00
.gitmodules Switch to using tmux-test framework 2015-08-01 22:19:06 +02:00
.travis.yml Upgrade to tmux-test version that installs tmux 2.0 2015-08-04 14:46:11 +02:00
CHANGELOG.md v3.1.0 2023-01-03 21:07:40 +01:00
HOW_TO_PLUGIN.md Move to a directory 2015-07-10 17:05:09 +02:00
LICENSE.md Add README and license 2014-05-19 11:43:00 +02:00
README.md Updated README and removed $ symbol 2022-06-20 16:44:53 +05:30
tpm Use XDG-compatible plugin path when available 2020-08-31 11:32:07 +02:00

README.md

Tmux Plugin Manager

Build Status

Installs and loads tmux plugins.

Tested and working on Linux, OSX, and Cygwin.

See list of plugins here.

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 ($XDG_CONFIG_HOME/tmux/tmux.conf works too):

# 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 'github_username/plugin_name#branch'
# 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

Docs

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

Tests

Tests for this project run on Travis CI.

When run locally, vagrant is required. Run tests with:

# within project directory
./run_tests

License

MIT