1
0
Fork 0
mirror of synced 2024-11-03 01:08:58 -04:00
tpm/README.md

94 lines
2.5 KiB
Markdown
Raw Normal View History

2014-05-19 05:17:58 -04:00
# Tmux Plugin Manager
Installs and loads TMUX plugins.
### Installation
Requirements: `tmux` version 1.9 (or higher), `git`
2014-05-19 05:22:16 -04:00
2014-05-19 05:17:58 -04:00
Clone TPM:
$ git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
2014-05-19 05:17:58 -04:00
Put this at the bottom of your `.tmux.conf` (backslashes at the end of the lines
are required):
# List of plugins
# Supports `github_username/repo` or full git URLs
set -g @tpm_plugins " \
2014-08-02 06:29:07 -04:00
tmux-plugins/tpm \
tmux-plugins/tmux-sensible \
2014-05-19 05:17:58 -04:00
"
2014-05-19 05:27:10 -04:00
# Other examples:
# github_username/plugin_name \
# git@github.com/user/plugin \
# git@bitbucket.com/user/plugin \
2014-05-19 05:17:58 -04:00
# initializes TMUX plugin manager
2014-05-19 05:27:10 -04:00
run-shell ~/.tmux/plugins/tpm/tpm
2014-05-19 05:17:58 -04:00
Reload TMUX environment so TPM is sourced:
# type this in terminal
$ tmux source-file ~/.tmux.conf
That's it!
### Installing plugins
1. add a new plugin to the `@tpm_plugins` list
2. hit `prefix + I` (I as in *I*nstall) to fetch the plugin
You're good to go! The plugin was cloned to `~/.tmux/plugins/` dir and sourced.
### Key bindings
TPM provides only 1 key binding: `prefix + I`. Here's what it does:
- clones new plugins from github or any other git repo
- pulls updates for already installed plugins
- refreshes TMUX environment
After you press `prefix + I`, everything should be up to date.
### List of plugins
- [pain control](https://github.com/tmux-plugins/tmux-pain-control) - useful standard
bindings for controlling panes
- [goto session](https://github.com/tmux-plugins/tmux-goto-session) - faster session
switching
- [battery osx](https://github.com/tmux-plugins/tmux-battery-osx) - battery status
for OSX in Tmux `status-right`
- [logging](https://github.com/tmux-plugins/tmux-logging) - easy logging and
screen capturing
- [online status](https://github.com/tmux-plugins/tmux-online-status) - online status
indicator in Tmux `status-right`. Useful when on flaky connection to see if
you're online.
2014-05-21 05:14:23 -04:00
If you create a plugin, feel free to create a pull request that adds it to the
list.
2014-05-19 05:17:58 -04:00
### Creating plugins
2014-05-21 06:29:20 -04:00
[How to create a plugin](HOW_TO_PLUGIN.md). It's easy.
2014-07-17 16:56:02 -04:00
### Tests
Requirements: [vagrant](https://www.vagrantup.com/)
2014-07-17 17:19:27 -04:00
To run a test suite:
2014-07-17 16:56:02 -04:00
$ ./run-tests
### About
Truth be told, there aren't too many TMUX plugins out there. People mostly just
copy code snippets from each others' `.tmux.conf` files.
I hope TMUX plugin manager (TPM) inspires people to do better and more creative
2014-07-17 16:56:02 -04:00
things with TMUX.
2014-05-19 05:17:58 -04:00
### License
[MIT](LICENSE.md)