lew
6e896e6d8e
Add .tmux/plugins/tpm/HOW_TO_PLUGIN.md Add .tmux/plugins/tpm/LICENSE.md Add .tmux/plugins/tpm/README.md Add .tmux/plugins/tpm/bin/clean_plugins Add .tmux/plugins/tpm/bin/install_plugins Add .tmux/plugins/tpm/bin/update_plugins Add .tmux/plugins/tpm/bindings/clean_plugins Add .tmux/plugins/tpm/bindings/install_plugins Add .tmux/plugins/tpm/bindings/update_plugins Add .tmux/plugins/tpm/docs/automatic_tpm_installation.md Add .tmux/plugins/tpm/docs/changing_plugins_install_dir.md Add .tmux/plugins/tpm/docs/how_to_create_plugin.md Add .tmux/plugins/tpm/docs/managing_plugins_via_cmd_line.md Add .tmux/plugins/tpm/docs/tpm_not_working.md Add .tmux/plugins/tpm/.git/HEAD Add .tmux/plugins/tpm/.git/config Add .tmux/plugins/tpm/.git/description Add .tmux/plugins/tpm/.git/hooks/applypatch-msg.sample Add .tmux/plugins/tpm/.git/hooks/commit-msg.sample Add .tmux/plugins/tpm/.git/hooks/fsmonitor-watchman.sample Add .tmux/plugins/tpm/.git/hooks/post-update.sample Add .tmux/plugins/tpm/.git/hooks/pre-applypatch.sample Add .tmux/plugins/tpm/.git/hooks/pre-commit.sample Add .tmux/plugins/tpm/.git/hooks/pre-merge-commit.sample Add .tmux/plugins/tpm/.git/hooks/pre-push.sample Add .tmux/plugins/tpm/.git/hooks/pre-rebase.sample Add .tmux/plugins/tpm/.git/hooks/pre-receive.sample Add .tmux/plugins/tpm/.git/hooks/prepare-commit-msg.sample Add .tmux/plugins/tpm/.git/hooks/push-to-checkout.sample Add .tmux/plugins/tpm/.git/hooks/sendemail-validate.sample Add .tmux/plugins/tpm/.git/hooks/update.sample Add .tmux/plugins/tpm/.git/index Add .tmux/plugins/tpm/.git/info/exclude Add .tmux/plugins/tpm/.git/logs/HEAD Add .tmux/plugins/tpm/.git/logs/refs/heads/master Add .tmux/plugins/tpm/.git/logs/refs/remotes/origin/HEAD Add .tmux/plugins/tpm/.git/objects/info/.keep Add .tmux/plugins/tpm/.git/objects/pack/pack-1f8e91c4b0c2fd3de85deb1de59db344d5af0319.idx Add .tmux/plugins/tpm/.git/objects/pack/pack-1f8e91c4b0c2fd3de85deb1de59db344d5af0319.pack Add .tmux/plugins/tpm/.git/objects/pack/pack-1f8e91c4b0c2fd3de85deb1de59db344d5af0319.rev Add .tmux/plugins/tpm/.git/packed-refs Add .tmux/plugins/tpm/.git/refs/heads/master Add .tmux/plugins/tpm/.git/refs/remotes/origin/HEAD Add .tmux/plugins/tpm/.git/refs/tags/.keep Add .tmux/plugins/tpm/.gitattributes Add .tmux/plugins/tpm/.gitignore Add .tmux/plugins/tpm/.gitmodules Add .tmux/plugins/tpm/.travis.yml Add .tmux/plugins/tpm/tpm Add .tmux/plugins/tpm/lib/tmux-test/.keep Add .tmux/plugins/tpm/scripts/check_tmux_version.sh Add .tmux/plugins/tpm/scripts/clean_plugins.sh Add .tmux/plugins/tpm/scripts/install_plugins.sh Add .tmux/plugins/tpm/scripts/source_plugins.sh Add .tmux/plugins/tpm/scripts/update_plugin.sh Add .tmux/plugins/tpm/scripts/update_plugin_prompt_handler.sh Add .tmux/plugins/tpm/scripts/helpers/plugin_functions.sh Add .tmux/plugins/tpm/scripts/helpers/shell_echo_functions.sh Add .tmux/plugins/tpm/scripts/helpers/tmux_echo_functions.sh Add .tmux/plugins/tpm/scripts/helpers/tmux_utils.sh Add .tmux/plugins/tpm/scripts/helpers/utility.sh Add .tmux/plugins/tpm/scripts/variables.sh Add .tmux/plugins/tpm/tests/expect_failed_plugin_download Add .tmux/plugins/tpm/tests/expect_successful_clean_plugins Add .tmux/plugins/tpm/tests/expect_successful_multiple_plugins_download Add .tmux/plugins/tpm/tests/expect_successful_plugin_download Add .tmux/plugins/tpm/tests/expect_successful_update_of_a_single_plugin Add .tmux/plugins/tpm/tests/expect_successful_update_of_all_plugins Add .tmux/plugins/tpm/tests/test_plugin_clean.sh Add .tmux/plugins/tpm/tests/test_plugin_installation.sh Add .tmux/plugins/tpm/tests/test_plugin_installation_legacy.sh Add .tmux/plugins/tpm/tests/test_plugin_sourcing.sh Add .tmux/plugins/tpm/tests/test_plugin_update.sh Add .tmux/plugins/tpm/tests/helpers/tpm.sh
101 lines
2.6 KiB
Markdown
101 lines
2.6 KiB
Markdown
# Tmux Plugin Manager
|
|
|
|
[](https://travis-ci.org/tmux-plugins/tpm)
|
|
|
|
Installs and loads `tmux` plugins.
|
|
|
|
Tested and working on Linux, OSX, and Cygwin.
|
|
|
|
See list of plugins [here](https://github.com/tmux-plugins/list).
|
|
|
|
### Installation
|
|
|
|
Requirements: `tmux` version 1.9 (or higher), `git`, `bash`.
|
|
|
|
Clone TPM:
|
|
|
|
```bash
|
|
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):
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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` + <kbd>I</kbd> (capital i, as in **I**nstall) 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` + <kbd>alt</kbd> + <kbd>u</kbd> (lowercase u as in **u**ninstall) 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` + <kbd>I</kbd>
|
|
- Installs new plugins from GitHub or any other git repository
|
|
- Refreshes TMUX environment
|
|
|
|
`prefix` + <kbd>U</kbd>
|
|
- updates plugin(s)
|
|
|
|
`prefix` + <kbd>alt</kbd> + <kbd>u</kbd>
|
|
- remove/uninstall plugins not on the plugin list
|
|
|
|
### Docs
|
|
|
|
- [Help, tpm not working](docs/tpm_not_working.md) - problem solutions
|
|
|
|
More advanced features and instructions, regular users probably do not need
|
|
this:
|
|
|
|
- [How to create a plugin](docs/how_to_create_plugin.md). It's easy.
|
|
- [Managing plugins via the command line](docs/managing_plugins_via_cmd_line.md)
|
|
- [Changing plugins install dir](docs/changing_plugins_install_dir.md)
|
|
- [Automatic TPM installation on a new machine](docs/automatic_tpm_installation.md)
|
|
|
|
### Tests
|
|
|
|
Tests for this project run on [Travis CI](https://travis-ci.org/tmux-plugins/tpm).
|
|
|
|
When run locally, [vagrant](https://www.vagrantup.com/) is required.
|
|
Run tests with:
|
|
|
|
```bash
|
|
# within project directory
|
|
./run_tests
|
|
```
|
|
|
|
### License
|
|
|
|
[MIT](LICENSE.md)
|