nnn/nnn.1

343 lines
10 KiB
Groff
Raw Normal View History

2020-01-15 04:12:23 +00:00
.Dd Jan 15, 2020
.Dt NNN 1
2014-10-22 11:52:45 +00:00
.Os
.Sh NAME
.Nm nnn
2018-08-06 23:22:39 +00:00
.Nd the missing terminal file manager for X
2014-10-22 11:52:45 +00:00
.Sh SYNOPSIS
2017-06-04 17:45:08 +00:00
.Nm
2019-08-30 15:25:23 +00:00
.Op Ar -a
.Op Ar -A
.Op Ar -b key
2019-10-02 22:16:35 +00:00
.Op Ar -c
.Op Ar -d
.Op Ar -e
2019-11-24 13:53:09 +00:00
.Op Ar -E
2019-12-14 08:36:00 +00:00
.Op Ar -g
.Op Ar -H
2019-10-11 15:56:03 +00:00
.Op Ar -K
2019-07-14 17:30:14 +00:00
.Op Ar -n
2018-11-23 17:11:47 +00:00
.Op Ar -p file
2019-12-14 17:58:13 +00:00
.Op Ar -Q
.Op Ar -r
2019-12-01 17:30:06 +00:00
.Op Ar -R
.Op Ar -s name
2017-04-14 18:44:25 +00:00
.Op Ar -S
.Op Ar -t secs
2017-04-14 18:44:25 +00:00
.Op Ar -v
.Op Ar -V
.Op Ar -x
2017-04-14 18:44:25 +00:00
.Op Ar -h
.Op Ar PATH
2014-10-22 11:52:45 +00:00
.Sh DESCRIPTION
.Nm
2020-01-15 05:39:51 +00:00
(Nnn's 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.
2014-10-22 11:52:45 +00:00
.Pp
.Nm
2017-12-24 13:16:56 +00:00
opens the current working directory by default if
2017-04-14 18:44:25 +00:00
.Ar PATH
2017-03-31 02:52:51 +00:00
is not specified.
2018-11-11 10:52:58 +00:00
.Sh KEYBINDS
.Pp
Press \fB?\fR in
.Nm
to see the list of keybinds.
2018-11-11 10:52:58 +00:00
.Sh OPTIONS
.Pp
2017-04-01 05:18:18 +00:00
.Nm
2017-04-13 13:43:33 +00:00
supports the following options:
2017-04-01 05:18:18 +00:00
.Pp
2019-08-30 15:25:23 +00:00
.Fl a
use access time for all operations (default: modification time)
.Pp
.Fl A
disable directory auto-select in navigate-as-you-type mode
.Pp
.Fl "b key"
specify bookmark key to open
.Pp
.Fl c
opener opens files in cli utilities only (overrides -e)
.Pp
.Fl d
detail mode
.Pp
.Fl e
open text files in $VISUAL (else $EDITOR, fallback vi) [preferably CLI]
.Pp
2019-11-24 13:53:09 +00:00
.Fl E
use $EDITOR for internal undetached edits
.Pp
2019-12-14 08:36:00 +00:00
.Fl g
use regex filters instead of substring match
.Pp
.Fl H
show hidden files
.Pp
2019-10-11 15:56:03 +00:00
.Fl K
test for keybind collision
.Pp
2019-07-14 17:30:14 +00:00
.Fl n
start in navigate-as-you-type mode
2019-07-14 17:30:14 +00:00
.Pp
.Fl o
open files only on Enter key
.Pp
2018-11-23 17:11:47 +00:00
.Fl "p file"
copy (or \fIpick\fR) selection to file, or stdout if file='-'
.Pp
2019-12-14 17:58:13 +00:00
.Fl Q
2020-01-15 05:39:51 +00:00
disable confirmation on quit with multiple contexts active
2019-12-14 17:58:13 +00:00
.Pp
.Fl r
2020-01-15 05:39:51 +00:00
show cp, mv progress
(Linux-only, needs advcpmv; '^T' shows the progress on BSD/macOS)
.Pp
2019-12-01 17:30:06 +00:00
.Fl R
disable rollover at edges
.Pp
.Fl "s name"
load a session by name
.Pp
.Fl S
start in disk usage analyzer mode
2017-04-13 13:43:33 +00:00
.Pp
.Fl "t secs"
idle timeout in seconds to lock terminal
.Pp
2017-04-13 13:43:33 +00:00
.Fl v
2019-12-28 05:45:38 +00:00
use case-insensitive version compare to sort files
2017-04-14 18:44:25 +00:00
.Pp
.Fl V
2019-12-28 05:45:38 +00:00
show version and exit
.Pp
.Fl x
2020-01-15 05:39:51 +00:00
show notis on selection cp, mv, rm completion
copy path to system clipboard on select
.Pp
2017-04-14 18:44:25 +00:00
.Fl h
show program help and exit
2014-10-22 11:52:45 +00:00
.Sh CONFIGURATION
2020-01-15 05:39:51 +00:00
There is no configuration file. Associated files are at
.Pp
\fB${XDG_CONFIG_HOME:-$HOME/.config}/nnn/\fR
.Pp
2020-01-15 05:39:51 +00:00
Configuration is done using a few optional (set if you need) environment
variables. See ENVIRONMENT section.
.Pp
.Nm
uses \fIxdg-open\fR (on Linux), \fIopen(1)\fR (on macOS), \fIcygstart\fR on
(Cygwin) and \fIopen\fR on (Haiku) as the desktop opener. It's also possible
to specify a custom opener. See ENVIRONMENT section.
2018-11-08 12:59:38 +00:00
.Sh CONTEXTS
2020-01-15 05:39:51 +00:00
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:
2018-11-08 12:59:38 +00:00
.Pp
2019-08-21 02:13:15 +00:00
- the current context is in reverse video
2018-11-08 12:59:38 +00:00
.br
2019-03-23 14:14:07 +00:00
- other active contexts are underlined
2018-11-08 12:59:38 +00:00
.br
2019-03-23 14:14:07 +00:00
- rest are inactive
2018-11-08 12:59:38 +00:00
.Pp
2020-01-15 05:39:51 +00:00
On context creation, the state of the previous context is copied. Each context
remembers its last visited directory.
2019-03-23 14:14:07 +00:00
.Pp
2020-01-15 05:39:51 +00:00
Each context can have its own directory color specified. See ENVIRONMENT
section.
.Sh SESSIONS
2020-01-15 05:39:51 +00:00
Sessions are a way to save and restore states of work. A session stores the
settings and contexts.
.Pp
Sessions can be loaded dynamically from within a running
.Nm
2019-10-18 22:31:46 +00:00
instance, or with a program option.
.Pp
2020-01-15 05:39:51 +00:00
When a session is loaded dynamically, the last working session is saved
automatically to a dedicated -- "last session" -- session file.
.Pp
All the session files are located by session name in the directory
.Pp
\fB${XDG_CONFIG_HOME:-$HOME/.config}/nnn/sessions\fR
.Pp
"@" is the "last session" file.
2014-10-22 11:52:45 +00:00
.Sh FILTERS
2020-01-15 05:39:51 +00:00
Filters are strings to find matching entries in the current directory
instantly (\fIsearch-as-you-type\fR). There is a program option to switch to
regex filters. Matches are case-insensitive by default. In each context the
last filter is persisted at runtime or in saved sessions.
2020-01-11 05:53:57 +00:00
.Pp
2020-01-15 05:39:51 +00:00
Special keys at empty filter prompt:
.Pp
- toggle between string and regex: '/'
.br
- toggle case sensitivity: ':'
2020-01-11 05:53:57 +00:00
.br
2020-01-15 05:39:51 +00:00
- apply the last filter (or clear filter if non-empty): '^L'
2020-01-11 10:42:34 +00:00
.br
2020-01-15 05:39:51 +00:00
- show help and config screen: '?'
.br
- show command prompt: ']'
.br
- launch an application: '='
.br
- run a plugin by its key: ';'
.br
- pin current directory: ','
2014-10-22 11:52:45 +00:00
.Pp
2020-01-15 05:39:51 +00:00
Other noteworthy keys:
.Pp
- '^char': usual keybind functionality
.br
- 'Esc': exit filter prompt but skip dir refresh
2020-01-12 08:35:33 +00:00
.Pp
2019-12-14 08:36:00 +00:00
Common regex use cases:
.Pp
2020-01-15 05:39:51 +00:00
(1) To list all matches starting with the filter expression,
start the expression with a '^' (caret) symbol.
.br
2019-12-10 12:55:00 +00:00
(2) Type '\\.mkv' to list all MKV files.
2018-05-01 04:39:10 +00:00
.br
(3) Use '.*' to match any character (\fIsort of\fR fuzzy search).
.Pp
In the \fInavigate-as-you-type\fR mode directories are opened in filter mode,
2017-06-04 17:45:08 +00:00
allowing continuous navigation. Works best with the \fBarrow keys\fR.
.br
2019-09-28 15:08:41 +00:00
When there's a unique match and it's a directory,
.Nm
2020-01-15 05:39:51 +00:00
auto selects the directory and enters it in this mode. Use the relevant
program option to disable this behaviour.
2019-04-21 18:37:48 +00:00
.Sh SELECTION
2019-12-13 18:47:16 +00:00
There are 3 groups of keybinds to add files to selection:
.Pp
2020-01-15 05:39:51 +00:00
(1) hovered file selection toggle (deselects if '+' is visible before the
entry, else adds to selection)
.br
2020-01-15 05:39:51 +00:00
(2) add a range of files to selection (repeat the range key on the same entry
twice to clear selection completely)
2019-10-06 14:22:30 +00:00
.br
(3) add all files in the current directory to selection
2019-09-29 17:29:27 +00:00
.Pp
A selection can be edited, copied, moved, removed, archived or linked.
2019-11-29 15:28:12 +00:00
.Pp
2020-01-15 05:39:51 +00:00
Absolute paths of the selected files are copied to \fB.selection\fR file in
the config directory.
.Pp
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. Editing doesn't
end the selection mode. You can add more files to the selection and edit the
list again. If no file is selected in the current session, this option attempts
to list the selection file.
.Sh UNITS
The minimum file size unit is byte (B). The rest are K, M, G, T, P, E, Z, Y
(powers of 1024), same as the default units in \fIls\fR.
2015-11-26 15:03:26 +00:00
.Sh ENVIRONMENT
The SHELL, EDITOR (VISUAL, if defined) and PAGER environment variables are
used. A single combination of arguments is supported for SHELL and PAGER.
2016-08-21 08:28:53 +00:00
.Pp
2019-12-29 17:51:18 +00:00
\fBNNN_OPENER:\fR specify a custom file opener.
.Bd -literal
export NNN_OPENER=nuke
NOTE: `nuke` is a file opener available in plugin repository
.Ed
.Pp
2020-01-15 05:39:51 +00:00
\fBNNN_BMS:\fR bookmark string as \fIkey_char:location\fR pairs
(max 10) separated by \fI;\fR:
2017-06-11 04:15:50 +00:00
.Bd -literal
2018-11-11 21:34:17 +00:00
export NNN_BMS='d:~/Documents;u:/home/user/Cam Uploads;D:~/Downloads/'
NOTE: To go to a bookmark, press the Lead key followed by the bookmark key.
.Ed
.Pp
2020-01-15 05:39:51 +00:00
\fBNNN_PLUG:\fR directly executable plugins as \fIkey_char:location\fR pairs
(max 15) separated by \fI;\fR:
.Bd -literal
2020-01-15 05:39:51 +00:00
export NNN_PLUG='o:fzopen;p:mocplay;d:diffs;m:nmount;t:imgthumb'
2019-12-29 17:51:18 +00:00
NOTES:
1. To run a plugin directly, press \fI;\fR followed by the plugin key
2020-01-30 18:08:36 +00:00
2. To skip directory refresh after running a plugin, prefix with \fB-\fR
2019-12-29 17:51:18 +00:00
export NNN_PLUG='m:-mediainfo'
2017-06-11 04:15:50 +00:00
.Ed
.Pp
2019-11-20 21:08:34 +00:00
To assign keys to arbitrary non-background non-shell-interpreted cli
2020-01-15 05:39:51 +00:00
commands and invoke like plugins, add \fI_\fR (underscore) before the
command.
.Bd -literal
2020-01-15 05:39:51 +00:00
export NNN_PLUG='x:_chmod +x $nnn;g:_git log;s:_smplayer $nnn;o:fzopen'
NOTES:
2019-11-23 20:43:27 +00:00
1. Use single quotes for $NNN_PLUG so $nnn is not interpreted
2020-01-15 05:39:51 +00:00
2. $nnn should be the last argument (IF used)
2019-12-29 17:51:18 +00:00
3. (Again) add \fB_\fR before the command
2020-01-15 05:39:51 +00:00
4. To disable directory refresh after running a \fIcommand as plugin\fR,
prefix with \fB-_\fR
2019-12-29 17:51:18 +00:00
5. To skip user confirmation after command execution, suffix with \fB*\fR
export NNN_PLUG='y:-_sync*'
2020-01-30 18:08:36 +00:00
6. To run a \fIGUI app as plugin\fR, add a \fB|\fR after \fB_\fR
export NNN_PLUG='m:-_|mousepad $nnn'
EXAMPLES:
----------------------------------- + -------------------------------------------------
Key:Command | Description
----------------------------------- + -------------------------------------------------
2020-01-15 04:12:23 +00:00
e:-_vi $nnn* | Edit hovered file in vi
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
2020-01-15 04:12:23 +00:00
p:-_less -iR $nnn* | Page through hovered file in less
2020-01-30 18:08:36 +00:00
s:-_|smplayer -minigui $nnn | Play hovered media file, even unfinished download
x:_chmod +x $nnn | Make the hovered file executable
y:-_sync* | Flush cached writes
----------------------------------- + -------------------------------------------------
.Ed
2017-06-11 04:15:50 +00:00
.Pp
2020-01-18 15:31:27 +00:00
\fBNNN_COLORS:\fR string of color codes for each context, e.g.:
2018-12-03 16:14:33 +00:00
.Bd -literal
2020-01-18 15:31:27 +00:00
export NNN_COLORS='1234'
2018-12-03 16:14:33 +00:00
codes: 0-black, 1-red, 2-green, 3-yellow, 4-blue (default), 5-magenta, 6-cyan, 7-white
.Ed
.Pp
2020-01-18 15:31:27 +00:00
\fBNNN_SSHFS:\fR pass additional options to sshfs command:
2019-06-24 16:15:02 +00:00
.Bd -literal
2020-01-18 15:31:27 +00:00
export NNN_SSHFS='sshfs -o reconnect,idmap=user,cache_timeout=3600'
2019-06-24 16:15:02 +00:00
NOTE: The options must be preceded by `sshfs` and comma-separated without any space between them.
.Ed
.Pp
2020-01-18 15:31:27 +00:00
\fBNNN_RCLONE:\fR pass additional options to rclone command:
2019-11-24 15:52:44 +00:00
.Bd -literal
2020-01-18 15:31:27 +00:00
export NNN_RCLONE='rclone mount --read-only --no-checksum'
2019-11-24 15:52:44 +00:00
NOTE: The options must be preceded by `rclone` and max 5 flags are supported.
.Ed
.Pp
2019-03-09 03:13:56 +00:00
\fBNNN_TRASH:\fR trash (instead of \fIdelete\fR) files to desktop Trash.
2019-03-02 11:23:16 +00:00
.Bd -literal
export NNN_TRASH=1
.Ed
2019-10-06 14:22:30 +00:00
.Pp
2020-01-15 05:39:51 +00:00
\fBnnn:\fR this is a special variable set to the hovered entry before executing
a command from the command prompt or spawning a shell.
2014-10-22 13:59:15 +00:00
.Sh KNOWN ISSUES
2019-09-28 15:08:41 +00:00
.Nm
2020-01-15 05:39:51 +00:00
may not handle keypresses correctly when used with tmux (see issue #104 for
more details). Set \fBTERM=xterm-256color\fR to address it.
2014-10-22 11:52:45 +00:00
.Sh AUTHORS
2019-09-28 15:08:41 +00:00
.An Arun Prakash Jana Aq Mt engineerarun@gmail.com ,
.An Lazaros Koromilas Aq Mt lostd@2f30.org ,
2019-09-28 15:08:41 +00:00
.An Dimitris Papastamos Aq Mt sin@2f30.org .
2017-03-31 02:52:51 +00:00
.Sh HOME
2017-04-01 05:18:18 +00:00
.Em https://github.com/jarun/nnn