mirrors/nnn
1
0
Fork 0
mirror of https://github.com/jarun/nnn.git synced 2024-11-24 11:51:27 +00:00
Code Issues Packages Projects Releases Wiki Activity
n³ The unorthodox terminal file manager
3086 commits 1 branch 41 tags 12 MiB
C 64.7%
Shell 26.3%
Roff 3.5%
Makefile 3.2%
C++ 1.5%
Other 0.7%
Go to file
Mischievous Meerkat d54033089c
Merge pull request #804 from angelskieglazki/master 
Update config.yml
2020-11-23 22:50:55 +05:30
.circleci Update config.yml 2020-11-23 20:15:48 +03:00
.github Integrate GH CI, retire Travis 2020-11-22 03:03:24 +05:30
misc Revert to dev tag 2020-11-17 08:55:12 +05:30
plugins use $VISUAL environment variable for plugins 2020-11-22 16:18:06 +00:00
src Fix build error 2020-11-22 03:58:37 +05:30
.gitignore Move config.h to nnn.h 2017-09-02 11:39:44 +05:30
CHANGELOG Prepare for release v3.5 Freddie 2020-11-17 08:19:09 +05:30
LICENSE Update copyright year 2019-12-31 22:42:10 +05:30
Makefile upx compress all static binaries before upload 2020-11-14 10:56:18 +05:30
nnn.1 Prepare for release v3.5 Freddie 2020-11-17 08:19:09 +05:30
README.md Integrate GH CI, retire Travis 2020-11-22 03:03:24 +05:30

README.md

nnn
nnn - Supercharge your productivity!

Latest release Availability CircleCI Status GitHub CI Status Privacy Awareness License

icons and colors asciicast

[Features] [Quickstart] [Plugins] [Documentation]



nnn (n³) is a full-featured terminal file manager. It's tiny and nearly 0-config with an incredible speed.

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

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, (un)mount disks, find & list, file/dir diff, upload files.

There are 2 independent (neo)vim plugins - nnn.vim and vim-floaterm nnn wrapper.

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

Expand for some nnn magic! 🕶️
  • Instantly load, sort, filter thousands of files
  • Type to navigate with automatic dir selection
  • List input stream and pick entries to stdout or file
  • find/fd/grep/ripgrep/fzf from nnn and list in nnn
  • Never lose context - start where you quit
  • 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 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 variables
  • Watch matrix text fly or read fortune messages
  • Configure in 5 minutes!

Donate via PayPal!

Features

  • 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, comfortable on handhelds too!
    • 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 look-up
    • 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 name, access/change/mod (default) time, size, extn
    • Reverse sort
  • Mimes
    • Preview hovered files in FIFO-based previewer
    • Open with desktop opener or specify a custom opener
    • File-specific colors (or minimal dirs in context color)
    • Icons (customize and compile-in)
    • Plugins for image and video thumbnails
    • 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 file list from stdin or plugin
    • 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 files and dirs
    • Launch apps, run commands, spawn a shell, toggle exe
    • 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 any dependecies you need. 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 if you wish.
  3. Configure cd on quit.
  4. Install 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 with option -c (overrides -e).
  7. Bid ls goodbye! alias ls='nnn -de' 😎

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

Videos