nnn

Rating: 
5
Your rating: None Average: 5 (3 votes)

nnn (or ) is a full-featured terminal file manager. It's tiny and nearly 0-config with an incredible performance. See it in action on SFOS with dir/file preview enabled: https://asciinema.org/a/336443 (instructions for preview plugin on SFOS in the link).

nnn can analyze disk usage, batch rename, launch apps,  pick files, archive and decompress in various formats, bookmark, run batch operations, use SSHF, and a lot more. 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. nnn supports several tabs (contexts) with different colours, as well as multipane and cross-pane copy/paste in combination with tmux. viu (soon) can be used to preview images directly in terminal (example in screenshots).

Despite its capabilities, nnn is designed to be easy to use and is configured by way of enrivonment variables without a configuration file. Set options in your ~/.bashrc. It is very likely that nnn can do what you want already, but perhaps it is not default. Go see the wiki: https://github.com/jarun/nnn/wiki/. By default, nnn uses "rm" to delete files. If you find it too scary, you can install install Python tools (install pip with "devel-su zypper install python3-pip") to then install trash-cli with "devel-su easy_install trash-cli", and then enable the trash-cli support in nnn (see wiki).

On SailfishOS, nnn is most convenient with a hardware keyboard, but works too with the terminals featuring a virtual keyboard. nnn is very useful if you often ssh into your device too.

# Usage

nnn

 

# Black magic!
- Load, sort, filter thousands of files instantly
- Type to navigate with automatic dir selection
- Select files from anywhere (not just a single dir)
- Never lose context - start where you quit nnn
- Edit and preview markdown, man page, html
- Open a file and auto-advance to the next
- Export (filtered) list of visible files
- find/fd/grep/ripgrep/fzf from nnn and list in nnn
- Unlimited bookmarks, plugins, cmds with custom hotkeys
- Write a plugin in any language you know
- 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
- Open text files detached in another pane/tab/window
- Create files/dirs/duplicates with parents (like mkdir -p)
- Toggle hidden with ., visit HOME with ~, last dir with -
- Pin a frequently visited dir at runtime
- Mount any cloud storage service in a few keypresses
- Mount and modify archives
- Filter filtered entries
- Sort files by access time and inode change time
- Access selection from another instance of nnn
- Compile out features you don't need
- 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; pin 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

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

See details at https://github.com/jarun/nnn/.

# Disclaimer
I am not the developer of nnn, I just packaged it for SFOS. nnn is being (very) actively developed by Arun Prakash Jara and contributors but that does not include the SFOS package, which may or may not be updated in the future.

Screenshots: 
Application versions: 
AttachmentSizeDate
File nnn-3.2-1.armv7hl.rpm43.34 KB03/06/2020 - 01:21
Changelog: 

- First SFOS package based on the 3.2 release.

Comments

objectifnul's picture

Dependency error (Sfos 4.4)

Kabouik's picture

Thanks for warning me. Unfortunately I'm not in 4.4 yet so I can't really investigate which dependency no longer is available, but I should be when my Pro1x arrives (if SFOS works immediately). In the mean time, I recommend you try to compile it directly from sources, there's detailed instructions on `nnn`'s git page and it's relatively easy. 

levone1's picture

Seems like it's a terminal limitation... I tested on Linux, and same pixelly look with Termit, but loiks great with Kitty... I've been using Literm/Tmux in SFOS - would it look better with Havoc?*edit* just saw your issue here - https://github.com/atanunq/viu/issues/45 . Probably same thing...

levone1's picture

Ok, got it - after dealing with tput issue, preview works. Thanks

Kabouik's picture

Glad you got it working! Yes, I have tput installed.

I am using aarch64 too but compiled armv7hl for compatibility with more SFOS phones and that binary works on mine, but I should definitely add the proper architecture here. Perhap when I upgrade the package, which is very much needed.

If you compiled directly from sources, it is likely that the plugins in this package are partly outdated. You could use the getplug executable to fetch new plugin versions. But if you run the relatively old package from openrepos, then it is best to keep the packages bundled with it.

levone1's picture

Thanks - one more question. .. My preview tui is working with photos, having built and installed Viu, but photos are very pixelly, like extremely low-res. I can't even make out any detail. It's like 40x40 or something . I saw the instruction about adding the line to bashrc, (...colorterm..), and did it, but not any better...

levone1's picture

Just found this - https://github.com/jarun/nnn/issues/617
Going to try some fixes...
I saw this comment -
`Well we don't do anything directly with $TERM, we just use tput (part of ncurses) in a few plugins ...` and I realizes that I have no tput command, though ncurses/ncurses-devel are installed. Are you using ncurses from Jolla? Do you have tput command?

levone1's picture

Also - no plugins functioning as expected. Keys are exported, and fifo set, but when pressing ';(whatever)', the screen just flashes some text, but too fast to read it, and then back to main screen... Anyone else have plugins working?

Kabouik's picture

Does that happen with all your plugins? I suspect the issue is the plugin you're trying to use because my plugins do work with the `;` prefix. Maybe try with the most minimal plugins first. Some may fail on SFOS because they have dependencies that have not been compiled yet. 

You could maybe quit `nnn` after the issue or use `!` to see the shell and see if there are warnings/errors there. 

Also, in all honesty, I really need to update this `nnn` package. It is now old and `nnn` has ben heavily improved since I packaged it. Some new plugins are also quite useful. But plugins should work even with this version. Could you show how you exported the keybindings for plugins?

levone1's picture

I have worked out a couple of kinks, and now can get some plugins to function, (finder and others work normally, others show normal errors about missing a package or something), but still no go with previews. I followed the link to asciinema video, and checked instructions there. I have all "dependencies" installed, but not all "optionals".... Anyway, I mainly wonder if there's a way to get some kind of output when trying to run the plugin, to se what tje problem is.
Thanks
BTW - I'm using aarch64, so I built from source from here - https://www.google.com/url?sa=t&source=web&cd=&ved=2ahUKEwiez9ra9pzyAhWY...

levone1's picture

Can anyone tell me how to show line numbers when using 'e' option for editor? I have 'set number' in my vimrc file, and the numbers show when opening from a terminal, but I can't get it to show while editing in nnn...(I tried ':set number' etc, but no change)

Kabouik's picture

I am using kakoune and I have to set line numbers in my kakrc file to make it work, but this works when using `e` in `nnn` as well. Can you check whether `$EDITOR` is indeed set to the correct executable in your environment? Maybe you use `vim` manually from command line and your `$EDITOR` is in fact `vi` and uses a different rc file, maybe? `nnn` will always pick the `$EDITOR`.

levone1's picture

Thanks - yes editor is set in env to /usr/bin/vim. When I manually use either vi or vim from a terminal, line #s are automatically there, with the edit to vimrc. I still haven't been able to get them in nnn...

Kabouik's picture

Are there other settings from your vimrc file that are ignored in nnn? It would be good to determine whether just line numbers are not shown, or if the whole vimrc file is ignored. At least I can confirm it works with kakoune and its kakrc, with nnn version from this package. If you compiled nnn from sources, it is probably better to ask on github.com/jarun/nnn directly as this may be due to later commits. 

levone1's picture

Ok - I'll check it out