4 Power toys

Mischievous Meerkat edited this page 2020-04-10 18:50:27 +05:30

Table of Contents

• 1. Pin a frequently visited directory
• 2. Filter filtered entries
• 3. Mount and modify archives
• 4. Hovered file path in $nnn
• 5. Preview and edit files
• 6. Redirect selection to a command
• 7. Prompt shortcuts
• 8. Run custom commands with hotkeys

1. Pin a frequently visited directory

If you need to repeat a directory repeatedly, you can pin it during a session using the shortcut ,. When you have a pinned directory, pressing the bookmark key (b or ^/) will list , as the first key:

bookmark keys: , w t m i d v n

Press , after the bookmark key to visit the pinned directory.

You can pin one directory at a time.

2. Filter filtered entries

Filtering is the nnn way to search files in a directory. Did you know it's possible to apply a new filter on already filtered results?

• Go to a directory
• Press filter key (/) and type a filter
• Press Esc or Up or Down (the filter will disappear from the status bar)
• Press filter key again
• Type a new filter to find matches in the earlier filtered results

3. Mount and modify archives

nnn provides you an option to mount archives when you press Enter on an archive. Press m to mount the archive and nnn will mount the archive and take you to the mountpoint of the mounted archive.

Add some files in the mounted archive, go back to the nnn config directory (${XDG_CONFIG_HOME:-$HOME/.config}/nnn) and hover on the archive mount point. Press u to unmount the archive and generate a package with the new files. The original package is saved with the extension .orig.

4. Hovered file path in $nnn

nnn exports the hovered file path as $nnn when you press the command prompt or spawn shell shortcuts. You can use the variable to run a command on the hovered file:

ls -l "$nnn"

5. Preview and edit files

You can easily edit and view the changes to Markdown, man pages etc. in nnn. For this you need to use a CLI file opener. You can use plugin nuke, a customizable example opener to specify your preferred apps. To set nuke as the default opener:

export NNN_OPENER=/absolute/path/to/nuke

and start nnn as nnn -c.

The option -c indicates to nnn that the opener is a CLI-only opener (note that nuke can open files in GUI apps as well; please read the documentation in the file).

Now when you press Enter on a Markdown file nuke will try to open it in glow or a man page in man.

To edit the file in $VISUAL (or $EDITOR, or vi), hover on the file and press e.

6. Redirect selection to a command

nnn allows users to select a file at a time, a range of files or all files in a directory together. Once you are done selecting, you can run a command on all the files by using the selection file as input:

xargs -0 ls -l < "${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection"

If you are using this frequently, have a shortcut in your rc file:

export sel=${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection

and simplify the command as:

xargs -0 ls -l < $sel

Many plugins work this way!

7. Prompt shortcuts

Even if you compile nnn without libreadline, the native input prompts support several readline-like keys - ^A, ^B, ^D, ^E, ^F, ^K, ^U, ^W.

8. Run custom commands with hotkeys

nnn allows you to run custom commands like plugins. For example, to open a log file in lnav, add a plugin-ish key:command pair in your NNN_PLUG environment variable:

export NNN_PLUG='l:-_lnav $nnn*'

Press ; (select plugin shortcut) followed by l to open a log file in lnav.

You can control several aspects while running commands and plugins (e.g., skip dir refresh after running a plugin, skip user confirmation after running a command) and even run GUI apps as a plugin. Visit plugins for more details.

Note: lnav was taken as an example, you can easily open log files in lnav by editing the customizable sample opener nuke.

Wiki Home

Usage

1. Dependencies
2. Installation
3. Configuration
4. Program options
5. Keyboard, mouse
6. Symbols
7. File size
8. Help

Concepts

1. Contexts
   • Dual pane
2. Sessions
3. Filters
4. Type-to-nav
5. Selection
6. Find and list
7. Prompts
8. Design

How to

1. The nnn magic!
2. Add bookmarks
3. Configure cd on quit
4. Sync subshell $PWD
5. Hot-plugged drives
6. Image, video, pdf
7. Detached text
8. Run commands
9. Launch applications
10. Open as root
11. File picker
12. Remote mounts
13. Synced quick notes
14. Drag and drop
15. Duplicate file
16. Create batch links
17. Hidden files on top
18. Disable bold fonts
19. Themes

Advanced

1. Live previews
2. File icons
3. Custom keybinds
4. CLI-only opener
5. Desktop integration
6. cp mv progress
7. Control active dir
8. Termux tips
9. Pager as opener
10. Working with lftp
11. Power toys

Troubleshooting

1. Wrong file opener
2. Broken file names
3. Tmux configuration
4. Broken control key
5. Help not showing
6. Default batch rename limits
7. Misaligned size column
8. Can't list within list
9. BSD terminal issue
10. Amethyst WM
11. Running inside docker containers
12. Icons not working properly

Stats, info

1. Performance
2. From noice to nnn

Developer

1. Release checklist
2. Verify sources
3. make options
4. Static compilation
5. Optimization tips
6. Compile for Pi
7. Cygwin instructions
8. Compile with musl libc
9. Cross-compile for Android
10. Debugging nnn

Top ⬆
Wiki Home 📓
Project Home 🐴