table of contents
NNN(1) | General Commands Manual | NNN(1) |
NAME¶
nnn
— free, fast,
friendly file browser
SYNOPSIS¶
nnn |
[-d] [dir] |
DESCRIPTION¶
nnn
(Noice is Not Noice) is a fork of the
noice terminal file browser with improved desktop integration, navigation,
disk usage analyzer mode, comprehensive file details and much more. It
remains a simple and efficient file browser that stays out of your way.
nnn
defaults to the current directory if
dir is not specified.
nnn
supports both vi-like and emacs-like
key bindings in the default configuration. The default key bindings are
listed below.
[Up], k, ^P
- Move to previous entry
[Down], j, ^N
- Move to next entry
[PgUp], ^U
- Scroll up half a page
[PgDn], ^D
- Scroll down half a page
[Home], g, ^, ^A
- Move to the first entry
[End], G, $, ^E
- Move to the last entry
[Right], [Enter], l, ^M
- Open file or enter directory
[Left], [Backspace], h, ^H
- Back up one directory level
~
- Change to the HOME directory
-
- Change to the last visited directory
o
- Open directory in desktop file manager
/, &
- Change filter (more information below)
c
- Change into the given directory
d
- Toggle detail view
D
- Toggle current file details screen
.
- Toggle hide .dot files
s
- Toggle sort by file size
S
- Toggle disk usage analyzer mode
t
- Toggle sort by time modified
!
- Spawn SHELL in PWD (fallback sh)
z
- Run the system top utility.
e
- Open current entry in EDITOR (fallback vi)
p
- Open current entry in PAGER (fallback less)
^K
- Invoke file name copier
^L
- Force a redraw
?
- Toggle help screen
q
- Quit
Backing up one directory level will set the cursor position at the directory you came out of.
nnn
supports the following options:
-d
open in detail view mode
-v
show version and exit
CONFIGURATION¶
nnn
is configured by modifying
config.h and recompiling the code.
See the environment and examples sections below for more options and information.
FILTERS¶
Filters support regexes to display only the matched entries in the current directory view. This effectively allows searching through the directory tree for a particular entry.
Filters do not stack on top of each other. They are applied anew every time.
An empty filter expression resets the filter.
If nnn
is invoked as root the default
filter will also match hidden files.
ENVIRONMENT¶
The SHELL, EDITOR and PAGER environment variables take precedence when dealing with the !, e and p commands respectively.
NNN_DE_FILE_MANAGER: set to a desktop file manager to open the current directory with.
NNN_OPENER: set to your desktop environment's default mime
opener to override all custom mime associations.
Examples: xdg-open, gnome-open, gvfs-open.
NNN_FALLBACK_OPENER: set to your desktop environment's default mime opener to use as a fallback when no association is set for a file type. Custom associations are listed in the EXAMPLES section below.
NNN_COPIER: set to a clipboard copier script. For example, on Linux:
------------------------------------- #!/bin/sh echo -n $1 | xsel --clipboard --input -------------------------------------
EXAMPLES¶
The following example shows one possible configuration for file associations which is also the default if environment variable NNN_OPENER is not set:
----------------------------------------------- struct assoc assocs[] = { { "\.(c|cpp|h|txt|log|sh)$", "vi" }, { "\.(wma|mp3|ogg|flac)$", "mpv" }, { "\.pdf$", "zathura" }, }; ----------------------------------------------- Plain text files are opened with vi.
Any other file types are opened with the 'xdg-open' command.
KNOWN ISSUES¶
If you are using urxvt you might have to set backspacekey to DEC.
AUTHORS¶
Lazaros Koromilas
<lostd@2f30.org>,
Dimitris Papastamos
<sin@2f30.org>,
Arun Prakash Jana
<engineerarun@gmail.com>.
HOME¶
April 13, 2017 | Debian |