tpm/README.md

114 lines
3.1 KiB
Markdown
Raw Normal View History

2014-05-19 09:17:58 +00:00
# Tmux Plugin Manager
[![Build Status](https://travis-ci.org/tmux-plugins/tpm.svg?branch=master)](https://travis-ci.org/tmux-plugins/tpm)
2014-11-19 14:58:12 +00:00
Installs and loads `tmux` plugins.
2014-05-19 09:17:58 +00:00
Tested and working on Linux, OSX, and Cygwin.
2014-05-19 09:17:58 +00:00
### Installation
2014-09-10 19:54:59 +00:00
Requirements: `tmux` version 1.9 (or higher), `git`, `bash`.
2014-05-19 09:22:16 +00:00
2014-05-19 09:17:58 +00:00
Clone TPM:
```bash
$ git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
```
2014-05-19 09:17:58 +00:00
2018-11-07 11:39:08 +00:00
Put this at the bottom of `~/.tmux.conf` (`$XDG_CONFIG_HOME/tmux/tmux.conf`
works too):
2014-05-19 09:17:58 +00:00
```bash
# List of plugins
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
2015-07-06 23:46:53 +00:00
# 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'
2014-05-19 09:17:58 +00:00
# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)
run '~/.tmux/plugins/tpm/tpm'
```
2014-05-19 09:17:58 +00:00
Reload TMUX environment so TPM is sourced:
```bash
# type this in terminal if tmux is already running
$ tmux source ~/.tmux.conf
```
2014-05-19 09:17:58 +00:00
That's it!
### Installing plugins
1. Add new plugin to `~/.tmux.conf` with `set -g @plugin '...'`
2019-02-20 14:22:35 +00:00
2. Press `prefix` + <kbd>I</kbd> (capital i, as in **I**nstall) to fetch the plugin.
2014-05-19 09:17:58 +00:00
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.
2015-06-02 19:36:35 +00:00
2015-07-06 23:46:53 +00:00
All the plugins are installed to `~/.tmux/plugins/` so alternatively you can
2015-06-02 19:36:35 +00:00
find plugin directory there and remove it.
2014-05-19 09:17:58 +00:00
### Key bindings
`prefix` + <kbd>I</kbd>
- Installs new plugins from GitHub or any other git repository
- Refreshes TMUX environment
2014-05-19 09:17:58 +00:00
`prefix` + <kbd>U</kbd>
2014-08-05 19:04:17 +00:00
- updates plugin(s)
2014-05-19 09:17:58 +00:00
`prefix` + <kbd>alt</kbd> + <kbd>u</kbd>
- remove/uninstall plugins not on the plugin list
2015-07-06 23:46:53 +00:00
### More plugins
2014-05-19 09:17:58 +00:00
2014-08-02 18:57:42 +00:00
For more plugins, check [here](https://github.com/tmux-plugins).
2014-05-21 09:14:23 +00:00
2015-07-10 15:05:09 +00:00
### Docs
2014-10-17 21:16:02 +00:00
2015-08-10 18:18:32 +00:00
- [Help, tpm not working](docs/tpm_not_working.md) - problem solutions
2015-07-10 15:05:09 +00:00
More advanced features and instructions, regular users probably do not need
this:
2014-10-17 21:16:02 +00:00
2015-07-10 15:05:09 +00:00
- [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)
2015-07-10 15:10:37 +00:00
- [Changing plugins install dir](docs/changing_plugins_install_dir.md)
2015-07-10 15:14:13 +00:00
- [Automatic TPM installation on a new machine](docs/automatic_tpm_installation.md)
2014-05-21 10:29:20 +00:00
2014-07-17 20:56:02 +00:00
### Tests
Tests for this project run on [Travis CI](https://travis-ci.org/tmux-plugins/tpm).
2014-07-17 20:56:02 +00:00
2014-11-19 14:58:12 +00:00
When run locally, [vagrant](https://www.vagrantup.com/) is required.
Run tests with:
2014-07-17 20:56:02 +00:00
```bash
# within project directory
$ ./run_tests
```
2014-07-17 20:56:02 +00:00
### Other goodies
- [tmux-copycat](https://github.com/tmux-plugins/tmux-copycat) - a plugin for
regex searches in tmux and fast match selection
- [tmux-yank](https://github.com/tmux-plugins/tmux-yank) - enables copying
highlighted text to system clipboard
- [tmux-open](https://github.com/tmux-plugins/tmux-open) - a plugin for quickly
opening highlighted file or a url
- [tmux-continuum](https://github.com/tmux-plugins/tmux-continuum) - automatic
restoring and continuous saving of tmux env
2014-05-19 09:17:58 +00:00
### License
[MIT](LICENSE.md)