Table of Contents
Wrong file opener
If your text files are opening in the browser, check out the program option -e.
Use the following command to set default applications for mimetypes when using xdg-open as opener:
xdg-mime default application mimetype(s)
e.g.
xdg-mime default sxiv.desktop image/jpeg image/png
If your system uses mimeopen, you may have to install perl-file-mimeinfo.
More on default applications and openers.
Broken file names
If unicode characters are not showing correctly, please check the following:
- Ensure locale support is not compiled out
- Check locale settings (see https://github.com/jarun/nnn/issues/1145)
- Confirm the DE isn't blocking it (see https://github.com/jarun/nnn/issues/1139)
Tmux configuration
Keyboard
nnn may not handle keypresses correctly when used with tmux (see issue #104 for more details). Set TERM=xterm-256color to address it.
By default tmux advertises 8-color support. To show icons in tmux add the following to tmux configuration file:
set -g default-terminal "screen-256color"
If compiled with netbsd-curses set it to:
set -g default-terminal "xterm-256color"
If the Esc key isn't working as expected, add the following in .tmux.conf:
set -g escape-time 0
To start nnn within tmux use a shell function:
n ()
{
if [ -n "$TMUX" ]; then
nnn -a $@
else
tmux -u new-session nnn -a $@
fi
}
New window/pane using cwd
nnn does not set the terminal's cwd while navigating. So the following may not work:
tmux new-window -c "#{pane_current_path}"
One possible workaround is to extract the path from the cwd command that nnn uses:
lsof -c nnn | grep cwd
To get the path on the last executed cwd command:
lsof -w -c nnn | grep cwd | tail -n 1 | awk '{print $9}'
A script exampletmux_split_curdir.sh:
#!/usr/bin/env sh
cwd=
cc=$(tmux display -p '#{pane_current_command}')
if [ $cc == "nnn" ] ; then
cwd=$(lsof -w -c nnn | grep cwd | tail -n 1 | awk '{print $9}')
else
cwd=$(tmux display -p '#{pane_current_path}')
fi
tmux split-window -c "$cwd"
Adding this script to your tmux path allows it to be run with run-shell:
bind -n KEYS run-shell "tmux_split_curdir.sh"
Broken control key
If a Ctrl-key combination is not working, check if it's masked due to terminal line settings:
stty -a
If that's the case, clear (undef) the setting. E.g.:
stty start undef
stty stop undef
stty lwrap undef
stty lnext undef
You can do this when starting nnn. See the quitcd scripts.
Help not showing
If your PAGER is less, remove the option -F (automatically exit if the entire file can be displayed on the first screen). There are other screens which use less as well.
Note that the less command takes its default parameters from the $LESS environment variable, so you may need to remove -F from your shell
initialization.
Default batch rename limits
TL;DR: If you need a full-featured batch-renamer, install plugins. nnn auto-detects and invokes the internal plugin .nmv (a bash script) which is feature-complete.
The in-built batch-renamer implemented in nnn is a very simplified one. It's single-pass - reads the name/path of files iteratively (from a list of source files) and renames/moves them (as specified in the corresponding line number in a list of renamed/destination files). It doesn't handle deletions or perform any pre-parsing to account for rename loops, swaps, replaces, etc.
Note that the instance of the editor must wait for the editing to complete and the changes to be saved (e.g. use -w with VSCode).
Misaligned size column
We have seen this issue with WSL and Putty where sometimes repeated space characters are not printed correctly.
To fix this:
export TERM=rxvt-unicode
// OR
export TERM=rxvt-unicode-256color
Detailed explanation.
Can't list within list
List view is a temporary view of symlinks. To avoid remembering the temporary paths to all listed views the current path is removed when the next list is loaded. This is also inline with the fact that find doesn't look within symlinks to directories. If you need to search the entries within a loaded list, visit the original directory and run the refined search.
BSD terminal issue
TL;DR: On releases previous to v2.7, use the keybind K to toggle selection if you are having issues with ^Y.
On OpenBSD & FreeBSD (and probably on macOS as well) stty maps ^Y to DSUSP by default. This means that typing ^Y will suspend nnn as if you typed ^Z (you can bring nnn back to the foreground by issuing fg) instead of entering multi-selection mode. You can check this with stty -a. If it includes the text dsusp = ^Y, issuing stty dsusp undef will disable this DSUSP and let nnn receive the ^Y instead.
Amethyst WM
There's a known issue with Amethyst window manager on macOS - redraws do not work correctly and the screen breaks. See issue #521 for more details.
Running inside docker containers
When run inside docker container nnn exits instantly. The solution is to create the container with the flag --init.
Icons not working properly
Ensure that the primary font of your terminal is set to a suitable one (e.g when using O_NERD, primary font should be a nerd font).
Also ensure that your system's locale is set up properly.
When using ST some icons may appear truncated. A patch fixing this issue is available in a reddit thread here.
Wrong/Bad sorting order (#1652)
nnn respects the environmental LC_COLLATE value - the effect of this depends on your libc. Try setting it to something standard/well-supported such as "C" or "C.UTF8" and see if that fixes the issue or not.
Wiki Home
Usage
Concepts
How to
- The nnn magic!
- Add bookmarks
- Configure cd on quit
- Sync subshell
$PWD - Hot-plugged drives
- Image, video, pdf
- Detached text
- Run commands
- Launch applications
- Open as root
- File picker
- Remote mounts
- Synced quick notes
- Drag and drop
- Duplicate file
- Create batch links
- Hidden files on top
- Disable bold fonts
- Themes
Advanced
- Live previews
- File icons
- Custom keybinds
- CLI-only opener
- Desktop integration
- cp mv progress
- Control active dir
- Termux tips
- Pager as opener
- Working with lftp
- Power toys
Troubleshooting
- Wrong file opener
- Broken file names
- Tmux configuration
- Broken control key
- Help not showing
- Default batch rename limits
- Misaligned size column
- Can't list within list
- BSD terminal issue
- Amethyst WM
- Running inside docker containers
- Icons not working properly