Github url

nnn

by jarun

jarun /nnn

n³ The missing terminal file manager for X.

8.4K Stars 336 Forks Last release: about 17 hours ago (v3.3) BSD 2-Clause "Simplified" License 2.9K Commits 25 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

nnn - supercharge your productivity!

Latest releaseAvailabilityTravis StatusCircleCI StatusPrivacy AwarenessLicense

type-to-nav & du (click to see demo video)

Introduction

nnn

(or

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

nnn

can analyze disk usage, batch rename, launch apps and pick files. The plugin repository has tons of plugins and documentation to extend the capabilities further e.g. preview hovered, (un)mount disks, find & list, file/dir diff, upload files. There's an independent (neo)vim plugin.

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

Donate via PayPal!

Black magic! :dark_sunglasses:

  • Instantly load, sort, filter thousands of files
  • Type to navigate with automatic dir selection
  • Never lose context - start where you quit
  • find/fd/grep/ripgrep/fzf from
    nnn
    and list in
    nnn
  • Mount any cloud storage service in a few keypresses
  • Select files from anywhere (not just a single dir)
  • Unlimited bookmarks, plugins, cmds with custom hotkeys
  • Write a plugin in any language you know
  • Edit and preview markdown, man page, html
  • Open a file and auto-advance to the next
  • Filter filtered entries
  • Export (filtered) list of visible files
  • Configure the middle mouse click to do anything
  • Fuzzy search subtree and open a file (or its parent dir)
  • Load four dirs with custom settings at once
  • Notifications on cp, mv, rm completion
  • Auto-sync selection to system clipboard
  • Access selection from another instance of
    nnn
  • Open text files detached in another pane/tab/window
  • Mount and modify archives
  • Create files/dirs/duplicates with parents (like
    mkdir -p
    )
  • Toggle hidden with ., visit HOME with ~, last dir with -
  • Mark a frequently visited dir at runtime
  • Sort by modification, access and inode change time
  • Compile out/in features with make options
  • Watch matrix text fly or read fortune messages
  • Configure in 5 minutes!

Features

  • Frugal
    • 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
    • Statically-linked binary available
    • Language-agnostic plugins
    • Minimal library deps, easy to compile
    • Compile in/out features with make variables
    • 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
    • Type-to-nav mode with dir auto-select
    • Contexts (aka tabs/workspaces) with custom colors
    • Sessions, bookmarks with hotkeys; mark and visit a dir
    • Remote mounts (needs sshfs, rclone)
    • Familiar shortcuts (arrows, ~, -, @), quick reference
    • CD on quit (easy shell integration)
    • Auto-advance on opening files
  • 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, access/change/mod (default) time, size, extension
    • Reverse sort
  • Mimes
    • Open with desktop opener or specify a custom opener
    • Preview hovered files in FIFO-based previewer
    • 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 for selection or dir
    • Display a list of files from stdin
    • 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
    • Basic support for screen readers and braille displays

Quickstart

  1. Install
    nnn
    and deps (if you need any). All files are opened with the desktop opener by default.
  2. Add option ```

-e

 to your alias to open text files in 

$VISUAL

/

$EDITOR

/ vi. [Open detached](https://github.com/jarun/nnn/wiki/Basic-use-cases#detached-text) if you wish.
3. Configure [cd on quit](https://github.com/jarun/nnn/wiki/Basic-use-cases#configure-cd-on-quit).
4. [Install plugins](https://github.com/jarun/nnn/tree/master/plugins#installing-plugins).
5. Use option 

-x

 to copy selected file paths to system clipboard and show notis on cp, mv, rm completion.
6. For a CLI-only environment, customize and use plugin [

nuke

](https://github.com/jarun/nnn/blob/master/plugins/nuke) with option 

-c

 (overrides 

-e

``` ).

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

Wiki

Developers

Visit the ToDo list to contribute or see the features in progress.

Elsewhere

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.