mirror of
https://github.com/tmux-plugins/tpm.git
synced 2024-12-04 18:58:49 +00:00
Add README and license
This commit is contained in:
parent
89b5c18196
commit
ca40b1532b
20
LICENSE.md
Normal file
20
LICENSE.md
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
MIT license
|
||||||
|
Copyright (C) 2014 Bruno Sutic
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining
|
||||||
|
a copy of this software and associated documentation files (the "Software"),
|
||||||
|
to deal in the Software without restriction, including without limitation
|
||||||
|
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
||||||
|
and/or sell copies of the Software, and to permit persons to whom the
|
||||||
|
Software is furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included
|
||||||
|
in all copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||||||
|
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
||||||
|
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||||||
|
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
|
||||||
|
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
||||||
|
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
|
||||||
|
OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
64
README.md
Normal file
64
README.md
Normal file
@ -0,0 +1,64 @@
|
|||||||
|
# Tmux Plugin Manager
|
||||||
|
|
||||||
|
Installs and loads TMUX plugins.
|
||||||
|
|
||||||
|
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
|
||||||
|
things with TMUX. See below for instructions how to create your own plugin.
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
|
||||||
|
Clone TPM:
|
||||||
|
|
||||||
|
$ git clone https://github.com/bruno-/tpm ~/.tmux/plugins/tpm
|
||||||
|
|
||||||
|
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 " \
|
||||||
|
bruno-/tpm \
|
||||||
|
bruno-/tmux_battery_osx \
|
||||||
|
# Examples:
|
||||||
|
# github_username/plugin_name \
|
||||||
|
# git@github.com/user/plugin \
|
||||||
|
# git@bitbucket.com/user/plugin \
|
||||||
|
"
|
||||||
|
|
||||||
|
# initializes TMUX plugin manager
|
||||||
|
run-shell ~/.tmux/plugins/tpm/tpm.sh
|
||||||
|
|
||||||
|
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
|
||||||
|
|
||||||
|
### Creating plugins
|
||||||
|
|
||||||
|
### License
|
||||||
|
|
||||||
|
[MIT](LICENSE.md)
|
Loading…
Reference in New Issue
Block a user