mirrors/nnn
1
0
Fork 0
mirror of https://github.com/jarun/nnn.git synced 2024-11-18 08:59:14 +00:00
Code Issues Packages Projects Releases Wiki Activity
n³ The unorthodox terminal file manager
3553 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
KlzXS c0dceb18c6
Persistent selection (#1086) 
* Add persistsel

* Fix Makefile spacing

* Update Haiku Makefile

* Do a double pass on inversion

* Split single and double pass for easier testing

Removed lastappendpos

Eliminate suffix matches

* Check if dir is in selection before searching for files

Fix double pass

* Switch to mainline

Optimize memory moving

Handle large selection in invertsel()

Going forward with 2pass

* Update Makefiles

* Fix style

* Move forward declarations

* Remove edit selection in inversion

Replace buf with g_buf to fix CI

Fix CI

* Style changes

* Comment the code

* Style fixes

* Fix infinite loop

* Fix crash on empty invert

* Fix off-by-one-in-two-places

Off-by-twice?

* Adopt changes from master

* Only check directory if entry in it is selected

* Better organization

* Wrong variable

* Tiny optimizations

* Style fixes and updated man page

* Update man page

* Remember where we found directory path in selection

Add in progress message on invert
2021-07-10 07:30:02 +05:30
.circleci Prepare for release v4.1.1 Sake 2021-06-03 22:36:19 +05:30
.github Fix template 2021-05-11 22:53:37 +05:30
misc Persistent selection (#1086) 2021-07-10 07:30:02 +05:30
patches Remove gitstatus libgit2 dependency 2021-07-06 02:01:19 +02:00
plugins Allow tmux inside kitty without KITTY_LISTEN_ON set 2021-07-05 15:40:18 +02:00
src Persistent selection (#1086) 2021-07-10 07:30:02 +05:30
.gitignore Move config.h to nnn.h 2017-09-02 11:39:44 +05:30
CHANGELOG Checkpatch fixes 2021-06-10 00:31:17 +05:30
LICENSE Update copyright year 2020-12-29 02:34:23 +05:30
Makefile Persistent selection (#1086) 2021-07-10 07:30:02 +05:30
nnn.1 Persistent selection (#1086) 2021-07-10 07:30:02 +05:30
README.md Update docs 2021-06-25 23:57:28 +05:30

README.md

nnn
nnn - Supercharge your productivity!

Latest release Availability CircleCI Status GitHub CI Status Privacy Awareness License

[Features] [Quickstart] [Plugins] [Wiki]

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

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 to extend the capabilities further e.g. preview, (un)mount disks, find & list, file/dir diff, upload files. A patch framework hosts sizable user-submitted patches which are subjective in nature.

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.

(there's more)

Donate via PayPal!

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
    • 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)
    • 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
    • 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 on cp, mv, rm completion
    • Copy file paths to system clipboard on select
    • Launch apps, run commands, spawn a shell, toggle exe
    • Access hovered file 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. Install nnn and any dependencies 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. Sync subshell $PWD to nnn.
  5. Install plugins.
  6. Use -x to sync selection to system clipboard, show notis on cp, mv, rm completion and set xterm title.
  7. For a CLI-only environment, customize and use plugin nuke with option -c (overrides -e).
  8. Bid ls goodbye! alias ls='nnn -de' 😎
  9. Visit the Live previews and Troubleshooting Wiki pages.

Don't memorize! Arrows, /, q suffice. Tab creates and/or cycles contexts. ? lists shortcuts.

Wiki

Videos

Elsewhere

Developers

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