nnn - supercharge your productivity!

navigate-as-you-type & du (click to see demo video)

Introduction

nnn is a full-featured terminal file manager. It's tiny and nearly 0-config with an incredible performance.

nnn is also a du analyzer, an app launcher, a batch renamer and a file picker. The plugin repository has tons of plugins and documentation to extend the capabilities further. You can plug new functionality and play with a hotkey. There's an independent (neo)vim plugin.

It runs smoothly on the Pi, Termux, Linux, macOS, BSD, Haiku, Cygwin, WSL, across DEs and GUI utilities or a strictly CLI environment.

Wiki.

Features

Resource sensitive
- Typically needs less than 3.5MB resident memory
- Works with 8-bit colors
- Disk-IO sensitive (few disk reads and writes)
- No FPU usage (all integer maths, even for file size)
- Minimizes screen refresh with fast line redraws
- Tiny binary (typically less than 100KB)
Portable
- Language-agnostic plugins
- Minimal library deps, easily compilable, tiny binary
- No config file, minimal config with sensible defaults
- Widely available on many packagers
- Unicode support
Quality
- Privacy-aware (no unconfirmed user data collection)
- POSIX-compliant, follows Linux kernel coding style
- Highly optimized, static analysis integrated code
Modes
- Light (default), detail
- Disk usage analyzer (block/apparent)
- File picker, (neo)vim plugin
Navigation
- Navigate-as-you-type with dir auto-select
- Contexts (aka tabs/workspaces) with custom colors
- Sessions, bookmarks with hotkeys; pin and visit a dir
- Remote mounts (needs sshfs, rclone)
- Familiar shortcuts (arrows, ~, -, @), quick reference
- CD on quit (easy shell integration)
Search
- Instant filtering with search-as-you-type
- Regex (POSIX/PCRE) and string (default) filters
- Subtree search plugin to open or edit files
Sort
- Ordered pure numeric names by default (visit /proc)
- Case-insensitive version (aka natural) sort
- By file name, modification/access time, size, extension
- Reverse sort
Mimes
- Open with desktop opener or specify a custom app
- Create, list, extract, mount (FUSE based) archives
- Option to open all text files in EDITOR
Information
- Detailed file information
- Media information plugin
Convenience
- Run plugins and custom commands with hotkeys
- FreeDesktop compliant trash (needs trash-cli)
- Cross-dir file/all/range selection
- Batch renamer (feature-limited) for selection or dir
- Copy (as), move (as), delete, archive, link selection
- Dir updates, notification on cp, mv, rm completion
- Copy file paths to system clipboard on select
- Create (with parents), rename, duplicate (anywhere) files and dirs
- Launch GUI apps, run commands, spawn a shell, toggle executable
- Hovered file set as $nnn at prompt and spawned shell
- Lock terminal after configurable idle timeout

Quickstart

Install the utilities you may need based on your regular workflows.
Configure cd on quit.
To open text files in $VISUAL (else $EDITOR, fallback vi) add program option -e in your alias.
For additional functionality install plugins.
To copy selected file paths to system clipboard and show notis on cp, mv, rm completion use option -x.
For a strictly CLI environment, customize and use plugin nuke.

Don't memorize! Arrows (or h j k l), /, q suffice. Tab creates, cycles contexts. ? lists shortcuts.

Installation

Library dependencies

A curses library with wide char support (e.g. ncursesw), libreadline (optional) and standard libc.

Utility dependencies

Dependency	Installation	Operation
xdg-open (Linux), open(1) (macOS), cygstart (Cygwin), open (Haiku)	base	desktop opener
file, coreutils (cp, mv, rm), xargs	base	file type, copy, move and remove
tar, (un)zip [atool/bsdtar for more formats]	base	create, list, extract bzip2, (g)zip, tar
archivemount, fusermount(3)	optional	mount, unmount archives
sshfs, rclone, fusermount(3)	optional	mount, unmount remotes
trash-cli	optional	trash files (default action: rm)
vlock (Linux), bashlock (macOS), lock(1) (BSD), peaclock (Haiku)	optional	terminal locker (fallback: cmatrix)
advcpmv (Linux) (integration)	optional	copy, move progress
`$VISUAL` (else `$EDITOR`), `$PAGER`, `$SHELL`	optional	fallback vi, less, sh

From a package manager

Install nnn from your package manager. If the version available is dated try an alternative installation method.

Packaging status (expand)

Unlisted packagers:

● CentOS (yum --enablerepo=epel install nnn)
● Milis Linux (mps kur nnn)
● NuTyX (cards install nnn)
● Source Mage (cast nnn)

Release packages

Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are auto-generated with the latest stable release.

From source

Download the latest stable release or clone this repository (risky), install deps and compile. On Ubuntu 18.04:

$ sudo apt-get install pkg-config libncursesw5-dev libreadline-dev
$ sudo make strip install

PREFIX is supported, in case you want to install to a different location.

See the developer guides for source verification, compilation notes on the Pi, Cygwin and other tips.

Shell completion

Completion scripts for Bash, Fish and Zsh are available. Refer to your shell's manual for installation instructions.

Elsewhere

Developers

0xACE
Anna Arad
KlzXS
Maxim Baz
and other contributors

nnn is actively developed. Visit the to the ToDo list to contribute or see the features in progress.

tdivis / nnn