diff options
| author |  Arun Prakash Jana <engineerarun@gmail.com> | 2020-08-17 14:05:15 +0530 |
|---|---|---|
| committer | Arun Prakash Jana <engineerarun@gmail.com> | 2020-08-17 14:08:04 +0530 |
| commit | 6a4ff8b825ab264835f8e4db72b4659b076fdecb (patch) | |
| tree | d28b9ce261cdfd901ec4e4fd87b653b158b80c5f /plugins | |
| parent | b5c7d41d9bf28c111fe2a9821558a14a3bd4afae (diff) | |
| download | nnn-6a4ff8b825ab264835f8e4db72b4659b076fdecb.tar.gz | |
Update docs
Diffstat (limited to 'plugins')
| -rw-r--r-- | plugins/README.md | 30 |
1 files changed, 16 insertions, 14 deletions
diff --git a/plugins/README.md b/plugins/README.md index fbc8628..360d91f 100644 --- a/plugins/README.md +++ b/plugins/README.md @@ -12,16 +12,6 @@ Plugins extend the capabilities of `nnn`. They are _executable_ scripts (or bina `nnn` is _**language-agnostic**_ when it comes to plugins. You can write a plugin in any (scripting) language you are comfortable in! -## Installing plugins - -The following command installs or updates (after backup) all plugins: - -```sh -curl -Ls https://raw.githubusercontent.com/jarun/nnn/master/plugins/getplugs | sh -``` - -Plugins are installed to `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins`. - ## List of plugins | Plugin (a-z) | Description | Lang | Dependencies | @@ -78,19 +68,31 @@ Plugins are installed to `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins`. | [wall](wall) | Set wallpaper or change colorscheme | sh | nitrogen/pywal | | [x2sel](x2sel) | Copy `\n`-separated file list from system clipboard to sel | sh | _see in-file docs_ | -## Invoking a plugin +## Installation -Press the plugin shortcut (<kbd>;</kbd>) followed by the assigned key character. E.g., with the below config: +The following command installs or updates (after backup) all plugins: + +```sh +curl -Ls https://raw.githubusercontent.com/jarun/nnn/master/plugins/getplugs | sh +``` + +Plugins are installed to `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins`. + +## Configuration + +Set environment variable `NNN_PLUG` to assign keybinds and invoke plugins directly using the plugin shortcut (<kbd>;</kbd>) followed by the assigned key character. E.g., with the below config: ```sh export NNN_PLUG='f:finder;o:fzopen;p:mocplay;d:diffs;t:nmount;v:imgview' ``` -Plugin `finder` can be run with the keybind <kbd>;f</kbd>, `fzopen` can be run with <kbd>;o</kbd> and so on... The key vs. plugin pairs are shown in the help and config screen. +plugin `finder` can be invoked with the keybind <kbd>;f</kbd>, `fzopen` can be run with <kbd>;o</kbd> and so on... The key vs. plugin pairs are shown in the help and config screen. Alternatively, combine with <kbd>Alt</kbd> (i.e. <kbd>Alt+key</kbd>). -To select and invoke a plugin from the plugin directory, press <kbd>Enter</kbd> (to _enter_ the plugin dir) after the plugin shortcut. +To pick and run an unassigned plugin, press <kbd>Enter</kbd> (to _enter_ the plugin dir) at the plugin prompt. + +To run a plugin at startup, use the option `-P` followed by the plugin key. #### Skip directory refresh after running a plugin |