Skip to content

jarun/nnn

Repository files navigation

nnn
nnn -Supercharge your productivity!

Latest release Availability CircleCI Status GitHub CI Status Privacy Awareness License

nnn() is a full-featured terminal file manager. It's tiny, nearly 0-config andincredibly fast.

It is designed to be unobtrusive with smart workflows to match the trains of thought.

nnncan analyze disk usage, batch rename, launch apps and pick files. The plugin repository has tons of plugins to extend the capabilities further e.g.live previews,(un)mount disks, find & list, file/dir diff, upload files. Apatch frameworkhosts sizable user-submitted patches which are subjective in nature.

Independent (neo)vim plugins -nnn.vim,vim-floaterm nnn wrapperandnnn.nvim(neovim exclusive).

Runs on the Pi,Termux(Android), Linux, macOS, BSD, Haiku, Cygwin, WSL, across DEs or a strictly CLI env.

(there's more)

Features

  • Quality
    • Privacy-aware (no unconfirmed user data collection)
    • POSIX-compliant, follows Linux kernel coding style
    • Highly optimized, static analysis integrated code
  • Frugal
    • Typically needs less than 3.5MB resident memory
    • Works with 8 colors (and xterm 256 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 around 100KB)
    • 1-column mode for smaller terminals and form factors
    • Hackable - compile in/out features and dependencies
  • Portable
    • Language-agnostic plugins
    • Static binary available (no need to install)
    • Minimal library deps, easy to compile
    • No config file, minimal config with sensible defaults
    • Plugin to backup configuration
    • Widely available on many packagers
    • Touch enabled, handheld-friendly shortcuts
    • Unicode support
  • Modes
    • Light (default), detail
    • Disk usage analyzer (block/apparent)
    • File picker, (neo)vim plugin
  • Navigation
    • Filter with automatic dir entry on unique match
    • Type-to-nav(turbo navigation/always filter) mode
    • Contexts (akatabs/workspaces) with custom colors
    • Sessions, bookmarks, mark and visit a dir
    • Remote mounts (needssshfs,rclone)
    • Familiar shortcuts (arrows,~,-,@), quick look-up
    • cdon quit (easyshell integration)
    • Proceed to next file on file open and selection
  • Search
    • Instant filtering withsearch-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 (akanatural) sort
    • By name, access/change/mod (default) time, size, extn
    • Reverse sort
    • Directory-specific ordering
  • Mimes
    • Preview hovered files in FIFO-based previewer
    • Open with desktop opener or specify a custom opener
    • File-specific colors (or minimaldirs in context color)
    • Icons and Emojis support (customize and compile-in)
    • Plugin for image, video and audio thumbnails
    • Create, list, extract (to), mount (FUSE based) archives
    • Option to open all text files in$EDITOR
  • Convenience
    • Detailed file stats and mime information
    • Run plugins and custom commands with hotkeys
    • FreeDesktop compliant trash utility integration
    • Cross-dir file/all/range selection
    • Create (with parents), rename, duplicate files and dirs
    • Create new file or directory (tree) on startup
    • Batch renamer for selection or dir
    • List input stream of file paths from stdin or plugin
    • Copy (as), move (as), delete, archive, link selection
    • Dir updates, notification oncp,mv,rmcompletion
    • Copy file paths to system clipboard on select
    • Launch apps, run commands, spawn a shell, toggle exe
    • Access context paths/files at prompt or spawned shell
    • Lock terminal after configurable idle timeout
    • Capture and show output of a program in help screen
    • Basic support for screen readers and braille displays

Quickstart

  1. Installnnnand the dependencies you need.
  2. The desktop opener is default. Use-eto open text files in the terminal. Optionallyopen detached.
  3. Configurecdon quit.
  4. Sync subshell$PWDtonnn.
  5. Install plugins.
  6. Use-xto sync selection to clipboard, show notis oncp,mv,rmand set xterm title.
  7. For a CLI-only environment, setNNN_OPENERtonuke.Use option-c.
  8. Bidlsgoodbye!alias ls='nnn -de'😎
  9. Visit theLive previewsandTroubleshootingWiki pages.

Don't memorize! Arrows,/,qsuffice.Tabcreates and/or cycles contexts.?lists shortcuts.

Wiki

Videos

Elsewhere

Developers

Visit theTrackerthread for a list of features in progress and anything up for grabs. Feel free todiscussnew ideas or enhancement requests.