mirror of
https://github.com/tmux-plugins/tpm.git
synced 2024-12-04 02:38:48 +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