nnn.1 (23264B)
1 .Dd Feb 14, 2026 2 .Dt NNN 1 3 .Os 4 .Sh NAME 5 .Nm nnn 6 .Nd The unorthodox terminal file manager. 7 .Sh SYNOPSIS 8 .Nm 9 .Op Ar -aAcCdDeEfgHJKnQrRSuUVxz0h 10 .Op Ar -b key 11 .Op Ar -F val 12 .Op Ar -l val 13 .Op Ar -p file 14 .Op Ar -P key 15 .Op Ar -s name 16 .Op Ar -t secs 17 .Op Ar -T key 18 .Op Ar PATH 19 .Sh DESCRIPTION 20 .Nm 21 .Pq Nnn's Not Noice 22 is a performance-optimized, feature-packed fork of noice 23 .Em http://git.2f30.org/noice/ 24 with seamless desktop integration, simplified navigation, 25 .Em type-to-nav 26 mode with dir auto-enter, disk usage analyzer mode, bookmarks, 27 contexts, application launcher, familiar navigation shortcuts, 28 subshell spawning and much more. It remains a simple and 29 efficient file manager that stays out of your way. 30 .Pp 31 .Nm 32 opens the current working directory if 33 .Ar PATH 34 is not specified. If 35 .Ar PATH 36 is specified and it exists, 37 .Nm 38 will open it. If the 39 .Ar PATH 40 doesn't exist and ends with a \fB/\fR, 41 .Nm 42 will attempt to create the directory tree and open it. Otherwise, 43 .Ar PATH 44 is considered a path to a regular file and 45 .Nm 46 attempts to create the complete directory tree to the file, open 47 the parent directory and prompt to create the new file in it with 48 the base filename. 49 .Sh KEYBINDS 50 .Pp 51 Press 52 .Ql \fB?\fR 53 in 54 .Nm 55 to see the list of keybinds. 56 .Sh OPTIONS 57 .Pp 58 .Nm 59 supports the following options: 60 .Pp 61 .Fl a 62 auto-setup temporary \fBNNN_FIFO\fR (refer to the \fBENVIRONMENT\fR section) 63 .Pp 64 .Fl A 65 disable directory auto-enter on unique filter match 66 .Pp 67 .Fl "b key" 68 specify bookmark key to open 69 .Pp 70 .Fl B 71 use bsdtar for archives (default: atool) 72 .Pp 73 .Fl c 74 indicates that the opener is a cli-only opener (overrides \fB-e\fR) 75 .Pp 76 .Fl C 77 8-color scheme - color directories by context, disable file colors 78 .Pp 79 .Fl d 80 detail mode 81 .Pp 82 .Fl D 83 show directories in context color with \fBNNN_FCOLORS\fR set 84 .Pp 85 .Fl e 86 open text files in $VISUAL (else $EDITOR, fallback vi) [preferably CLI] 87 .Pp 88 .Fl E 89 use $EDITOR for internal undetached edits 90 .Pp 91 .Fl f 92 use history file 93 .Pp 94 .Fl "F val" 95 fifo notification mode 96 0: notify as previewer, 1: notify as explorer 97 .Pp 98 .Fl g 99 use regex filters instead of substring match 100 .Pp 101 .Fl H 102 show hidden files 103 .Pp 104 .Fl i 105 show current file information in info bar (may be slow) 106 .Pp 107 .Fl J 108 disable auto-advance on selection 109 (eg. selecting an entry will no longer move cursor to the next entry) 110 .Pp 111 .Fl K 112 test for keybind collision and exit 113 .Pp 114 .Fl "l val" 115 number of lines to move per mouse wheel scroll 116 .Pp 117 .Fl n 118 start in type-to-nav mode 119 .Pp 120 .Fl o 121 open files only on Enter key 122 .Pp 123 .Fl "p file" 124 copy (or \fIpick\fR) selection to file, or stdout if file='-' 125 .Pp 126 .Fl "P key" 127 specify plugin key to run 128 .Pp 129 .Fl Q 130 disable confirmation on quit with multiple contexts active 131 .Pp 132 .Fl r 133 show cp, mv progress 134 (Linux-only, needs \fIadvcpmv\fR; \fB^T\fR shows the progress on BSD/macOS) 135 .Pp 136 .Fl R 137 disable rollover at edges (eg. pressing \fBdown\fR while on the last 138 entry will no longer move cursor to the first entry and vice\-versa) 139 .Pp 140 .Fl "s name" 141 load a session by name 142 .Pp 143 .Fl S 144 persistent session 145 .Pp 146 .Fl "t secs" 147 idle timeout in seconds to lock terminal 148 .Pp 149 .Fl "T key" 150 sort order (refer to the \fBSORTING\fR section) 151 keys: 'a'pparent disk usage / 'd'isk usage / 'e'xtension / 'r'everse / 's'ize / 't'ime / 'v'ersion 152 capitalize to reverse (except 'r') 153 .Pp 154 .Fl u 155 use selection if available, don't prompt to choose between selection and hovered entry 156 .Pp 157 .Fl U 158 show user and group names in status bar 159 .Pp 160 .Fl V 161 show version and exit 162 .Pp 163 .Fl x 164 show notifications on selection cp, mv, rm completion (requires the \fB.ntfy\fR plugin) 165 copy path to system clipboard on selection (requires the \fB.cbcp\fR plugin) 166 show xterm title (if non-picker mode) 167 .Pp 168 .Fl z 169 use fuzzy filters (fuzzy match: all characters in filter appear in order) 170 .Pp 171 .Fl 0 172 use null separator (instead of newline) to separate file paths in picker mode outout 173 .Pp 174 .Fl h 175 show program help and exit 176 .Sh CONFIGURATION 177 There is no configuration file. Associated files are at 178 .Pp 179 .Pa ${XDG_CONFIG_HOME:-$HOME/.config}/nnn/ 180 .Pp 181 Configuration is done using a few optional (set if you need) environment 182 variables. Refer to the \fBENVIRONMENT\fR section. 183 .Pp 184 .Nm 185 uses \fBxdg-open\fR (on Linux), \fBopen(1)\fR (on macOS), \fBcygstart\fR on 186 (Cygwin) and \fBopen\fR on (Haiku) as the desktop opener. It's also possible 187 to specify a custom opener. Refer to the \fBENVIRONMENT\fR section. 188 .Sh CONTEXTS 189 Open multiple locations with 8 contexts. The status is shown in the top left 190 corner: 191 .Pp 192 - the current context is in reverse video 193 .br 194 - other active contexts are underlined 195 .br 196 - rest are inactive 197 .Pp 198 A new context copies the state of the previous context. Each context can have 199 its own color. Refer to the \fBENVIRONMENT\fR section. 200 .Sh SESSIONS 201 Sessions are a way to save and restore states of work. A session stores the 202 settings and contexts. Sessions can be loaded at runtime or with a program 203 option. 204 .Pp 205 - When a session is loaded at runtime, the last working state is saved 206 automatically to a dedicated "auto session" session file. Session option 207 \fIrestore\fR would restore the "auto session". 208 .br 209 - The persistent session option is global. If it is used, the last active session 210 will be updated with the final state at program quit. 211 .br 212 - The "auto session" is used in persistent session mode if no session is active. 213 .br 214 - Listing input stream and opening a bookmark by key have a higher priority to 215 session options (\fB-s\fR/\fB-S\fR). 216 .Pp 217 All the session files are located by session name in the directory 218 .Pp 219 \fB${XDG_CONFIG_HOME:-$HOME/.config}/nnn/sessions\fR 220 .Pp 221 "@" is the "auto session" file. 222 .Sh FILTERS 223 Filters are strings (or regex patterns) to find matching entries in the current 224 directory instantly (\fIsearch-as-you-type\fR). Matches are case-insensitive by 225 default. The last filter in each context is persisted at runtime or in saved 226 sessions. 227 .br 228 When there's a unique match and it's a directory, 229 .Nm 230 auto enters the directory. Use the relevant program option to disable this. 231 .Pp 232 Special keys at filter prompt: 233 .Bd -literal 234 -------- + --------------------------------------- 235 Key | Function 236 -------- + --------------------------------------- 237 ^char | Usual keybind functionality 238 Esc | Exit filter prompt but skip dir refresh 239 / | Enter dir exactly matching filter 240 -------- + --------------------------------------- 241 .Ed 242 .Pp 243 Special keys at \fBempty\fR filter prompt: 244 .Bd -literal 245 ------ + ------------------------------------- 246 Key | Function 247 ------ + ------------------------------------- 248 ? | Show help and config screen 249 / | Toggle between string, fuzzy, regex 250 : | Toggle case-sensitivity 251 ^L | Clear filter (if prompt is \fBnon-empty\fR) 252 | OR apply last filter 253 Bksp | Stay at filter prompt and refresh dir 254 Del | Stay at filter prompt and refresh dir 255 ------ + ------------------------------------- 256 .Ed 257 .Pp 258 Common regex use cases: 259 .Pp 260 (1) To list all matches starting with the filter expression, 261 start the expression with a '^' (caret) symbol. 262 .br 263 (2) Type '\\.mkv' to list all MKV files. 264 .br 265 (3) Use '.*' to match any character (\fIsort of\fR fuzzy search). 266 .br 267 (4) Exclude filenames having 'nnn' (compiled with PCRE2 lib): '^(?!nnn)' 268 .Pp 269 In the \fItype-to-nav\fR mode directories are opened in filter 270 mode, allowing continuous navigation. 271 .Pp 272 Additional special keys at \fBempty\fR filter prompt 273 in \fItype-to-nav\fR mode: 274 .Bd -literal 275 ------ + ------------------------ 276 Key | Function 277 ------ + ------------------------ 278 ' | Go to first non-dir file 279 + | Toggle file selection 280 , | Mark CWD 281 - | Go to last visited dir 282 . | Show hidden files 283 ; | Run a plugin by its key 284 = | Launch a GUI application 285 > | Export file list 286 @ | Visit start dir 287 ] | Show command prompt 288 ` | Visit / 289 ~ | Go HOME 290 ------ + ------------------------ 291 .Ed 292 .Sh SORTING 293 .Nm 294 will always show the directories first, followed by the files. String 295 order is always case-insensitive. 296 .Pp 297 The sort key can be set either with the \fB-T\fR program option, or 298 interactively using \fBt\fR or \fB^T\fR. The following options are available: 299 .Bl -tag -width 2n 300 .It Ic a 301 apparent disk usage, how large the file appears to be, can be bigger than actual 302 disk usage in sparse files. 303 .It Ic d 304 disk usage, amount of data taken on disk, a multiple of the block size. 305 .It Ic e 306 extension of the file. 307 .It Ic r 308 reverse the current order (not available with \fB-T\fR). 309 .It Ic s 310 size of file, amount of data stored in the file. 311 .It Ic t 312 time, this depends on the currently selected time type which can be changed 313 using the \fBT\fR key. 314 Options are: 315 .Bl -tag -compact -width 1n 316 .It Ic a 317 access, last time the file was accessed. 318 .It Ic c 319 change, last time the metadata of the file was changed (e.g. permissions). 320 .It Ic m 321 modified, last time the content of the file was changed (default). 322 .El 323 .It Ic v 324 version, sorts by filename while treating digit characters numerically. 325 For example: j1.png, j02.png, j3.png. 326 .It Ic c 327 clear, revert to filename order (not available with \fB-T\fR). 328 .It Ic ^T 329 cycle between filename/size/time order (not available with \fB-T\fR). 330 .El 331 .Pp 332 The uppercase version of the option (except \fBr\fR) reverses the default order. 333 By default, time and size sort keys are ordered in descending order, and 334 alphabetical fields are ordered in ascending order. 335 For example, when using the \fBe\fR option, the entries will be ordered by 336 extension, in ascending order. 337 Using \fBE\fR would result in descending order of the extensions. 338 This means that \fBe\fR followed by \fBr\fR is the same as \fBE\fR. 339 .Sh SELECTION 340 .Nm 341 allows file selection across directories and contexts! 342 .Pp 343 There are 3 groups of keybinds to add files to selection: 344 .Pp 345 (1) hovered file selection toggle 346 - deselects if '+' is visible before the entry, else adds to selection 347 .br 348 (2) add a range of files to selection 349 - repeat the range key on the same entry twice to clear selection completely 350 .br 351 (3) add all files in the current directory to selection 352 .Pp 353 A selection can be edited, copied, moved, removed, archived or linked. 354 .Pp 355 Absolute paths of the selected files are copied to \fB.selection\fR file in 356 the config directory. The selection file is shared between multiple program 357 instances. Selection from multiple instances are not merged. The last instance 358 writing to the file overwrites earlier contents. If you have 2 instances of 359 .Nm 360 \fIopen\fR in 2 panes of a terminal multiplexer, you can select in one pane and 361 use the selection in the other pane. The selection gets cleared in the 362 .Nm 363 instance where the selection was made on mv/rm (but not on cp). 364 .Pp 365 .Nm 366 clears the selection after a successful operation with the selection. Plugins 367 are allowed to define the behaviour individually. 368 .Pp 369 To edit the selection use the _edit selection_ key. Editing doesn't end the 370 selection mode. You can add more files to the selection and edit the list 371 again. If no file is selected in the current session, this option attempts 372 to list the selection file. 373 .Pp 374 .Nm 375 can show the total size of non-filtered selected files listed in a 376 directory. For directories, only the size of the directory is added by 377 default. To add the size of the contents of a directory, sort by disk usage (aka du mode). 378 .Sh FIND AND LIST 379 There are two ways to search and list: 380 .Pp 381 - feed a list of file paths as input 382 .br 383 - search using a plugin (e.g. \fBfinder\fR) and list the results 384 .Pp 385 File paths must be NUL-separated ('\\0'). Paths and can be relative to the 386 current directory or absolute. Invalid paths in the input are ignored. Input 387 processing limit is 16,384 paths or 64 MiB (max_paths x max_path_len) of data. 388 .Pp 389 To list the input stream, start 390 .Nm 391 by writing to its standard input. E.g., to list files in current 392 directory larger than 393 1M: 394 .Bd -literal 395 find -maxdepth 1 -size +1M -print0 | nnn 396 .Ed 397 .Pp 398 or redirect a list from a file: 399 .Bd -literal 400 nnn < files.txt 401 .Ed 402 .Pp 403 Handy bash/zsh shell function to list files by mime-type in current directory: 404 .Bd -literal 405 # to show video files, run: list video 406 407 list () 408 { 409 find . -maxdepth 1 | file -if- | grep "$1" | awk -F: '{printf "%s%c", $1, 0}' | nnn 410 } 411 .Ed 412 .Pp 413 A temporary directory will be created containing symlinks to the given 414 paths. Any action performed on these symlinks will be performed only on their 415 targets, after which they might become invalid. 416 .Pp 417 \fB>\fR or \fBl\fR on a symlink in the listing dir takes to the target 418 file. Press \fB-\fR to return to the listing dir. Press \fBEnter\fR to open the symlink. 419 .Pp 420 Listing input stream can be scripted. It can be extended to pick (option -p) 421 selected entries from the listed results. 422 .Sh BOOKMARKS 423 There are 2 ways (can be used together) to manage bookmarks. 424 .Pp 425 (1) Bookmark keys: See \fBNNN_BMS\fR under \fBENVIRONMENT\fR section on how to set 426 bookmark keys. 427 428 The select bookmark key \fBb\fR lists all the bookmark keys set in \fBNNN_BMS\fR 429 in the bookmarks prompt. 430 .Pp 431 (2) Symlinked bookmarks: A symlinked bookmark to the current directory can 432 be created with the \fBB\fR key (or manually under ~/.config/nnn/bookmarks). 433 434 Pressing \fBEnter\fR at the bookmarks prompt takes to this directory. 435 If \fBNNN_BMS\fR is not set, the select bookmark key directly opens it. 436 .Pp 437 On entering a bookmark, the directory where the select bookmark key was 438 pressed is set as the previous directory. Press \fB-\fR to return to it. 439 .Pp 440 .Sh UNITS 441 The minimum file size unit is byte (B). The rest are K, M, G, T, P, E, Z, Y 442 (powers of 1024), same as the default units in \fBls\fR. 443 .Sh ENVIRONMENT 444 The SHELL, VISUAL (else EDITOR) and PAGER environment variables are 445 used. A single combination of arguments is supported for SHELL and PAGER. 446 .Pp 447 \fBNNN_OPTS:\fR binary options to 448 .Nm 449 .Bd -literal 450 export NNN_OPTS="cEnrx" 451 .Ed 452 .Pp 453 \fBNNN_OPENER:\fR specify a custom file opener. 454 .Bd -literal 455 export NNN_OPENER=nuke 456 457 NOTE: \fBnuke\fR is a file opener available in the plugin repository. 458 .Ed 459 .Pp 460 \fBNNN_BMS:\fR bookmark string as \fIkey_char:location\fR pairs 461 separated by \fB;\fR: 462 .Bd -literal 463 export NNN_BMS="d:$HOME/Docs;u:/home/user/Cam Uploads;D:$HOME/Downloads/" 464 .Ed 465 .Pp 466 These bookmarks are listed in the help and config screen (key \fB?\fR). 467 .Pp 468 \fBNNN_PLUG:\fR directly executable plugins as \fIkey_char:plugin\fR pairs 469 separated by \fB;\fR: 470 .Bd -literal 471 export NNN_PLUG='f:finder;o:fzopen;p:mocplay;d:diffs;t:nmount;v:imgview' 472 473 NOTES: 474 1. To run a plugin directly, press \fB;\fR followed by the key. 475 2. Alternatively, combine with \fBAlt\fR (i.e. \fBAlt+key\fR). 476 3. To skip directory refresh after running a plugin, prefix with \fB-\fR. 477 478 export NNN_PLUG='p:-plugin' 479 .Ed 480 .Pp 481 To assign keys to arbitrary non-background cli commands and invoke like 482 plugins, add \fB!\fR before the command. 483 .Bd -literal 484 export NNN_PLUG='x:!chmod +x "$nnn";g:!git log;s:!smplayer "$nnn"' 485 486 To pick and run an unassigned plugin, press \fBEnter\fR at the plugin prompt. 487 To run a plugin at startup, use the option `-P` followed by the plugin key. 488 489 NOTES: 490 1. Place $nnn (or exported variables) in double quotes (\fB"$nnn"\fR) 491 2. Use single quotes for $NNN_PLUG so "$nnn" is not interpreted 492 3. (Again) add \fB!\fR before the command 493 4. To disable directory refresh after running a \fIcommand as plugin\fR, 494 prefix with \fB-!\fR 495 5. To skip user confirmation after command execution, suffix with \fB*\fR 496 Note: Do not use \fB*\fR with programs those run and exit e.g. cat 497 498 export NNN_PLUG='y:-!sync*' 499 500 6. To run a \fIGUI app as plugin\fR, add a \fB&\fR after \fB!\fR. 501 502 export NNN_PLUG='m:-!&mousepad "$nnn"' 503 504 7. To show the output of run-and-exit commands which do not need user input, 505 add \fB|\fR (pipe) after \fB!\fR 506 Note: This option is incompatible with \fB&\fR (terminal output is masked 507 for GUI programs) and ignores \fB*\fR (output is already paged for user). 508 509 export NNN_PLUG='m:-!|mediainfo "$nnn";t:-!|tree -ps;l:-!|ls -lah --group-directories-first' 510 511 8. To show the output of run-and-exit commands in a floating window, 512 add \fB>\fR (right arrow) after \fB!\fR 513 Note: This option is incompatible with \fB&\fR (terminal output is masked 514 for GUI programs) and ignores \fB*\fR (output is rendered in a floating 515 window). 516 Option `-` is ignored with this option. The directory is always refreshed. 517 518 export NNN_PLUG='m:!>mediainfo "$nnn";t:!>tree -ps;l:!>ls -lah --group-directories-first' 519 520 EXAMPLES: 521 ------------------------------------ + ------------------------------------------------- 522 Key:Command | Description 523 ------------------------------------ + ------------------------------------------------- 524 c:!convert "$nnn" png:- | xclip | Copy image to clipboard 525 -sel clipboard -t image/png* | 526 C:!cp -rv "$nnn" "$nnn".cp* | Create a copy of the hovered file 527 e:-!sudo -E vim "$nnn"* | Edit file as root in vim 528 g:-!git diff | Show git diff 529 h:-!hx "$nnn"* | Open hovered file in hx hex editor 530 k:-!fuser -kiv "$nnn"* | Interactively kill process(es) using hovered file 531 l:-!git log | Show git log 532 n:-!vi /home/user/Dropbox/dir/note* | Take quick notes in a synced file/dir of notes 533 p:-!less -iR "$nnn"* | Page through hovered file in less 534 s:-!&smplayer -minigui "$nnn" | Play hovered media file, even unfinished download 535 x:!chmod +x "$nnn" | Make the hovered file executable 536 y:-!sync* | Flush cached writes 537 ------------------------------------ + ------------------------------------------------- 538 539 Online docs: https://github.com/jarun/nnn/tree/master/plugins 540 .Ed 541 .Pp 542 \fBNNN_ORDER:\fR directory-specific sort key. 543 .Bd -literal 544 export NNN_ORDER='t:/home/user/Downloads;S:/tmp' 545 546 NOTE: Sort keys can be a/d/e/r/s/t/v (refer to the \fBSORTING\fR section). 547 Path must be absolute. 548 549 Timestamps for entries modified/created within 5 minutes are shown in reverse. 550 .Ed 551 .Pp 552 \fBNNN_COLORS:\fR string of color numbers for each context, e.g.: 553 .Bd -literal 554 # 8 color numbers: 555 # 0-black, 1-red, 2-green, 3-yellow, 4-blue (default), 5-magenta, 6-cyan, 7-white 556 export NNN_COLORS='12341234' 557 558 # xterm 256 color numbers (converted to hex, 2 symbols per context): 559 # see https://user-images.githubusercontent.com/1482942/93023823-46a6ba80-f5e1-11ea-9ea3-6a3c757704f4.png 560 export NNN_COLORS='#0a1b2c3d0a1b2c3d' 561 562 # both (256 followed by 8 as fallback, separated by ';') 563 export NNN_COLORS='#0a1b2c3d0a1b2c3d;12341234' 564 565 NOTE: If only 256 colors are specified and the terminal doesn't support, default is used. 566 .Ed 567 .Pp 568 \fBNNN_FCOLORS:\fR specify file-type specific colors: 569 .Bd -literal 570 export NNN_FCOLORS='c1e2272e006033f7c6d6abc4' 571 572 Specify file-specific colors in xterm 256 color hex numbers (2 symbols per color). 573 Order is strict, use 00 to omit/use default terminal color. Defaults: 574 575 ------------------------- + --- + ------------- 576 Order | Hex | Color 577 ------------------------- + --- + ------------- 578 Block device | c1 | DarkSeaGreen1 579 Char device | e2 | Yellow1 580 Directory | 27 | DeepSkyBlue1 581 Executable | 2e | Green1 582 Regular | 00 | Normal 583 Hard link | 60 | Plum4 584 Symbolic link | 33 | Cyan1 585 Missing OR file details | f7 | Grey62 586 Orphaned symbolic link | c6 | DeepPink1 587 FIFO | d6 | Orange1 588 Socket | ab | MediumOrchid1 589 Unknown OR 0B regular/exe | c4 | Red1 590 ------------------------- + --- + ------------- 591 592 If the terminal supports xterm 256 colors or more, file-specific colors will be rendered. 593 To force the 8-color scheme use option -C. 594 If xterm 256 colors aren't supported, 8-color scheme will be used. 595 .Ed 596 .Pp 597 \fBNNN_ARCHIVE:\fR archive extensions to be handled silently (default: bzip2, (g)zip, tar). 598 .Bd -literal 599 export NNN_ARCHIVE="\\\\.(7z|bz2|gz|tar|tgz|zip)$" 600 601 NOTE: Non-default formats may require a third-party utility. 602 .Ed 603 .Pp 604 \fBNNN_ARCHMNT:\fR optional archive mounter utility (default: archivemount). 605 .Bd -literal 606 export NNN_ARCHIVE='fuse-archive' 607 .Ed 608 .Pp 609 \fBNNN_SSHFS:\fR specify custom sshfs command with options: 610 .Bd -literal 611 export NNN_SSHFS='sshfs -o reconnect,idmap=user,cache_timeout=3600' 612 613 NOTE: The options must be comma-separated without any space between them. 614 .Ed 615 .Pp 616 \fBNNN_RCLONE:\fR pass additional options to rclone command: 617 .Bd -literal 618 export NNN_RCLONE='rclone mount --read-only --no-checksum' 619 620 NOTE: The options must be preceded by "rclone" and max 5 flags are supported. 621 .Ed 622 .Pp 623 \fBNNN_TRASH:\fR trash (instead of \fBrm -rf\fR) files to desktop Trash. 624 .Bd -literal 625 export NNN_TRASH=cmd 626 627 NOTES: 628 1. \fBcmd\fR is the name/path of the binary that nnn will call for 629 trashing files. E.g to use macOS's native `trash' command: 630 export NNN_TRASH="trash" 631 2. Special value "1" and "2" for cmd will use trash-cli and 632 gio trash respectively. 633 .Ed 634 .Pp 635 \fBNNN_SEL:\fR absolute path to custom selection file. 636 .Bd -literal 637 export NNN_SEL='/tmp/.sel' 638 .Ed 639 .Pp 640 \fBNNN_FIFO:\fR path of a named pipe to write the hovered file path: 641 .Bd -literal 642 export NNN_FIFO='/tmp/nnn.fifo' 643 644 NOTES: 645 1. Overridden by a temporary path with -a option. 646 2. If the FIFO file doesn't exist it will be created, 647 but not removed (unless it is generated by -a option). 648 649 Online docs: https://github.com/jarun/nnn/wiki/Live-previews 650 .Ed 651 .Pp 652 \fBNNN_LOCKER:\fR terminal locker program. 653 .Bd -literal 654 export NNN_LOCKER='bmon -p wlp1s0' 655 export NNN_LOCKER='cmatrix' 656 .Ed 657 .Pp 658 \fBNNN_TMPFILE:\fR \fIalways\fR cd on quit and write the command in the file specified. 659 .Bd -literal 660 export NNN_TMPFILE='/tmp/.lastd' 661 .Ed 662 .Pp 663 \fBNNN_HELP:\fR run a program and show the output on top of the program help page. 664 .Bd -literal 665 export NNN_HELP='fortune' 666 .Ed 667 .Pp 668 \fBNNN_MCLICK:\fR key emulated by a middle mouse click. 669 .Bd -literal 670 export NNN_MCLICK='^R' 671 672 NOTE: Only the first character is considered if not a \fBCtrl+key\fR combo. 673 .Ed 674 .Pp 675 \fBnnn:\fR this is a special variable. 676 .Bd -literal 677 Set to the hovered file name before starting the command prompt or spawning a shell. 678 .Ed 679 .Pp 680 \fBNO_COLOR:\fR disable ANSI color output (overridden by \fBNNN_COLORS\fR). 681 .Sh AUTHORS 682 .An Arun Prakash Jana Aq Mt engineerarun@gmail.com , 683 .An Lazaros Koromilas Aq Mt lostd@2f30.org , 684 .An Dimitris Papastamos Aq Mt sin@2f30.org . 685 .Sh HOME 686 .Em https://github.com/jarun/nnn