mirror of https://github.com/jarun/nnn.git
221 lines
7.1 KiB
Groff
221 lines
7.1 KiB
Groff
.Dd Aug 06, 2019
|
|
.Dt NNN 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm nnn
|
|
.Nd the missing terminal file manager for X
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Ar -b key
|
|
.Op Ar -d
|
|
.Op Ar -e
|
|
.Op Ar -H
|
|
.Op Ar -i
|
|
.Op Ar -n
|
|
.Op Ar -p file
|
|
.Op Ar -s
|
|
.Op Ar -S
|
|
.Op Ar -v
|
|
.Op Ar -w
|
|
.Op Ar -h
|
|
.Op Ar PATH
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
(Noice is Not Noice) is a performance-optimized, feature-packed fork of noice (http://git.2f30.org/noice/) with seamless desktop integration, simplified navigation, \fInavigate-as-you-type\fR mode with auto select, disk usage analyzer mode, bookmarks, contexts, application launcher, familiar navigation shortcuts, subshell spawning and much more. It remains a simple and efficient file manager that stays out of your way.
|
|
.Pp
|
|
.Nm
|
|
opens the current working directory by default if
|
|
.Ar PATH
|
|
is not specified.
|
|
.Sh KEYBINDS
|
|
.Pp
|
|
Press \fB?\fR in
|
|
.Nm
|
|
to see the list of keybinds.
|
|
.Sh OPTIONS
|
|
.Pp
|
|
.Nm
|
|
supports the following options:
|
|
.Pp
|
|
.Fl "b key"
|
|
specify bookmark key to open
|
|
.Pp
|
|
.Fl d
|
|
detail mode
|
|
.Pp
|
|
.Fl e
|
|
use exiftool instead of mediainfo
|
|
.Pp
|
|
.Fl H
|
|
show hidden files
|
|
.Pp
|
|
.Fl i
|
|
start in navigate-as-you-type mode
|
|
.Pp
|
|
.Fl n
|
|
use case-insensitive version compare to sort files
|
|
.Pp
|
|
.Fl o
|
|
open files only on Enter key
|
|
.Pp
|
|
.Fl "p file"
|
|
copy (or \fIpick\fR) selection to file, or stdout if file='-'
|
|
.Pp
|
|
.Fl s
|
|
use substring match for filters instead of regex
|
|
.Pp
|
|
.Fl S
|
|
start in disk usage analyzer mode
|
|
.Pp
|
|
.Fl v
|
|
show version and exit
|
|
.Pp
|
|
.Fl w
|
|
wild load - entries unsorted on directory load
|
|
.Pp
|
|
.Fl h
|
|
show program help and exit
|
|
.Sh CONFIGURATION
|
|
.Nm
|
|
uses \fIxdg-open\fR (on Linux) and \fIopen(1)\fR (on macOS) as the desktop opener.
|
|
.Pp
|
|
There is no configuration file. Associated files are stored in \fB${XDG_CONFIG_HOME:-$HOME/.config}/nnn/\fR. Settings work on environment variables. See ENVIRONMENT section below.
|
|
.Pp
|
|
Configuring
|
|
.Nm
|
|
to change to the last visited directory on quit requires shell integration in a
|
|
few easy steps. Look up NNN_TMPFILE in the ENVIRONMENT section below.
|
|
.Sh CONTEXTS
|
|
Contexts serve the purpose of exploring multiple directories simultaneously. 4 contexts
|
|
are available. The status of the contexts are shown in the top left corner:
|
|
.Pp
|
|
- the current context is in reverse
|
|
.br
|
|
- other active contexts are underlined
|
|
.br
|
|
- rest are inactive
|
|
.Pp
|
|
To switch to a context press the Leader key followed by the context number (1-4).
|
|
.Pp
|
|
The first time a context is entered, it copies the state of the last visited context. Each context remembers its last visited directory.
|
|
.Pp
|
|
When a context is quit, the next active context is selected. If the last active context is quit, the program quits.
|
|
.Pp
|
|
Each context can have its own directory color specified. See ENVIRONMENT section below.
|
|
.Sh FILTERS
|
|
Filters support regexes (default) to instantly (search-as-you-type) list the matching
|
|
entries in the current directory.
|
|
.Pp
|
|
Common use cases:
|
|
.Pp
|
|
(1) To list all matches starting with the filter expression, start the expression
|
|
with a '^' (caret) symbol.
|
|
.br
|
|
(2) Type '\\.mkv' to list all MKV files.
|
|
.br
|
|
(3) Use '.*' to match any character (\fIsort of\fR fuzzy search).
|
|
.Pp
|
|
There is a program option to filter entries by substring match instead of regex.
|
|
.Pp
|
|
In the \fInavigate-as-you-type\fR mode directories are opened in filter mode,
|
|
allowing continuous navigation. Works best with the \fBarrow keys\fR.
|
|
.br
|
|
When there's a unique match and it's a directory, `nnn` auto selects the directory and enters it in this mode.
|
|
.br
|
|
The \fIwild load\fR option can be extremely handy for users who use the \fInavigate-as-you-type\fR mode constantly. The entries are unsorted when the directory loads. Applying filters sorts the entries (with directories on top). Directory color is disabled in this mode.
|
|
.Sh SELECTION
|
|
Use \fI^K\fR to select the file under the cursor.
|
|
.Pp
|
|
To select multiple files the selection mode should be enabled using \fI^Y\fR.
|
|
In this mode it's possible to
|
|
.Pp
|
|
(1) cherry-pick individual files one by one by pressing <kbd>^K</kbd> on each entry (works across directories and contexts); or,
|
|
.br
|
|
(2) navigate to another file in the same directory to select a range of files.
|
|
.Pp
|
|
Press \fI^Y\fR again to save the selection and exit selection mode.
|
|
.Pp
|
|
Selected files are visually indicated by a \fB+\fR before the entries.
|
|
.br
|
|
The files in the list can now be listed, copied, moved, removed, archived or linked.
|
|
.br
|
|
Absolute paths of the selected files are copied to the temporary file \fB.selection\fR in config directory. The path is shown in the help and configuration screen. If \fB$NNN_COPIER\fR is set (see ENVIRONMENT section below) the file paths are also copied to the system clipboard.
|
|
.Sh ENVIRONMENT
|
|
The SHELL, EDITOR (VISUAL, if defined) and PAGER environment variables take precedence
|
|
when dealing with the !, e and p commands respectively. A single combination to arguments is supported for SHELL and PAGER.
|
|
.Pp
|
|
\fBNNN_BMS:\fR bookmark string as \fIkey_char:location\fR pairs (max 10) separated by
|
|
\fI;\fR:
|
|
.Bd -literal
|
|
export NNN_BMS='d:~/Documents;u:/home/user/Cam Uploads;D:~/Downloads/'
|
|
|
|
NOTE: To go to a bookmark, press the leader key followed by the bookmark key.
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_PLUG:\fR directly executable plugins as \fIkey_char:location\fR pairs (max 10) separated by
|
|
\fI;\fR:
|
|
.Bd -literal
|
|
export NNN_PLUG='o:fzy-open;p:mocplay;d:ndiff;m:nmount;t:thumb'
|
|
|
|
NOTE: To run a plugin directly, press 'x' followed by the plugin key.
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_USE_EDITOR:\fR use VISUAL (else EDITOR, preferably CLI, fallback vi) to handle text
|
|
files.
|
|
.Bd -literal
|
|
export NNN_USE_EDITOR=1
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_CONTEXT_COLORS:\fR string of color codes for each context, e.g.:
|
|
.Bd -literal
|
|
export NNN_CONTEXT_COLORS='1234'
|
|
|
|
codes: 0-black, 1-red, 2-green, 3-yellow, 4-blue (default), 5-magenta, 6-cyan, 7-white
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_SSHFS_OPTS:\fR pass additional options to sshfs command:
|
|
.Bd -literal
|
|
export NNN_SSHFS_OPTS='sshfs -o reconnect,idmap=user,cache_timeout=3600'
|
|
|
|
NOTE: The options must be preceded by `sshfs` and comma-separated without any space between them.
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_NOTE:\fR \fIabsolute\fR path to a note file.
|
|
.Bd -literal
|
|
export NNN_NOTE='/home/user/.mynotes'
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_OPENER:\fR specify a custom file opener.
|
|
.Bd -literal
|
|
export NNN_OPENER=mimeopen
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_IDLE_TIMEOUT:\fR set idle timeout (in seconds) to invoke terminal locker (default: disabled).
|
|
.Pp
|
|
\fBNNN_COPIER:\fR system clipboard copier script. The project page has some sample copier scripts.
|
|
.Pp
|
|
\fBNNN_NO_AUTOSELECT:\fR disable directory auto-selection in \fInavigate-as-you-type\fR mode.
|
|
.Bd -literal
|
|
export NNN_NO_AUTOSELECT=1
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_TRASH:\fR trash (instead of \fIdelete\fR) files to desktop Trash.
|
|
.Bd -literal
|
|
export NNN_TRASH=1
|
|
.Ed
|
|
.Pp
|
|
\fBNNN_OPS_PROG:\fR show progress of copy, move operations (Linux-only, needs advcpmv).
|
|
.Bd -literal
|
|
export NNN_OPS_PROG=1
|
|
|
|
NOTE: BSD and macOS users can press '^T' to check the progress.
|
|
.Ed
|
|
.Sh KNOWN ISSUES
|
|
If you are using urxvt you might have to set backspace key to DEC.
|
|
.Sh AUTHORS
|
|
.An Lazaros Koromilas Aq Mt lostd@2f30.org ,
|
|
.An Dimitris Papastamos Aq Mt sin@2f30.org ,
|
|
.An Arun Prakash Jana Aq Mt engineerarun@gmail.com .
|
|
.Sh HOME
|
|
.Em https://github.com/jarun/nnn
|