README.md | 2 +- nnn.1 | 8 ++++---- plugins/README.md | 8 ++++---- plugins/finder | 2 +- diff --git a/README.md b/README.md index 0fcc3b6f47abdc749ada6d0c72c03572be71a544..28b7a4e9becb7063539cc7e3bae24f4044512e8f 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ - Select files from anywhere (not just a single dir) - Edit and preview markdown, man page, html - Open a file and auto-advance to the next - Export (filtered) list of visible files -- Find and list in `nnn` from `nnn` +- find/fd/fzf/grep/ripgrep/fzf from `nnn` and list in `nnn` - Unlimited bookmarks, plugins, commands with custom hotkeys - Write a plugin in any language you know - Configure the middle mouse click to do anything diff --git a/nnn.1 b/nnn.1 index 936eaee74f79a2ca1d097c42745fdce5dbed31a7..fe7e0a59081f70b17bcb256f717349f6a02e8877 100644 --- a/nnn.1 +++ b/nnn.1 @@ -331,20 +331,20 @@ .Pp \fBNNN_PLUG:\fR directly executable plugins as \fIkey_char:location\fR pairs separated by \fI;\fR: .Bd -literal - export NNN_PLUG='o:fzopen;p:mocplay;d:diffs;m:nmount;t:imgthumb' + export NNN_PLUG='f:finder;o:fzopen;p:mocplay;d:diffs;t:nmount;v:imgview' NOTES: 1. To run a plugin directly, press \fI;\fR followed by the plugin key. 2. To skip directory refresh after running a plugin, prefix with \fB-\fR. - export NNN_PLUG='m:-mediainfo' + export NNN_PLUG='m:-mediainf' .Ed .Pp To assign keys to arbitrary non-background non-shell-interpreted cli commands and invoke like plugins, add \fI_\fR (underscore) before the command. .Bd -literal - export NNN_PLUG='x:_chmod +x $nnn;g:_git log;s:_smplayer $nnn;o:fzopen' + export NNN_PLUG='x:_chmod +x $nnn;g:_git log;s:_smplayer $nnn' NOTES: 1. Use single quotes for $NNN_PLUG so $nnn is not interpreted @@ -364,8 +364,8 @@ EXAMPLES: ----------------------------------- + ------------------------------------------------- Key:Command | Description ----------------------------------- + ------------------------------------------------- - k:-_fuser -kiv $nnn* | Interactively kill process(es) using hovered file g:-_git diff | Show git diff + k:-_fuser -kiv $nnn* | Interactively kill process(es) using hovered file l:-_git log | Show git log n:-_vi /home/user/Dropbox/dir/note* | Take quick notes in a synced file/dir of notes p:-_less -iR $nnn* | Page through hovered file in less diff --git a/plugins/README.md b/plugins/README.md index 4e346b1a7f11fc3659440331bedb2398a96fe004..292c06b03c07df0f9eadd349385aa20986448cda 100644 --- a/plugins/README.md +++ b/plugins/README.md @@ -78,7 +78,7 @@ Use the plugin shortcut (;key or ^Skey) to list the defined plugin keys and press the required key. E.g., with the below config: ```sh -export NNN_PLUG='o:fzopen;p:mocplay;d:diffs;m:nmount;n:notes;v:imgviu;t:imgthumb' +export NNN_PLUG='f:finder;o:fzopen;p:mocplay;d:diffs;t:nmount;v:imgview' ``` Plugin `fzopen` can be run with the keybind ;o, `mocplay` can be run with ;p and so on... The key vs. plugin pairs are shown in the help and config screen. @@ -90,7 +90,7 @@ `nnn` refreshes the directory after running a plugin to reflect any changes by the plugin. To disable this (say while running the `mediainfo` plugin on some filtered files), add a `-` before the plugin name: ```sh -export NNN_PLUG='m:-mediainfo' +export NNN_PLUG='m:-mediainf' ``` Now `nnn` will not refresh the directory after running the `mediainfo` plugin. @@ -102,7 +102,7 @@ For example: ```sh -export NNN_PLUG='x:_chmod +x $nnn;g:_git log;s:_smplayer $nnn;o:fzopen' +export NNN_PLUG='x:_chmod +x $nnn;g:_git log;s:_smplayer $nnn' ``` Now ;x can be used to make a file executable, ;g can be used to the git log of a git project directory, ;s can be used to preview a partially downloaded media file. @@ -136,8 +136,8 @@ #### Some useful key-command examples | Key:Command | Description | |---|---| -| `k:-_fuser -kiv $nnn*` | Interactively kill process(es) using hovered file | | `g:-_git diff` | Show git diff | +| `k:-_fuser -kiv $nnn*` | Interactively kill process(es) using hovered file | | `l:-_git log` | Show git log | | `n:-_vi /home/user/Dropbox/dir/note*` | Take quick notes in a synced file/dir of notes | | `p:-_less -iR $nnn*` | Page through hovered file in less | diff --git a/plugins/finder b/plugins/finder index b7cda42009544c4444573232d5374049592cc0c7..649b711351da1ddd46ff7e94b2a1a6b54911677d 100755 --- a/plugins/finder +++ b/plugins/finder @@ -3,7 +3,7 @@ # Description: Run custom search and list results in smart context # # Note: To enable multi select in fzf, export the following: -# - export FZF_DEFAULT_OPTS='--bind ctrl-a:select-all,ctrl-d:deselect-all' +# - export FZF_DEFAULT_OPTS='--bind ctrl-a:select-all,ctrl-d:deselect-all,ctrl-t:toggle' # # Shell: POSIX compliant # Author: Arun Prakash Jana