"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "nnn.1" between
nnn-v4.1.1.tar.gz and nnn-v4.2.tar.gz

About: nnn is a full-featured terminal file manager.

nnn.1  (nnn-v4.1.1):nnn.1  (nnn-v4.2)
NNN(1) BSD General Commands Manual NNN(1) NNN(1) BSD General Commands Manual NNN(1)
NAME NAME
nnn — The unorthodox terminal file manager. nnn — The unorthodox terminal file manager.
SYNOPSIS SYNOPSIS
nnn [-aAcCdDeEfFgHJKlnQrRSuUVwxh] [-b key] [-p file] [-P key] [-s name] [-t nnn [-aAcCdDeEfgHJKnQrRSuUVwxh] [-b key] [-F val] [-l val] [-p file] [-P ke
secs] [-T key] [PATH] y] [-s name] [-t secs] [-T key]
[PATH]
DESCRIPTION DESCRIPTION
nnn (Nnn's Not Noice) is a performance-optimized, feature-packed fork of no ice http://git.2f30.org/noice/ nnn (Nnn's Not Noice) is a performance-optimized, feature-packed fork of no ice http://git.2f30.org/noice/
with seamless desktop integration, simplified navigation, type-to-nav mode with auto select, disk usage with seamless desktop integration, simplified navigation, type-to-nav mode with auto select, disk usage
analyzer mode, bookmarks, contexts, application launcher, familiar navigati on shortcuts, subshell spawning analyzer mode, bookmarks, contexts, application launcher, familiar navigati on shortcuts, subshell spawning
and much more. It remains a simple and efficient file manager that stays ou t of your way. and much more. It remains a simple and efficient file manager that stays ou t of your way.
nnn opens the current working directory by default if PATH is not specified . nnn opens the current working directory by default if PATH is not specified .
KEYBINDS KEYBINDS
skipping to change at line 53 skipping to change at line 54
-e -e
open text files in $VISUAL (else $EDITOR, fallback vi) [preferably CLI] open text files in $VISUAL (else $EDITOR, fallback vi) [preferably CLI]
-E -E
use $EDITOR for internal undetached edits use $EDITOR for internal undetached edits
-f -f
use readline history file use readline history file
-F -F val
show fortune in help and settings screen fifo notification mode
0: notify as previewer, 1: notify as explorer
-g -g
use regex filters instead of substring match use regex filters instead of substring match
-H -H
show hidden files show hidden files
-J -J
disable auto-proceed on select disable auto-proceed on select
skipping to change at line 242 skipping to change at line 244
- repeat the range key on the same entry twice to clear selection compl etely - repeat the range key on the same entry twice to clear selection compl etely
(3) add all files in the current directory to selection (3) add all files in the current directory to selection
A selection can be edited, copied, moved, removed, archived or linked. A selection can be edited, copied, moved, removed, archived or linked.
Absolute paths of the selected files are copied to .selection file in the c onfig directory. The selection Absolute paths of the selected files are copied to .selection file in the c onfig directory. The selection
file is shared between multiple program instances. Selection from multiple instances are not merged. The file is shared between multiple program instances. Selection from multiple instances are not merged. The
last instance writing to the file overwrites earlier contents. If you have 2 instances of nnn open in 2 last instance writing to the file overwrites earlier contents. If you have 2 instances of nnn open in 2
panes of a terminal multiplexer, you can select in one pane and use the sel ection in the other pane. panes of a terminal multiplexer, you can select in one pane and use the sel ection in the other pane.
nnn clears the selection after an operation with the selection. Plugins are nnn clears the selection after a successful operation with the selection. P
allowed to define the behaviour lugins are allowed to define the
individually. behaviour individually.
nnn doesn't match directory entries for selected files after a redraw or af To edit the selection use the _edit selection_ key. Editing doesn't end the
ter the user navigates away from selection mode. You can add
the directory. An attempt to do so will increase memory consumption and pro more files to the selection and edit the list again. If no file is selected
cessing significantly as nnn in the current session, this
allows selection across directories. So the selection marks are cleared. Th option attempts to list the selection file.
e selection can still be edited
in the same instance.
To edit the selection use the _edit selection_ key. Use this key to remove
a file from selection after you
navigate away from its directory or to remove duplicates. Editing doesn't e
nd the selection mode. You can
add more files to the selection and edit the list again. If no file is sele
cted in the current session,
this option attempts to list the selection file.
FIND AND LIST FIND AND LIST
There are two ways to search and list: There are two ways to search and list:
- feed a list of file paths as input - feed a list of file paths as input
- search using a plugin (e.g. finder) and list the results - search using a plugin (e.g. finder) and list the results
File paths must be NUL-separated ('\0'). Paths and can be relative to the c urrent directory or absolute. File paths must be NUL-separated ('\0'). Paths and can be relative to the c urrent directory or absolute.
Invalid paths in the input are ignored. Input limit is 65,536 paths or 256 MiB of data. Invalid paths in the input are ignored. Input limit is 65,536 paths or 256 MiB of data.
skipping to change at line 311 skipping to change at line 307
export NNN_OPTS="cEnrx" export NNN_OPTS="cEnrx"
NNN_OPENER: specify a custom file opener. NNN_OPENER: specify a custom file opener.
export NNN_OPENER=nuke export NNN_OPENER=nuke
NOTE: 'nuke' is a file opener available in the plugin repository. NOTE: 'nuke' is a file opener available in the plugin repository.
NNN_BMS: bookmark string as key_char:location pairs separated by ;: NNN_BMS: bookmark string as key_char:location pairs separated by ;:
export NNN_BMS="d:$HOME/Documents;u:/home/user/Cam Uploads;D:$HOME/Down loads/" export NNN_BMS="d:$HOME/Docs;u:/home/user/Cam Uploads;D:$HOME/Downloads /"
NNN_PLUG: directly executable plugins as key_char:plugin pairs separated by ;: NNN_PLUG: directly executable plugins as key_char:plugin pairs separated by ;:
export NNN_PLUG='f:finder;o:fzopen;p:mocplay;d:diffs;t:nmount;v:imgview ' export NNN_PLUG='f:finder;o:fzopen;p:mocplay;d:diffs;t:nmount;v:imgview '
NOTES: NOTES:
1. To run a plugin directly, press ; followed by the key. 1. To run a plugin directly, press ; followed by the key.
2. Alternatively, combine with Alt (i.e. Alt+key). 2. Alternatively, combine with Alt (i.e. Alt+key).
3. To skip directory refresh after running a plugin, prefix with -. 3. To skip directory refresh after running a plugin, prefix with -.
export NNN_PLUG='m:-mediainf' export NNN_PLUG='p:-plugin'
To assign keys to arbitrary non-background non-shell-interpreted cli To assign keys to arbitrary non-background non-shell-interpreted cli
commands and invoke like plugins, add _ (underscore) before the commands and invoke like plugins, add ! (underscore) before the
command. command.
export NNN_PLUG='x:_chmod +x $nnn;g:_git log;s:_smplayer $nnn' export NNN_PLUG='x:!chmod +x $nnn;g:!git log;s:!smplayer $nnn'
To pick and run an unassigned plugin, press Enter at the plugin prompt. To pick and run an unassigned plugin, press Enter at the plugin prompt.
To run a plugin at startup, use the option `-P` followed by the plugin key. To run a plugin at startup, use the option `-P` followed by the plugin key.
NOTES: NOTES:
1. Use single quotes for $NNN_PLUG so $nnn is not interpreted 1. Use single quotes for $NNN_PLUG so $nnn is not interpreted
2. $nnn should be the last argument (IF used) 2. $nnn should be the last argument (IF used)
3. (Again) add _ before the command 3. (Again) add ! before the command
4. To disable directory refresh after running a command as plugin, 4. To disable directory refresh after running a command as plugin,
prefix with -_ prefix with -!
5. To skip user confirmation after command execution, suffix with * 5. To skip user confirmation after command execution, suffix with *
Note: Do not use * with programs those run and exit e.g. cat Note: Do not use * with programs those run and exit e.g. cat
export NNN_PLUG='y:-_sync*' export NNN_PLUG='y:-!sync*'
6. To run a GUI app as plugin, add a | after _ 6. To run a GUI app as plugin, add a & after !
export NNN_PLUG='m:-_|mousepad $nnn' export NNN_PLUG='m:-!&mousepad $nnn'
7. To show the output of run-and-exit commands which do not need user i
nput,
add | (pipe) after !
Note: This option is incompatible with & (terminal output is masked
for GUI programs) and ignores * (output is already paged for user)
export NNN_PLUG='m:-!|mediainfo $nnn;t:-!|tree -ps;l:-!|ls -lah --g
roup-directories-first'
EXAMPLES: EXAMPLES:
----------------------------------- + --------------------------------- ---------------- ----------------------------------- + --------------------------------- ----------------
Key:Command | Description Key:Command | Description
----------------------------------- + --------------------------------- ---------------- ----------------------------------- + --------------------------------- ----------------
g:-_git diff | Show git diff e:-!sudo -E vim $nnn* | Edit file as root in vim
k:-_fuser -kiv $nnn* | Interactively kill process(es) us g:-!git diff | Show git diff
ing hovered file h:-!hx $nnn* | Open hovered file in hx hex edito
l:-_git log | Show git log r
n:-_vi /home/user/Dropbox/dir/note* | Take quick notes in a synced file k:-!fuser -kiv $nnn* | Interactively kill process(es) us
/dir of notes ing hovered file
p:-_less -iR $nnn* | Page through hovered file in less l:-!git log | Show git log
s:-_|smplayer -minigui $nnn | Play hovered media file, even unf n:-!vi /home/user/Dropbox/dir/note* | Take quick notes in a synced file
inished download /dir of notes
x:_chmod +x $nnn | Make the hovered file executable p:-!less -iR $nnn* | Page through hovered file in less
y:-_sync* | Flush cached writes s:-!&smplayer -minigui $nnn | Play hovered media file, even unf
inished download
x:!chmod +x $nnn | Make the hovered file executable
y:-!sync* | Flush cached writes
----------------------------------- + --------------------------------- ---------------- ----------------------------------- + --------------------------------- ----------------
Online docs: https://github.com/jarun/nnn/tree/master/plugins Online docs: https://github.com/jarun/nnn/tree/master/plugins
NNN_COLORS: string of color numbers for each context, e.g.: NNN_COLORS: string of color numbers for each context, e.g.:
# 8 color numbers: # 8 color numbers:
# 0-black, 1-red, 2-green, 3-yellow, 4-blue (default), 5-magenta, 6-cya n, 7-white # 0-black, 1-red, 2-green, 3-yellow, 4-blue (default), 5-magenta, 6-cya n, 7-white
export NNN_COLORS='1234' export NNN_COLORS='1234'
skipping to change at line 448 skipping to change at line 453
2. If the FIFO file doesn't exist it will be created, 2. If the FIFO file doesn't exist it will be created,
but not removed (unless it is generated by -a option). but not removed (unless it is generated by -a option).
Online docs: https://github.com/jarun/nnn/wiki/Live-previews Online docs: https://github.com/jarun/nnn/wiki/Live-previews
NNN_LOCKER: terminal locker program. NNN_LOCKER: terminal locker program.
export NNN_LOCKER='bmon -p wlp1s0' export NNN_LOCKER='bmon -p wlp1s0'
export NNN_LOCKER='cmatrix' export NNN_LOCKER='cmatrix'
NNN_HELP: run a program and show the output on top of the program help page
.
export NNN_HELP='fortune'
NNN_MCLICK: key emulated by a middle mouse click. NNN_MCLICK: key emulated by a middle mouse click.
export NNN_MCLICK='^R' export NNN_MCLICK='^R'
NOTE: Only the first character is considered if not a Ctrl+key combo. NOTE: Only the first character is considered if not a Ctrl+key combo.
nnn: this is a special variable. nnn: this is a special variable.
Set to the hovered file name before starting the command prompt or spaw ning a shell. Set to the hovered file name before starting the command prompt or spaw ning a shell.
NO_COLOR: disable ANSI color output (overridden by NNN_COLORS). NO_COLOR: disable ANSI color output (overridden by NNN_COLORS).
AUTHORS AUTHORS
Arun Prakash Jana <engineerarun@gmail.com>, Arun Prakash Jana <engineerarun@gmail.com>,
Lazaros Koromilas <lostd@2f30.org>, Lazaros Koromilas <lostd@2f30.org>,
Dimitris Papastamos <sin@2f30.org>. Dimitris Papastamos <sin@2f30.org>.
HOME HOME
https://github.com/jarun/nnn https://github.com/jarun/nnn
BSD Jun 03, 2021 BSD BSD Jul 21, 2021 BSD
 End of changes. 16 change blocks. 
42 lines changed or deleted 51 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)