Update lock threads to latest

fix collision in colemak patch

.circleci/config.yml

@@ -0,0 +1,122 @@
+version: 2
+
+jobs:
+  compile:
+    docker:
+      - image: ubuntu:22.04
+        working_directory: ~/nnn
+        environment:
+          CI_FORCE_TEST: 1
+    parallelism: 4
+    steps:
+      - run:
+          command: |
+            apt update -qq
+            DEBIAN_FRONTEND="noninteractive" TZ="America/New_York" apt-get -y install tzdata
+            apt install -y --no-install-recommends software-properties-common wget gpg-agent shellcheck
+            apt install -y --no-install-recommends git make pkg-config libncurses-dev libreadline-dev
+            apt install -y --no-install-recommends gcc-9 gcc-10 gcc-11 gcc-12
+            apt install -y --no-install-recommends clang-11 clang-12 clang-13 clang-14 clang-15 clang-tidy-15
+      - checkout
+      - run:
+          command: |
+            export CFLAGS=-Werror
+            make clean
+            echo
+            echo "########## gcc-9 ##########"
+            CC=gcc-9 make strip
+            ls -l nnn
+            make clean
+            echo
+            echo "########## gcc-10 ##########"
+            CC=gcc-10 make strip
+            ls -l nnn
+            make clean
+            echo
+            echo "########## gcc-11 ##########"
+            CC=gcc-11 make strip
+            ls -l nnn
+            make clean
+            echo
+            echo "########## gcc-12 ##########"
+            CC=gcc-12 make strip
+            ls -l nnn
+            make clean
+            echo
+            echo "########## clang-11 ##########"
+            CC=clang-11 make strip
+            ls -l nnn
+            make clean
+            echo
+            echo "########## clang-12 ##########"
+            CC=clang-12 make strip
+            ls -l nnn
+            make clean
+            echo
+            echo "########## clang-13 ##########"
+            CC=clang-13 make strip
+            ls -l nnn
+            make clean
+            echo
+            echo "########## clang-14 ##########"
+            CC=clang-14 make strip
+            ls -l nnn
+            make clean
+            echo
+            echo "########## clang-tidy-15 ##########"
+            clang-tidy-15 src/* -- -I/usr/include -I/usr/include/ncursesw
+            echo "########## shellcheck ##########"
+            find plugins/ -type f ! \( -name "*.md" -o -name "*-mac" \) -exec shellcheck {} +
+
+  package-and-publish:
+    machine: true
+    working_directory: ~/nnn
+    steps:
+      - checkout
+      - run:
+          name: "auto-generate packages"
+          command: |
+            # Create dist directory if it doesn't exist
+            mkdir ./dist
+            # Clean up
+            rm -rf ./dist/*
+            # Pack source
+            git archive -o ../${CIRCLE_PROJECT_REPONAME}-${CIRCLE_TAG}.tar.gz --format tar.gz --prefix=${CIRCLE_PROJECT_REPONAME}-${CIRCLE_TAG#v}/ ${CIRCLE_TAG}
+            # Use latest installed python3 from pyenv
+            export PYENV_VERSION="$(pyenv versions | grep -Po '\b3\.\d+\.\d+' | tail -1)"
+            #pip install packagecore
+            #packagecore -c misc/packagecore/packagecore.yaml -o ./dist/ ${CIRCLE_TAG#v}
+            # Move source pack to dist
+            mv ../${CIRCLE_PROJECT_REPONAME}-${CIRCLE_TAG}.tar.gz ./dist/
+
+      - run:
+          name: "publish to GitHub"
+          command: |
+            go install github.com/tcnksm/ghr@latest
+            ghr -t ${GITHUB_API_TOKEN} -u ${CIRCLE_PROJECT_USERNAME} -r ${CIRCLE_PROJECT_REPONAME} -c ${CIRCLE_SHA1} -replace ${CIRCLE_TAG} ./dist/
+
+workflows:
+  version: 2
+
+  CircleCI:
+    jobs: &all-tests
+      - compile
+
+  nightly:
+    triggers:
+      - schedule:
+          cron: "0 0 * * 6"
+          filters:
+            branches:
+              only:
+                - master
+    jobs: *all-tests
+
+  publish-github-release:
+    jobs:
+      - package-and-publish:
+          filters:
+            tags:
+              only: /^v.*/
+            branches:
+              ignore: /.*/

.clang-tidy

@@ -1,14 +0,0 @@
----
-Checks:          'clang-diagnostic-*,clang-analyzer-*,readability-*,modernize-*,bugprone-*,misc-*,-misc-unused-parameters,google-runtime-int,-llvm-header-guard,fuchsia-restrict-system-includes,-clang-analyzer-valist.Uninitialized,-clang-analyzer-security.insecureAPI.rand,-clang-analyzer-alpha.*,-readability-magic-numbers,-readability-braces-around-statements'
-WarningsAsErrors: '*'
-HeaderFilterRegex: '.*(?<!lookup3.c)$'
-FormatStyle: 'file'
-CheckOptions:
-  - key:             readability-braces-around-statements.ShortStatementLines
-    value:           '1'
-  - key:             google-runtime-int.TypeSufix
-    value:           '_t'
-  - key:             fuchsia-restrict-system-includes.Includes
-    value:           '*,-stdint.h,-stdbool.h'
-
-...

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: jarun

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,42 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+---
+
+`nnn` comes with excellent documentation (including a Troubleshooting section). If you have a _How to do x_ question, it may have already been answered. Wiki: https://github.com/jarun/nnn/wiki
+
+If it looks like a local environment issue, please try to debug yourself. Debugging local setup issues is not our top priority.
+
+If you are looking for a new feature or program option, ensure you have the correct version with the feature installed. Refer to the release notes to confirm.
+
+Before opening an issue, please try to reproduce on latest master. The bug you noticed might have already been fixed.
+
+Useful links:
+
+- compile `nnn` from source - https://github.com/jarun/nnn/wiki/Usage#from-source
+- debugging `nnn` - https://github.com/jarun/nnn/wiki/Developer-guides#debugging-nnn
+
+If the issue can be reproduced on master, log it.
+
+Please provide the environment details. **If that's missing, the issue will be closed without any cited reason.**
+
+If we need more information and there is no communication from the bug reporter within 7 days from the date of request, we will close the issue. If you have relevant information, resume discussion any time.
+
+--- PLEASE DELETE THIS LINE AND EVERYTHING ABOVE ---
+
+#### Environment details (Put `x` in the checkbox along with the information)
+
+- [ ] Operating System:
+- [ ] Desktop Environment:
+- [ ] Terminal Emulator:
+- [ ] Shell:
+- [ ] Custom desktop opener (if applicable):
+- [ ] Program options used:
+- [ ] Configuration options set:
+- [ ] Plugins are installed
+- [ ] Issue exists on `nnn` master
+
+#### Exact steps to reproduce the issue

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,4 @@
+contact_links:
+  - name: Idea, Enhancement, Question, Support
+    url: https://github.com/jarun/nnn/discussions
+    about: If you have a question, need support or want to discuss new ideas then please open a discussion thread.

.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: GitHubCI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  macOS-gcc:
+    runs-on: macOS-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Compile with gcc
+        env:
+          CC: gcc
+        run: |
+          export CFLAGS="$CFLAGS -Werror"
+          make clean
+          make
+          make clean
+  macOS-clang:
+    runs-on: macOS-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Compile with clang
+        env:
+          CC: clang
+        run: |
+          # see: https://github.com/actions/setup-python/issues/577
+          brew update || true
+          brew install llvm || true
+          brew unlink python@3.11 && brew link python@3.11
+          export PATH="/usr/local/opt/llvm/bin:$PATH"
+          export PATH="/opt/homebrew/opt/llvm/bin:$PATH"
+          export CFLAGS="$CFLAGS -Werror"
+          make clean
+          make
+          make clean
+          clang-tidy src/* -- -I/usr/include
+  ubuntu-patches:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Compile patches with gcc
+        env:
+          CC: gcc
+        run: |
+          make checkpatches

.github/workflows/codeql.yml

@@ -0,0 +1,42 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+  schedule:
+    - cron: "11 23 * * 3"
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ cpp, python ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v2
+        with:
+          languages: ${{ matrix.language }}
+          queries: +security-and-quality
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v2
+        if: ${{ matrix.language == 'cpp' || matrix.language == 'python' }}
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v2
+        with:
+          category: "/language:${{ matrix.language }}"

.github/workflows/lock.yml

@@ -0,0 +1,26 @@
+name: 'Lock threads'
+
+on:
+  schedule:
+    - cron: '0 0 * * *'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+  discussions: write
+
+concurrency:
+  group: lock-threads
+
+jobs:
+  lock:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: dessant/lock-threads@v5
+        with:
+          github-token: ${{ github.token }}
+          issue-lock-inactive-days: '30'
+          issue-lock-reason: ''
+          pr-lock-inactive-days: '30'
+          pr-lock-reason: ''

.gitignore

@@ -1,2 +1,5 @@
 *.o
+*.dSYM
 nnn
+src/icons-generated*.h
+src/icons-hash-gen

.travis.yml

@@ -1,58 +0,0 @@
-language: c
-sudo: required
-services:
-  - docker
-env:
-  global:
-    - REPO=nnn
-
-matrix:
-  include:
-    # Access more recent gcc and clang via a Trusty image
-    - os: linux
-      dist: trusty
-      compiler: gcc
-    - os: linux
-      dist: trusty
-      compiler: clang
-    - os: osx
-      compiler: gcc
-    - os: osx
-      compiler: clang
-
-install:
-  - if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then if [[ "$CC" == "clang" ]]; then brew update; brew install llvm; export PATH="/usr/local/opt/llvm/bin:$PATH"; fi; fi
-
-script:
-  - export CFLAGS=-Werror;
-  - make clean; make;
-  - make clean;
-  - if [[ "$TRAVIS_OS_NAME" == "osx" ]]; then if [[ "$CC" == "clang" ]]; then clang-tidy src/* -- -I/usr/include; fi; fi
-
-before_deploy:
-  - cd ..
-  - rm -rf $REPO/.git
-  - tar -czf $REPO-${TRAVIS_TAG}.tar.gz $REPO
-  - cd $REPO
-  - unset CFLAGS
-  - sudo apt-get update -qy
-  - sudo apt-get install -qy python3 python3-pip
-  - sudo python3 -m pip install --upgrade pip
-  - sudo python3 -m pip install --upgrade packagecore setuptools
-  - packagecore -o dist/ "${TRAVIS_TAG#v}"
-  - mv ../$REPO-${TRAVIS_TAG}.tar.gz dist/
-
-deploy:
-  provider: releases
-  api-key:
-    secure: bdw73zBeBEZtDZGEyFpAksnpwLHTBaC7VP1pONmnsXv4qmMcynASz0LfE4krEdAsRnvxQvqPZXviy/SZ3bmaLpVQmJIC1uRWIyOBE6K/7ddf+wfLy+1uO9EPd/zDF/D28Xy8QJLDGDZI08BY5Fist4XowyvtdW3GRwwDL7TwyZyigr0fkqLJwYcqCpojsHsjXjhkpGZqB5XRztaJ4kIEVz8du03ZU1l5kA9lI8Pdk9+mntOOt6emlaJl+Wr81QkwA8TvGPlZ1VP/+h9YCtlRy/4OuiU+bg5/Atxjh8M6rsq+WpZ3ZdYbR6x5vP78p9f6TsJa4ymGhhW6MhYrKPwdT4oITzZcOXJl6AEoIvrWHQWLY7K3WaEfRbT+DODnXks0ToFKls7wyWfi/AHI0ejeDD5Na5/XhY0jdVYOVvovoY2n8LBaqRTFJDYKoCbJ1S+6myUvvmFVwiZWcgOv9gVX1aaIl4wh+XuzUtPDJTcJtUOE8Q2MWl0bdYVtEkHVRznPXN5u3odrDaeTD3vo+pEaEpshLoSKhCyyWvslSzN7T98ez3aw3KFXoFhXPEg5MEJWy7u359MaVwJIsOGUDAFhy/Y7h83LjQYnu8cmX2wuVrQIRIlGVB0f10GYZzPffZz98I/T0xv75NzpyRs31/wMxvdXz35c8m/yTup4kAkG/1s=
-  file_glob: true
-  file:
-    - dist/*
-  skip_cleanup: true
-  on:
-    condition:
-      - "$TRAVIS_OS_NAME == linux"
-      - "$CC == gcc"
-    tags: true
-    repo: jarun/nnn

CHANGELOG

@@ -1,3 +1,903 @@
+nnn v4.9 Elixir
+2023-08-27
+
+- config option `NNN_ARCHMNT` to specify archive mounter utility
+- key <kbd>^y</kbd> to jump to next young file
+- filter adjustment when opening context from plugin
+- properly update mode after `chmod`
+- pre-fill selected file name to create link if sel is preferred over hovered
+- fix crash when `PWD` is empty
+- make `quitcd.bash_zsh` POSIX-compliant
+- `nmount` - support `udiskctl` as default
+- `preview-tui` - support wezterm split size percentage
+- `preview-tui` - move to bash for environment manipulation through arrays
+- `fzopen` - handle empty selection
+- `finder` - use default path to find
+- add icons for `djvu` files
+- support Nerd Fonts v3.0.0 and above (older versions are broken by v3.0.0)
+
+-------------------------------------------------------------------------------
+
+nnn v4.8 Spritz
+2023-04-13
+
+- show total size (key <kbd>S</kbd>) of non-filtered selection in a directory
+- fix tilde (~) handling in file name
+- plugin `.nmv` now respects `-u` flag
+- env var `$NNN_PREFER_SELECTION` exported to all plugins
+- support for wezterm in `preview-tui`
+- create new file or directory (tree) on startup
+- run command as plugin now supports exported variables
+- use `"$nnn"` anywhere when running command as plugin
+- set defaults for some prompts on <kbd>Enter</kbd>
+- improve archive, rename and create new workflows
+- optimize link creation
+- allow overwriting regular files on new empty file creation
+- add patch for colemak keyboard (existing renamed to colemak-dh)
+- add correct check for Wayland in clipboard plugins
+- add quitcd script for nushell
+- plugin `kdeconnect` - send multiple files
+- plugin `preview-tui`: add `chafa` as preferred image viewer, multiple fixes
+- plugin `nmount` - misc. improvements
+- add icon for jxl files
+
+-------------------------------------------------------------------------------
+
+nnn v4.7 Cuba libre
+2022-11-24
+
+
+- fix <kbd>^N</kbd> not working sometimes (#1449)
+- fix file remove confirmation prompt
+- bring back `atool` as the default archive handler
+- add option `-B` to use `bsdtar` as the archive utility
+- find and list mode improvements
+  ntinue even if max paths/data size limit is exceeded
+  eed improvements
+  pport listing maximum 16K paths of 64 MiB of data
+- key <kbd>J</kbd> to jump to an entry or relative offset from current entry
+- prefill the hard link creation prompt when there's a single target (#1507)
+- documented workaround for docker container crash (#1407, #1476)
+- plugin `imgview`: handle arguments as strings (#1509)
+- plugin `wallpaper`: support Wayland (#1512)
+- plugin `upload`: handle selection using `ffsend` (#1523)
+- add Rust icons (#1502)
+
+-------------------------------------------------------------------------------
+
+nnn v4.6 Absinthe
+2022-07-26
+
+- icon handling overhaul (#1432, #1436)
+  - better performance, memory usage and reduced binary size
+- emoji support for supporting distros and terminals (#1346)
+- open the target directory of symlinked bookmarks (#1353)
+- enable show hidden when a hidden file is passed as argument
+- add Colemak-DH layout keybinds to patch framework (#1421)
+- set `bsdtar` as the default archive utility
+- support 4 byte unicode keybinds (#1428)
+- enable directory auto-enter during filter operation (`-A` to disable)
+- enable filter prompt inside the bookmark/plugin dirs
+- show volume usage information in help
+- add new icon colors for mp4 and flac files
+- use `stat -x` for file details on *BSD and macOS (#1389)
+- interpret suffix `$nnn` when paging (#1355)
+- disable key <kbd>e</kbd> (edit file) in explorer mode (#1394)
+- fix double order chars on filter case match change
+- `.cbcp`: more verbose message on paste without a selection
+- plugin `preview-tui`: scale-up kitty previews
+- plugin `preview-tui`: account for ueberzug offset
+- plugin `preview-tui`: support `SPLIT_SIZE` for preview pane (#1431)
+- plugin `autojump`: support z.lua
+- new Makefile target `shellcheck` to verify plugins
+
+-------------------------------------------------------------------------------
+
+nnn v4.5 Cachaça
+2022-04-26
+
+- disable filter info if file details (option `-i`) enabled
+- open previous active context on context quit
+- switch <kbd>^J</kbd> and <kbd>+</kbd> functionality:
+  - <kbd>+</kbd>: toggle file selection
+  - <kbd>^J</kbd>: toggle auto-jump on file open
+- allow symlink creation with name `@` to a single file (#1345)
+- clear selection on successful operation at native prompt with "%j" (#1330)
+- reverse timestamps of entries modified/created within 5 minutes
+- avoid using non-portable `xargs` flags on macOS (#1299)
+- quitcd script for Elvish shell > 0.17.0 (#1344)
+- plugin `openall` to open selected files together (#1333)
+- plugin `gitroot` to jump to git root directory from a subtree
+- plugin `gsconnect` to send the selected files to Android using gsconnect
+- icon for opus and webp files
+- `preview-tui` - fix gif conversion and whitespace name
+- `preview-tui` - add support for windows terminal split
+- `preview-tui` - djvu file previews
+- `nuke` - add support for `imv` when named _imv_
+- `gsconnect` - support connection to multiple devices
+- export `NNN_INCLUDE_HIDDEN` to plugins (#1308)
+- respect `NNN_TRASH` in `.nmv` (#1306)
+- add GNU sed as a dependency with support for env var `SED`
+- use bold `>` to point at current entry in detail mode
+- add 2 spaces after icons for better visibility
+- documentation refresh
+- make option `O_NOSORT` to load directories unsorted on entry
+
+-------------------------------------------------------------------------------
+
+nnn v4.4 Tequila
+2021-11-23
+
+- support macOS iterm2 in plugin preview-tui (#1196)
+- use selection at native command prompt with `%j` and `%J`
+  - docs - https://github.com/jarun/nnn/wiki/concepts#special-variables
+- scroll strings longer than columns in rename/new prompts (#1213, #279)
+- batch rename symlink targets in listing mode (#1214)
+- option for recursive rename in plugin .nmv (#1186)
+- more frequent checks for cancellation during du (#1236)
+- picker mode: enable auto-proceed
+- picker mode: don't pick hovered file on <kbd>Enter</kbd> if selection exists
+- picker mode: fix issue in plugin `fzopen` when used to pick files
+- send file to explorer FIFO on double left click instead of opening it
+- new neovim plugin [nnn.nvim](https://github.com/luukvbaal/nnn.nvim)
+  - nvim-only, featuring explorer mode (`-F` flag)
+- explorer mode for [nnn.vim](https://github.com/mcchrish/nnn.vim#explorer)
+- remove option `-w`: always place HW cursor on current entry
+- accept link name when linking a single target (#1201)
+- option `-i` to show current file information in info bar
+- force GNU sed on *BSD and Solaris
+- add `nsxiv` support to nuke, preview-tabbed and imgview (#1230)
+- fix preview-tui without `-a` (#1208)
+- pass `pts` in env var for preview-tui to use in `tput` (#1235)
+- disable editing file in picker mode (#1183)
+- save session in picker mode (#1190)
+- use nerd icons for gitstatus patch (#1220)
+
+-------------------------------------------------------------------------------
+
+nnn v4.3 Martini
+2021-09-29
+
+- cool ASCII art logo in the help screen
+- add `bookmarks` directory for flexible symlinked bookmarks
+- new key <kbd>B</kbd> to add a symlinked bookmark for current dir
+- special variables `$dN`, `$fN` available for plugins/prompt/shell to access
+  dir/hovered file in each context
+- config `NNN_ORDER` to set directory-specific ordering
+- show/hide hidden files as per context state in plugin based batch rename
+- retain search filter history for plugin `finder`
+- sync multiple instances of `nnn` after operation on selection
+- signal CWD change to terminal via OSC-7 (#1147)
+- save complete per-context filter when saving sessions
+- disable symlink resolution for paths in `NNN_BMS` and arg `PATH`
+- do not end selection mode on running plugins/prompt/shell
+- plugin `bookmarks` replaced by symlinked bookmarks support
+- list open locations in active contexts in help page
+- make option `O_MATCHFLTR` to discard filter key if no match
+- configurable `NNN_TMPFILE` to _cd on quit_
+- disable auto marking directories (use <kbd>-</kbd>)
+- picker mode improvements
+  - open tty for input if `STDIN` is non-tty
+  - truncate output file before writing
+  - do not double select a file on <kbd>Enter</kbd>
+- legacy macOS (< 10.12.0) support
+- no redraw during du calculation, show processed dir name
+- plugin `xdgdefault`: add dmenu support
+- user patch `restorepreview`: close/restore `preview-tui` for internal edits
+
+-------------------------------------------------------------------------------
+
+nnn v4.2 Mojito
+2021-07-21
+
+- `NNN_PLUG` indicator symbol interpretation has **changed**:
+  - `!` - _run-cmd-as-plugin_ (earlier `_`)
+  - `&` - _run-gui-cmd-as-plugin_ (earlier `|`)
+  - `|` (new) - page noninteractive _run-cmd-as-plugin_ output
+- persistent selection markers (#1086)
+- option _extract to..._ for archives
+- mount remote and mount/extract archive to a smart context
+- confirm file trashing to avoid accidental press of <kbd>x</kbd> (#1101)
+- insert the last command executed at prompt on <kbd>Up</kbd> or <kbd>Down</kbd>
+- insert the current file name at empty prompt on <kbd>TAB</kbd>
+- handle redraw issue on missed `KEY_RESIZE` (#1067)
+- add force-tty capability to spawn and set pagers to it (#1064)
+- clear selection mode on deselecting last selected file (#1098)
+- remove selected hovered entry from selection on deletion
+- disable filtering in empty directories
+- ignore last pressed filter character when no matches
+- fix broken screen on resize while paging (#1072)
+- fix archive not hovered on creation
+- remove libgit2 dependency in `gitstatus` patch (#1095)
+- add `-G` flag for `gitstatus` patch
+- option `-X` for explorer (persistent picker) mode
+- option `-F` decommissioned in favour of config `NNN_HELP`
+- `-F` redefined to multiplex `NNN_FIFO` to preview or explore
+- support paging noninterative _run-cmd-as-plugin_ output
+- `nuke` - add option to execute binaries (#1111)
+- plugin `fzopen` - call `open` on macOS, add option to use `nuke`
+- plugin `fzcd` will not modify selection
+- plugin `suedit` - preserve environment
+- several `preview-tui` fixes
+- plugin `wall` renamed to `wallpaper`
+- remove plugin `fzz` - merged into plugin `autojump`
+- remove plugin `upgrade` - packaging is on OBS now
+- remove plugin `treeview` - needs minor `preview-tui` tweak
+- remove plugin `picker` - `nnn -p -` does the same
+- remove plugin `pdfview` - needs simple change in `pdfread`
+- remove plugin `uidgid` - use program option `-U`
+- remove plugins `mediainf`, `hexview` - simple one-liners
+
+-------------------------------------------------------------------------------
+
+nnn v4.1.1 Sake
+2021-06-03
+
+- fix segfault on session save (#1041)
+- remove redundant `_Atomic` usage
+- move [`patches`](../tree/master/patches) directory to top-level
+- fix and cleanup gitstatus patch
+- plugin `imgview` improvements (#1049)
+- restore source-code packing on CircleCI
+- add Makefile target to compile with musl
+
+-------------------------------------------------------------------------------
+
+nnn v4.1
+2021-06-02
+
+- a patch management model for approved patches
+- multi-threaded disk usage calculation using pthreads and FTS
+- dynamic view update when calculating disk usage
+- <kbd>Bksp</kbd>/<kbd>Del</kbd> at empty filter prompt to refresh dir
+- Try to create new context with <kbd>Shift-TAB</kbd>, else reverse cycle
+- <kbd>Alt+Esc</kbd> to quit context from filter prompt
+- fix zombies left behind after running plugins (#999)
+- named persistent sessions (mcchrish/nnn.vim#43)
+- consider nanosecond resolution when sorting by time (#978)
+- check external selection in `'c'urrent / 's'el` prompt (#976)
+- show number of files selected in local selection buffer, if any
+- `nnn` & picker plugin (e.g. `fzopen`) sync (mcchrish/nnn.vim#82)
+- make batch rename interactive (#971)
+- cached uid/gid for performance improvement
+- fixes for `nnn` with `netbsd-curses`, `musl-fts`, `musl` (#998)
+- script to statically compile `nnn` with `musl gcc` on Ubuntu
+- restore hovered file when plugin is chosen from plugin dir
+- support QuickLook on WSL in `preview-tui` (#959)
+- toggle `preview-tui` with the same _custom_ plugin key
+- smoother preview toggling in `preview-tui` (#966)
+- `listen_on` should be set in kitty.conf for `preview-tui` (#970)
+- minimal `bat` style in `preview-tui`, honors `$BAT_STYLE`
+- plugin `preview-tui-ext` supersedes `preview-tui` (#1033)
+- plugin `fzcd` can now fuzzy search multiple directories
+- plugin `imgview` supersedes `imgthumb` and `vidthumb`
+- plugin `umounttree`: unmount remote mntpoint from within
+- plugin `xdgdefault`: set the default app for hovered file type
+- plugin `fzplug`: fuzzy find, preview and run other plugins
+- plugin `cmusq`: queue/play music in `cmus`
+- plugin `mocplay` renamed to `mocq`
+- plugin `cleanfilename` renamed to `fixname`
+- go to last dir on <kbd>~</kbd> (HOME) or <kbd>`</kbd> (ROOT) key repeat
+- ambiguous key <kbd>^Space</kbd> to select/clear range dropped (#998)
+- user wiki page for [Themes](https://github.com/jarun/nnn/wiki/Themes)
+- show selection mark (`+`) in reverse bold for improved visibility
+- reverse block replaces `>` to mark hovered entry in detail mode
+- make option `O_CKBOARD` removed
+- make option `O_NOLOC` renamed to `O_NOLC`
+- ignore `O_NOLC` if `O_ICONS` or `O_NERD` is specified (#1026)
+- unicode arrow indicators if `O_ICONS` or `O_NERD` is specified
+- make option `NOX11`: disable notis, sel-clipboard sync, xterm title
+- retain filter in _nav-to-type_ mode after file open
+- fix no files picked with `NNN_TMPFILE` exported and <kbd>q</kbd> to quit
+- disable xterm title setting in picker mode (#974)
+
+-------------------------------------------------------------------------------
+
+nnn v4.0 Sushi
+2021-04-13
+
+- show xterm title on option `-x`
+
+-------------------------------------------------------------------------------
+
+nnn v3.7
+2021-04-13
+
+- allow plugins to clear selection (#884, #889, #917)
+- do not clear selection on hovered file deletion
+- resurrect `'c'urrent/'s'el` prompt and option `-u` (#889)
+- show only file name in reverse in detail mode
+- more file/mime types supported in `preview-tui-ext`
+- plugin `mtpmount` - (un)mount MTP devices
+- plugin `cleanfilename` - more shell-friendly file names
+- plugin `rsynccp` - copy-paste with visual progress
+- replace `$HOME` by `~` in address bar
+- show current path in terminal title (#911)
+- total links and inode number of hardlink in statusbar
+- fix symlink to text file not opening in CLI editor (#890)
+- fix symlink size shown as 0B in statusbar (#888)
+- show symlink target in statusbar (#893)
+- show correct disk free/total on macOS (#888)
+- fix directory disk usage showing as 0 on macOS (#941)
+- fix name col len with `-C` and icons compiled-in (#936)
+- refactor printing entries in light/detail modes (#934)
+- make option `O_CKBOARD` for checker board as indicator
+
+-------------------------------------------------------------------------------
+
+nnn v3.6 Nina
+2021-03-16
+
+- REPL command prompt (<kbd>Esc</kbd> or <kbd>Enter</kbd> to exit)
+- invert selection with <kbd>A</kbd>
+- option `-u` removed (always prefer selection to hovered)
+- visit start dir on <kbd>@</kbd> when start path is a file
+- exit filter mode and redraw on <kbd>^L</kbd> if no last filter
+- plugin `fzcd` now selects the chosen file (#876)
+- `ueberzug` support in plugin `preview-tui`
+- new plugin `preview-tui-ext` with extra preview support
+- clear selection after successful plugin invocation
+- add method to sync subshell `$PWD` in WIki
+- clear selection on single file deletion (#812)
+- copy between instances not working (#864)
+- plugin `togglex` to toggle exe mode of a selection (#813)
+- fix `memccpy()` buffer overlap fault on macOS (#786)
+- show `0 selected` msg on cp/mv with empty selection (#855)
+- fix frozen terminal caused by opener (#858)
+- migrate macOS CI to GitHub workflows, retire Travis
+
+-------------------------------------------------------------------------------
+
+nnn v3.5 Freddie
+2020-11-17
+
+- compile-in Alexey Tourbin's QSORT macro
+- support Nerd Font patched icons [`make O_NERD=1`]
+- auto-generate static binaries with icons support
+- audit and adapt all plugins for macOS
+- enhance plugin `dups` to delete duplicates interactively
+- plugin `autojump` now supports `jump` and `zoxide`
+- support `gio trash` to Trash [`export NNN_TRASH=2`] (#740)
+- quit program on double <kbd>Esc</kbd> in normal mode (#775)
+- <kbd>^Space</kbd> replaces <kbd>^K</kbd> for range selection/clear selection
+- show selection symbol (`+`) next to filename in detail mode (#741)
+- error & quit on <kbd>Q</kbd> if no selection, else pick to stdout
+- repeat <kbd>^T</kbd> to cycle sort by time, size and clear
+- option `-U` to show user & group info in status bar
+- option `-J` to disable auto-proceed on select (#713)
+- option `-D` to show dirs in context color with `NNN_FCOLORS`
+- honor option `-C` for context colors
+- show indicators if more entries above/below listing (#744)
+- show missing utility name in flash msg (#753)
+- exit `preview-tabbed` on <kbd>^C</kbd> (#727)
+- invoke GNU sed (_gsed_) on macOS (#728)
+- fix HW cursor moves to wrong line (#735)
+- fix rollover bug with multiline scroll (#743)
+- fix input stream not listed with `-s`/`-S` (#777)
+- fix locker not being invoked
+- make target `upx` for additional binary compression
+- compress auto-generated static binaries with upx
+- make variable `O_NOSSN` to compile out sessions
+- make variable `O_NOUG` to compile out user & group info
+
+-------------------------------------------------------------------------------
+
+nnn v3.4 Emilia
+2020-08-18
+
+- icons with icon-specific colors (thanks @KlzXS)
+- enhanced `NNN_COLORS` with xterm 256 colors support
+- new colorscheme with `NNN_FCOLORS` (file type specific colors)
+- switch `-C` to force earlier colorscheme (dirs follow context color)
+- updates for Haiku (thanks @CodeforEvolution)
+- fix XFS navigation issue (thanks @ucs1)
+- optimize archive extension matching on file open
+- show location in context color
+- support `host[:dir]` format for remote mounts
+- clear selection after copy
+- support traversal on file/dir creation
+- show selection in reverse in status bar
+- show status bar indicator `H` when hidden files are listed
+- show and confirm archive command output
+- support _cd on quit_ in picker mode
+
+-------------------------------------------------------------------------------
+
+nnn v3.3
+2020-07-14
+
+- subdir `mounts` for remote and archive mounts
+- remove mount point on successful unmount of remote/archive
+- show error and prompt user if `cp`/`mv`/`rm` operation fails
+- support absolute/relative paths in cp/mv as
+- mark current path automatically on archive/remote mount
+- mark current path automatically on target file visit in _find and list_ mode
+- option `-C` to place HW cursor on hovered for screen readers and braille displays
+- option `-u` to use selection (if available) and skip `current/sel` prompt
+- key <kbd>Alt+Esc</kbd> to clear filter prompt and redraw
+- support <kbd>Esc</kbd> to cancel remove operation
+- `gpge` & `gpgd`: encrypt and decrypt with GPG
+- `blknew`: create new files and directories in bulk
+- `preview-tui`
+  - unified to support `tmux`/`kitty`/`xterm`/`$TERMINAL`
+  - auto-determine split orientation based on terminal height and width
+  - provision to use [`scope.sh`](https://github.com/ranger/ranger/blob/master/ranger/data/scope.sh) and [`pistol`](https://github.com/doronbehar/pistol)
+- various other improvements
+- `upload`: send to Firefox Send if [`ffsend`](https://github.com/timvisee/ffsend) is found
+- `hexview`: add [`hx`](https://github.com/krpors/hx) as alternative hex viewer
+- `nuke` and `imgview`: add [`imv`](https://github.com/eXeC64/imv) as alternative image viewer
+- add find (with `fd`) and grep (with `rg`) examples in plugins doc
+- key <kbd>Esc</kbd> or left click to resend hovered file path to `NNN_FIFO`
+- show `+` instead of `s` in status bar on selection
+- <kbd>F5</kbd> removed (misfit for toggle hidden), <kbd>^S</kbd> removed (often masked, redundant)
+- handle abnormal program termination and remove NNN_PIPE and/or NNN_FIFO
+- clear selection after successful batch rename, link creation
+- make option `O_CTX8` for 8 contexts (NOT backward compatible with 4 contexts)
+- fix issue with child window resize (see #656)
+- fix issue with `NNNLVL` on macOS (see #639)
+- fix issue with restoring session with du/au enabled
+
+-------------------------------------------------------------------------------
+
+nnn v3.2
+2020-05-26
+
+- an official logo
+- previews
+  - config `NNN_FIFO` to write hovered file paths a previewer can read
+  - plugin `preview-tabbed`: [tabbed](https://tools.suckless.org/tabbed)/xembed based file previewer
+  - plugin `preview-tui`: simple TUI file previewer in tmux/xterm
+  - plugin `preview-kitty`: preview using kitty terminal's capabilities
+  - [live preview](https://github.com/jarun/nnn/wiki/Live-previews) configuration example
+- find & list
+  - send list of files from (cmd run as) plugin to  `nnn`
+  - plugin `finder`: find/fd/fzf/grep/ripgrep/fzf (in subtree) and list in `nnn`
+  - <kbd>Right</kbd> or <kbd>l</kbd> on symlink in list dir takes to target file
+- persistent session option `-S` [for disk usage, run `nnn -T d` (see help)]
+- hover on the file when a file path is passed as positional argument
+- go to first file or match with <kbd>'</kbd> (followed by <kbd>'</kbd> or <kbd>char</kbd>)
+- config `NNN_SEL` to specify custom selection file
+- config `NNN_LOCKER` to specify locker program
+- dim file details in detail mode
+- call `chdir()` on directory change
+- option `-l`: number of lines to move on mouse scroll
+- graphical [keybind map](https://github.com/jarun/nnn/wiki/Usage#graphical-map)
+- let `NNN_COLORS` override `NO_COLOR`
+- plugins
+  - option `-P`: run plugin by key at start
+  - run plugins with <kbd>Alt+key</kbd>
+  - allow `NNN_PIPE` usage by commands run as plugin
+  - input format to `NNN_PIPE`: `<ctxcode><opcode><data>` (see plugins doc)
+  - set `ctxcode` to `+` for smart context usage (next inactive, else current)
+  - `getplugs` to fetch plugins by installed version of `nnn`
+  - plugin `mimelist`: list files by mime type in subtree
+  - plugin `bookmarks`: named bookmarks using symlinks
+  - plugin `nbak`: backup `nnn` config
+  - `nuke` adds lowdown as alternative markdown viewer
+  - several plugin improvements
+- fix broken screen on resize (see #520)
+- fix broken version sort (see #550)
+- fix list and pipe modes not working together
+- fix multiple issues with listing files
+- fix `@` shown in detail mode for symlink to dir
+- fix listing files directly under `/`
+- move to `-std=c11`
+
+-------------------------------------------------------------------------------
+
+nnn v3.1
+2020-04-13
+
+- unlimited bookmarks and plugin keys
+- status bar text in context color
+- support config `NO_COLOR` to disable colors
+- config `NNN_OPTS` to specify binary options to `nnn`
+- config `NNN_MCLICK` to emulate configurable key
+- toggle selection on right click
+- ignore hard links when calculating disk usage
+- dim (hard/sym) link names (symlink to file has `@`)
+- more special keys at empty filter prompt in _type-to-nav_
+- key <kbd>></kbd> to export file list
+- option `-F` to show fortune in help and settings screen
+- option `-T` to specify sort order (obsoletes `-v`)
+- option to clear sort order
+- key <kbd>T</kbd> to change time type (access/change/mod)
+- `.nmv` - internal fully-functional batch renamer plugin
+- make var `O_NOBATCH` to disable native batch renamer
+- `nuke` & `imgview` - open all images in directory sxiv
+- `nuke` - open log files in vi
+- plugin `x2sel` - system clipboard to selection copier
+- plugin `fzy` - cd using z database
+- plugin `fzopen` - support `FZF_DEFAULT_COMMAND`
+- create new context on TAB without prompt
+- hover and connect by dir name (within config dir)
+- move to next entry on current file delete
+- on single file copy/move, select the copied/moved file
+- option `-f` to use readline history file (off by default)
+- use `s` in status bar to indicate selection in progress
+- make var `O_NOMOUSE` to disable mouse support
+- do not store `NNN_TRASH` and `-Q` in config/session
+- add sample .desktop file for XDG compatible DEs
+- rename _nav-as-you-type_ to _type-to-nav_ mode
+- fix PCRE case-insensitive regex search
+- fix no error msg when filter length limit exceeded
+- fix static package generation
+- fix broken abort message when started in du-mode
+- fix filter lost on context switch in non _type-to-nav_ mode
+- fix broken readline prompt
+- fix long strings treated as action keys in filter prompt
+- fix `NNNLVL` not reset when spawned shell is exited
+
+-------------------------------------------------------------------------------
+
+nnn v3.0
+2020-02-12
+
+- take list of files as input and show
+- option `-e` replaces `NNN_USE_EDITOR`
+- option `-t` replaces `NNN_IDLE_TIMEOUT`
+- PCRE support
+- more readline bindings for native prompts
+- run GUI app as plugin
+- attempt lazy unmount when regular unmount fails
+- fix unmount on macOS: use `umount`
+- detect `sshfs` and `rclone` to prompt intelligently
+- auto-proceed on file open (toggle key <kbd>+</kbd>)
+- quit with error code on <kbd>Q</kbd>
+- additional key <kbd>F5</kbd> to toggle hidden
+- key <kbd>e</kbd> to edit in EDITOR (back on multiple user requests)
+- option to edit list of files in selection is changed to <kbd>E</kbd>
+- do not end selection on redraw
+- `nuke`: [`glow`](https://github.com/charmbracelet/glow) as Markdown viewer
+- `nuke`: refactor, handle some common video types by extension
+- file name removed from status bar
+- static Makefile target
+- generate, upload static package on release
+- fix crash on entering empty dir, then Down
+- fix keypresses lost when showing message
+- fix #227: `nnn` creates xdg-open zombies
+
+-------------------------------------------------------------------------------
+
+nnn v2.9
+2020-01-15
+
+- all keybinds and options reviewed by the team and frozen (see #422)
+  - reduced number of keybinds
+- greatly improved help screen readability
+- `nuke`: sample opener (CLI-only by default) and plugin
+- fast line redraws instead of full screen refresh (thanks @annagrram)
+- auto archive handling by extension (see config `NNN_ARCHIVE`)
+- Lead key simplified to bookmark key (<kbd>b</kbd> or <kbd>^/</kbd>)
+- single key to toggle order (<kbd>t</kbd> or <kbd>^T</kbd>)
+- plugins
+  - `.cbcp`: copy selection to system clipboard (internal, program option `-x`)
+  - `.ntfy`: show noti on cp, mv, rm completion (internal, program option `-x`)
+  - `autojump`: navigate using autojump
+  - `upload`: paste text files to http://ix.io, upload rest to https://file.io
+  - all fuzzy plugins modified to support both `fzf` and `fzy`
+- more control on plugins
+  - prefix `-` to skip directory refresh after running (cmd as) plugin
+  - suffix `*` to skip confirmation after running cmd as plugin
+- indicate range selection mode with `*`
+- list keys at bookmark and plugin key prompts
+- visit to pinned dir like bookmarks (Bookmark key followed by <kbd>,</kbd>)
+- toggle executable (key <kbd>*</kbd>)
+- show mime along with file details
+- more special keys at empty filter prompt:
+  - apply the last filter (<kbd>^L</kbd>)
+  - toggle between string and regex (<kbd>/</kbd>)
+  - toggle case-sensitivity (<kbd>:</kbd>)
+- retain filter on <kbd>Esc</kbd>, <kbd>Up</kbd>, <kbd>Down</kbd>
+- show filter details when filter is on
+- remove option to run filter as cmd on prompt key (can be disruptive)
+- program options
+  - option `-x`: enable notis and copy selection to system clipboard
+  - option `-g`: regex filters (string filter is default now)
+  - option `-Q`: quit program without confirmation
+  - option `-s`: load session
+  - option `-n`: start in nav-as-you-type mode
+  - option `-v`: version sort
+  - option `-V`: show program version
+  - option `-A`: disable dir auto-select
+- ISO 8601 compliant date in status bar
+- ported to Haiku OS (thanks @annagrram)
+- sort only filtered entries (to avoid directory refresh)
+- fix `getplugs` to install hidden files
+- fix several selection issues (see #400)
+- fix detail mode not restored on loading session
+- fix symlink to directory not auto-selected
+- fix regex error on partial regex patterns
+- fix symlink not shown if `stat(2)` on target fails
+- fix flags when spawning a CLI opener as default FM
+- fix issue with stat flag on Sun (no support for `dirent.d_type`)
+- fix current file in current context not saved correctly in session
+- signed source distribution on release
+- simplified debugging with line numbers in logs
+
+-------------------------------------------------------------------------------
+
+nnn v2.8.1
+2019-12-05
+
+- Fix always archiving current file
+- More elaborate docs on selection changes
+
+-------------------------------------------------------------------------------
+
+nnn v2.8
+2019-12-04
+
+- sessions (thanks @annagrram)
+- `rclone` support for remote access (mount _any_ cloud storage!!!)
+- toggle selection with <kbd>Space</kbd> or <kbd>^J</kbd>
+- ignore events during selection so the `+` symbol is not lost
+- run custom (non-shell-interpreted) commands like plugins
+- configure _cd-on-quit_ as the default behaviour
+- create parent dirs for new files and dirs, duplicate a file/dir anywhere
+- _copy/move as_ workflow (thanks @KlzXS)
+- edit , flush selection buffer (thanks @KlzXS)
+- support xargs with minimal options (as in BusyBox) (thanks @KlzXS)
+- changed the key to size sort to <kbd>z</kbd>
+- additional key <kbd>]</kbd> to show command prompt
+- mount archives using `archivemount`
+- smoother double click handling
+- program option `-R` to disable rollover at edges
+- keybind collision checker (for custom keybind config) (thanks @annagrram)
+- show size of file in bytes in status bar in disk usage mode
+- pass unresolved path as second argument (`$2`) to plugin
+- mechanism for plugins to control active directory
+- all binary questions are confirmed by <kbd>y</kbd> or <kbd>Y</kbd>
+- plugins
+  - some plugins renamed
+  - integrated `shellcheck` in CI, POSIX-compliance fixes (thanks @koalaman)
+  - `getplugs` - detect modifications in exiting plugin file (thanks @KlzXS)
+  - `drag-file` & `drop-file`: drag & drop files using dragon
+  - `gutenread`: browse, download and read from Project Gutenberg
+  - `suedit` - edit file with superuser permissions
+  - `fzhist` - fuzzy select commands from history, edit and run
+  - `fzcd` - change to a fuzzy-searched directory
+  - `rename` - batch rename directory or selection using qmv or vidir
+  - `pskill` - fuzzy list a process or zombies by name and kill
+  - `exetoggle` - toggle executable status of hovered file
+  - `treeview` - informative tree output with file permissions and size
+  - `chksum` - recursively calculate checksum for files in hovered directory
+  - `fzopen` renamed to `fzopen`
+  - `imgsxiv` instructions added to browse and rename images
+- create link to current file
+- additional key <kbd>;</kbd> to execute plugin
+- more explicit force removal message
+- force non-detachable internal edits in $EDITOR (option `-E`)
+- export current file as `$nnn` (instead of `$NN`)
+- fix file open failure from browser when configured as default FM
+
+-------------------------------------------------------------------------------
+
+nnn v2.7
+2019-10-06
+
+- plugins for image preview, image and video thumbnails
+- redesigned selection workflow
+- drop path prefix for files in current dir for selection based archives
+- custom direct keybinds for plugins
+- libreadline `.history` file moved to `nnn` config directory
+- export current entry as `$NN` at command prompt
+- more informative status bar in light/detail modes
+- auto-proceed to next file on single file select
+- path clipping for long paths
+- completely revamped wiki
+- new program options:
+  - `-a` to use file access time throughout the program
+  - `-c` to indicate cli-only opener
+  - `-f` to run filter as command on <kbd>^P</kbd>
+  - `-o` replaces config `NNN_RESTRICT_NAV_OPEN`
+  - `-t` replaces config `NNN_NO_AUTOSELECT`
+  - `-r` replaces config `NNN_OPS_PROG`
+- plugin changes:
+  - `vidthumb` - show video thumbnails in terminal
+  - `mediainf` - show media info (decoupled as a plugin)
+  - `notes` - open a quick notes file/dir in `$EDITOR` (decoupled as a plugin)
+  - `dups` - list duplicate files in the current directory
+  - `oldbigfile` - list large files by access time
+  - `moclyrics` - show lyrics of the track currently playing in MOC
+  - `uidgid` list uid and gid of files in directory
+  - `mocplay` - now detects if a track is playing or not
+  - `organize` - categorize files and move to respective directories
+  - `pastebin` - now uses ix.io paste service
+  - `fzy-edit` - merged into `fzy-open`
+  - `viuimg` - fix directory view
+  - `checksum` - fixed POSIX compliance issues
+  - `boom` - play music in MOC
+- keybind changes:
+  - select entry: <kbd>Space</kbd> and <kbd>^J</kbd>
+  - select range (or clear selection): <kbd>m</kbd> and <kbd>^K</kbd>
+  - select all in dir: <kbd>a</kbd>
+  - list selection: <kbd>M</kbd>
+  - <kbd>^N</kbd> replaces <kbd>^T</kbd> to toggle _nav-as-you-type_
+  - <kbd>Shift TAB</kbd> to reverse context cycle
+  - <kbd>'</kbd> to jump to first file in dir
+  - <kbd>S</kbd> for du, <kbd>A</kbd> for apparent du
+  - additional key <kbd>:</kbd> to run plugin
+  - additional key <kbd>F2</kbd> to rename file
+  - additional key <kbd>F5</kbd> to redraw
+  - quit context key <kbd>Leadq</kbd> is removed
+- Leader key combinations:
+  - <kbd>Lead'</kbd> to jump to first file in dir
+  - <kbd>Lead]</kbd> go to next active context
+  - <kbd>Lead[</kbd> go to prev active context
+  - <kbd>Lead.</kbd> toggle show hidden files
+- improved duplicate file workflow
+- improved batch rename workflow when a selection exists
+- removed the wild load option (`-w`)
+- removed quick notes (added plugin `notes`)
+- fix #225 (thanks @KlzXS)
+- fix `tar`/`bsdtar` always creating tar archives (and not by suffix)
+- fix single mouse click to select file not working
+- fix symlink to dir removed on batch rename
+- fix detail mode not set with program option `-S`
+
+-------------------------------------------------------------------------------
+
+nnn v2.6
+2019-08-06
+
+- new plugins
+   - view image or browse a directory of images in terminal
+   - show image thumbnails
+   - PDF and text file reader
+   - calculate and verify checksum of selection or file
+   - append (and play) selection/dir/file music in MOC
+   - variable bitrate mp3 ringtone generator
+   - split current file or join selection
+- better experience on Termux (and touch based devices)
+   - mouse scrolling support (with ncursesw6.0 and above)
+   - tap/left click to visit parent, toggle nav-as-you-type mode
+- light mode set as default
+- show status bar and use reverse video in light mode
+- changed program options
+  - `-d`: detail mode
+  - `-H`: show hidden files
+  - `-l` is retired
+- support `XDG_CONFIG_HOME`
+- support <kbd>/</kbd> as an additional Leader key when filter is on
+- sort by file extension
+- use zip/unzip/tar if atool/bsdtar not found
+- support duplicate file (key <kbd>^R</kbd>, same as rename file)
+- new config option `NNN_SSHFS_OPTS` to specify `sshfs` options
+- restrict opening 0 byte files (`NNN_RESTRICT_0B` is obsolete)
+- critical defects fixed
+   - fix #276 - crash with variable length inotify event handling
+   - fix #285 - hang after deleting/moving current directory
+   - fix #274 - a broken prompt on empty input with libreadline
+   - fix #304 - list selection from another instance
+- `cmatrix` as locker fallback
+- wait for user input after running a command from prompt
+- scrolloff set to 3 from 5
+
+-------------------------------------------------------------------------------
+
+nnn v2.5
+2019-05-27
+
+- mouse support
+- new location for config files - `~/.config/nnn`
+  - plugin dir location: `~/.config/nnn/plugins`
+  - selection file `.nnncp` is now `~/.config/nnn/.selection`
+- plugins:
+  - pdfview: view a PDF in pager
+  - nmount: (un)mount a storage device
+  - ndiff: file and directory diff for selection
+  - hexview: view a file in hex
+  - imgresize: batch resize images to desktop resolution
+  - ipinfo: check your IP address and whois information
+  - transfer: upload a file to transfer.in
+  - pastebin: paste the contents of a text file to paste.ubuntu.com
+  - boom: play random music from a directory
+  - nwal: set an image as wallpaper using nitrogen
+  - pywal: set selected image as wallpaper, change terminal color scheme
+  - getplugs: update plugins
+- SSHFS support
+- support `bsdtar`, simplify `patool` integration
+- native batch rename support (`vidir` dependency dropped)
+- changes to support [configuration](https://github.com/jarun/nnn/wiki/nnn-as-default-file-manager) as the default file manager
+- per-context detail/light mode
+- case-insensitive version compare
+- shortcut to visit `/` - <kbd>`</kbd> (backtick)
+- vim-like scrolloff support
+- <kbd>^D</kbd> & <kbd>^U</kbd>: scroll half page, <kbd>PgDn</kbd> & <kbd>PdUp</kbd>: scroll full page
+- fix selection across contexts
+- recognize <kbd>Home</kbd> and <kbd>End</kbd> keys at prompt for editing
+- fix broken program option `-b`
+- POSIX-compliant user-scripts (wherever possible)
+- `NNN_SCRIPT` is retired (replaced by plugins)
+
+-------------------------------------------------------------------------------
+
+nnn v2.4
+2019-03-19
+
+- FreeDesktop.org compliant trashing
+- mark selected entries with `+`
+- _wild_ mode (option `-w`, key <kbd>^W</kbd>) for _nav-as-you-type_
+- POSIX-compliant GUI app launcher with drop-down menu (key <kbd>=</kbd>)
+- new scripts:
+  - upload image to imgur
+  - send selection to Android using kdeconnect-cli
+- show permissions in detail mode
+- cp, mv progress bar for Linux (needs advcpmv) [BSD, macOS shows on <kbd>^T</kbd>]
+- make libreadline an optional dep (reduces memory usage)
+- minimize the number of redraws
+- handle screen resize gracefully
+- option `-d` to show hidden files (`NNN_SHOW_HIDDEN` is removed)
+- additional key <kbd>K</kbd> to toggle selection
+- change visit start dir key to <kbd>@</kbd>
+- option `-C` to disable colors removed
+- per-context initial directory replaced by program start dir
+- marker msg when spawning new shell removed
+- rename debug file to `nnndbg`
+
+-------------------------------------------------------------------------------
+
+nnn v2.3
+2019-02-19
+
+- file picker mode
+- repo of user-contributed scripts
+- substring search for filters (option `-s`)
+- version sort (option `-n`)
+- disk usage calculation abort with <kbd>^C</kbd>
+- create sym/hard link(s) to files in selection
+- archiving of selection
+- show dir symlinks along with dirs in top
+- fixed CJK character handling at prompts
+- key `N` (1 <= N <= 4) to switch to context N
+- bring back `NNN_OPENER` to specify file opener
+- env var `NNN_NOTE` and keybind <kbd>^N</kbd> for quick notes
+- handle multiple arguments in VISUAL/EDITOR
+- show the current directory being scanned in `du` mode
+- select all files (<kbd>Y</kbd>)
+- show command prompt (<kbd>^P</kbd>)
+- key <kbd>,</kbd> replaces <kbd>`</kbd> as alternative Leader Key
+- keybind for visit pinned directory is now <kbd>^B</kbd>
+- additional key <kbd>^V</kbd> to run or select custom script
+- use libreadline for command prompt
+- reduce delay on <kbd>Esc</kbd> press
+- config option to avoid unexpected behaviour on 0-byte file open (see #187)
+- rename config option `DISABLE_FILE_OPEN_ON_NAV` to `NNN_RESTRICT_NAV_OPEN`
+- keys removed - <kbd>$</kbd>, <kbd>^</kbd>, <kbd>Backspace</kbd>, <kbd>^H</kbd>, <kbd>^P</kbd>, <kbd>^M</kbd>, <kbd>^W</kbd>, <kbd>`</kbd>
+
+-------------------------------------------------------------------------------
+
+nnn v2.2
+2019-01-01
+
+What's in?
+- (neo)vim plugin [nnn.vim](https://github.com/mcchrish/nnn.vim)
+- macOS fixes
+  - Fix issues with file copy, move, remove
+  - Handle <kbd>Del</kbd> in rename prompt
+  - Pass correct `file` option to identify mime
+- Support selection across directories and contexts
+- Offer option `force` before file remove
+- Keys <kbd>Tab</kbd>, <kbd>^I</kbd> to go to next active context
+- Per-context directory color specified by `$NNN_CONTEXT_COLORS`
+  - Option `-c` is removed
+- Option `-C` to disable colors
+- Choose script to run from a script directory
+- Run a command (or launch an application)
+- Run file as executable (key <kbd>C</kbd>)
+- Documentation on lftp integration for remote file transfers
+- Support a _combined_ set of arguments to `$EDITOR`, `$PAGER` and `$SHELL`
+- Handle > 2 GB files on 32-bit ARM
+- Env var `$DISABLE_FILE_OPEN_ON_NAV` to disable file open on <kbd>Right</kbd> or <kbd>l</kbd>
+- `NUL`-terminated file paths in selection list instead of `LF`
+- Better support for Termux and Cygwin environments
+- Remapped keys
+  - <kbd>^I</kbd> - go to next active context
+  - <kbd>^T</kbd> - toggle _navigate-as-you-type_
+
+-------------------------------------------------------------------------------
+
 nnn v2.1
 2018-11-23
 

LICENSE

@@ -2,7 +2,7 @@ BSD 2-Clause License
 
 Copyright (c) 2014-2016, Lazaros Koromilas <lostd@2f30.org>
 Copyright (c) 2014-2016, Dimitris Papastamos <sin@2f30.org>
-Copyright (c) 2016-2018, Arun Prakash Jana <engineerarun@gmail.com>
+Copyright (c) 2016-2023, Arun Prakash Jana <engineerarun@gmail.com>
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

Makefile

@@ -1,34 +1,250 @@
-VERSION = 2.1
+VERSION = $(shell grep -m1 VERSION $(SRC) | cut -f 2 -d'"')
 
 PREFIX ?= /usr/local
 MANPREFIX ?= $(PREFIX)/share/man
+DESKTOPPREFIX ?= $(PREFIX)/share/applications
+DESKTOPICONPREFIX ?= $(PREFIX)/share/icons/hicolor
 STRIP ?= strip
 PKG_CONFIG ?= pkg-config
 INSTALL ?= install
+CP ?= cp
 
-CFLAGS ?= -O3
-CFLAGS += -Wall -Wextra -Wno-unused-parameter
+CFLAGS_OPTIMIZATION ?= -O3
+
+O_DEBUG := 0  # debug binary
+O_NORL := 0  # no readline support
+O_PCRE := 0  # link with PCRE library
+O_NOLC := 0  # no locale support
+O_NOMOUSE := 0  # no mouse support
+O_NOBATCH := 0  # no built-in batch renamer
+O_NOFIFO := 0  # no FIFO previewer support
+O_CTX8 := 0  # enable 8 contexts
+O_ICONS := 0  # support icons-in-terminal
+O_NERD := 0  # support icons-nerdfont
+O_EMOJI := 0  # support emoji
+O_QSORT := 0  # use Alexey Tourbin's QSORT implementation
+O_BENCH := 0  # benchmark mode (stops at first user input)
+O_NOSSN := 0  # disable session support
+O_NOUG := 0  # disable user, group name in status bar
+O_NOX11 := 0  # disable X11 integration
+O_MATCHFLTR := 0  # allow filters without matches
+O_NOSORT := 0  # disable sorting entries on dir load
+
+# User patches
+O_COLEMAK := 0 # change key bindings to colemak compatible layout
+O_GITSTATUS := 0 # add git status to detail view
+O_NAMEFIRST := 0 # print file name first, add uid and guid to detail view
+O_RESTOREPREVIEW := 0 # add preview pipe to close and restore preview pane
+
+T_ICONS := 0 # test if multiple icons options are set and fail
+
+# convert targets to flags for backwards compatibility
+ifneq ($(filter debug,$(MAKECMDGOALS)),)
+	O_DEBUG := 1
+endif
+ifneq ($(filter norl,$(MAKECMDGOALS)),)
+	O_NORL := 1
+endif
+ifneq ($(filter nolc,$(MAKECMDGOALS)),)
+	O_NORL := 1
+	O_NOLC := 1
+endif
+
+ifeq ($(strip $(O_DEBUG)),1)
+	CPPFLAGS += -DDEBUG
+	CFLAGS += -g3
+endif
+
+ifeq ($(strip $(O_NORL)),1)
+	CPPFLAGS += -DNORL
+else ifeq ($(strip $(O_STATIC)),1)
+	CPPFLAGS += -DNORL
+else
+	LDLIBS += -lreadline
+endif
+
+ifeq ($(strip $(O_PCRE)),1)
+	CPPFLAGS += -DPCRE
+	LDLIBS += -lpcre
+endif
+
+ifeq ($(strip $(O_NOLC)),1)
+	ifeq ($(strip $(O_ICONS)),1)
+$(info *** Ignoring O_NOLC since O_ICONS is set ***)
+	else ifeq ($(strip $(O_NERD)),1)
+$(info *** Ignoring O_NOLC since O_NERD is set ***)
+	else ifeq ($(strip $(O_EMOJI)),1)
+$(info *** Ignoring O_NOLC since O_EMOJI is set ***)
+	else
+		CPPFLAGS += -DNOLC
+	endif
+endif
+
+ifeq ($(strip $(O_NOMOUSE)),1)
+	CPPFLAGS += -DNOMOUSE
+endif
+
+ifeq ($(strip $(O_NOBATCH)),1)
+	CPPFLAGS += -DNOBATCH
+endif
+
+ifeq ($(strip $(O_NOFIFO)),1)
+	CPPFLAGS += -DNOFIFO
+endif
+
+ifeq ($(strip $(O_CTX8)),1)
+	CPPFLAGS += -DCTX8
+endif
+
+ifeq ($(strip $(O_ICONS)),1)
+	ICONS_INCLUDE = icons-generated-icons-in-term.h
+	CPPFLAGS += -DICONS_IN_TERM -DICONS_INCLUDE=\"$(ICONS_INCLUDE)\"
+ifeq ($(strip $(T_ICONS)),1)
+$(error Choose only one system for icons (O_ICONS, O_NERD or O_EMOJI))
+endif
+	T_ICONS := 1
+endif
+
+ifeq ($(strip $(O_NERD)),1)
+	ICONS_INCLUDE = icons-generated-nerd.h
+	CPPFLAGS += -DNERD -DICONS_INCLUDE=\"$(ICONS_INCLUDE)\"
+ifeq ($(strip $(T_ICONS)),1)
+$(error Choose only one system for icons (O_ICONS, O_NERD or O_EMOJI))
+endif
+	T_ICONS := 1
+endif
+
+ifeq ($(strip $(O_EMOJI)),1)
+	ICONS_INCLUDE = icons-generated-emoji.h
+	CPPFLAGS += -DEMOJI -DICONS_INCLUDE=\"$(ICONS_INCLUDE)\"
+ifeq ($(strip $(T_ICONS)),1)
+$(error Choose only one system for icons (O_ICONS, O_NERD or O_EMOJI))
+endif
+	T_ICONS := 1
+endif
+
+ifeq ($(strip $(O_QSORT)),1)
+	CPPFLAGS += -DTOURBIN_QSORT
+endif
+
+ifeq ($(strip $(O_BENCH)),1)
+	CPPFLAGS += -DBENCH
+endif
+
+ifeq ($(strip $(O_NOSSN)),1)
+	CPPFLAGS += -DNOSSN
+endif
+
+ifeq ($(strip $(O_NOUG)),1)
+	CPPFLAGS += -DNOUG
+endif
+
+ifeq ($(strip $(O_NOX11)),1)
+	CPPFLAGS += -DNOX11
+endif
+
+ifeq ($(strip $(O_MATCHFLTR)),1)
+	CPPFLAGS += -DMATCHFLTR
+endif
+
+ifeq ($(strip $(O_NOSORT)),1)
+	CPPFLAGS += -DNOSORT
+endif
 
 ifeq ($(shell $(PKG_CONFIG) ncursesw && echo 1),1)
-	CFLAGS += $(shell $(PKG_CONFIG) --cflags ncursesw)
-	LDLIBS += $(shell $(PKG_CONFIG) --libs   ncursesw)
+	CFLAGS_CURSES ?= $(shell $(PKG_CONFIG) --cflags ncursesw)
+	LDLIBS_CURSES ?= $(shell $(PKG_CONFIG) --libs   ncursesw)
+else ifeq ($(shell $(PKG_CONFIG) ncurses && echo 1),1)
+	CFLAGS_CURSES ?= $(shell $(PKG_CONFIG) --cflags ncurses)
+	LDLIBS_CURSES ?= $(shell $(PKG_CONFIG) --libs   ncurses)
 else
-	LDLIBS += -lncurses
+	LDLIBS_CURSES ?= -lncurses
+endif
+
+CFLAGS += -std=c11 -Wall -Wextra -Wshadow
+CFLAGS += $(CFLAGS_OPTIMIZATION)
+CFLAGS += $(CFLAGS_CURSES)
+
+LDLIBS += $(LDLIBS_CURSES) -lpthread
+
+# static compilation needs libgpm development package
+ifeq ($(strip $(O_STATIC)),1)
+	LDFLAGS += -static
+	LDLIBS += -lgpm
 endif
 
 DISTFILES = src nnn.1 Makefile README.md LICENSE
 SRC = src/nnn.c
+HEADERS = src/nnn.h
 BIN = nnn
+DESKTOPFILE = misc/desktop/nnn.desktop
+LOGOSVG = misc/logo/logo.svg
+LOGO64X64 = misc/logo/logo-64x64.png
+
+COLEMAK = patches/colemak
+GITSTATUS = patches/gitstatus
+NAMEFIRST = patches/namefirst
+RESTOREPREVIEW = patches/restorepreview
+
+# test if we are on Mac OS X and get X.Y.Z OS version with system binary /usr/bin/sw_vers
+MACOS_VERSION := $(strip $(shell command -v sw_vers >/dev/null && [ "`sw_vers -productName`" = "Mac OS X" ] && sw_vers -productVersion))
+# if Mac OS X detected, test if its version is below 10.12.0 relying on "sort -c" returning "disorder" message if the input is not sorted
+ifneq ($(MACOS_VERSION),)
+	MACOS_BELOW_1012 := $(if $(strip $(shell printf '10.12.0\n%s' "$(MACOS_VERSION)" | sort -ct. -k1,1n -k2,2n -k3,3n 2>&1)),1)
+endif
+# if Mac OS X version is below 10.12.0, compile in the replacement clock_gettime and define MACOS_BELOW_1012 so that it's included in nnn.c
+ifneq ($(MACOS_BELOW_1012),)
+	GETTIME_C = misc/macos-legacy/mach_gettime.c
+	GETTIME_H = misc/macos-legacy/mach_gettime.h
+	SRC += $(GETTIME_C)
+	HEADERS += $(GETTIME_H)
+	CPPFLAGS += -DMACOS_BELOW_1012
+endif
+
+ifeq ($(strip $(O_DEBUG)),1)
+	HEADERS += src/dbg.h
+endif
+ifeq ($(strip $(O_QSORT)),1)
+	HEADERS += src/qsort.h
+endif
+ifeq ($(strip $(O_EMOJI)),1)
+	HEADERS += src/icons.h src/$(ICONS_INCLUDE)
+endif
+ifeq ($(strip $(O_NERD)),1)
+	HEADERS += src/icons.h src/$(ICONS_INCLUDE)
+endif
+ifeq ($(strip $(O_ICONS)),1)
+	HEADERS += src/icons.h src/$(ICONS_INCLUDE) src/icons-in-terminal.h
+endif
 
 all: $(BIN)
 
-$(SRC): src/nnn.h
+$(BIN): $(SRC) $(HEADERS) Makefile
+	@$(MAKE) --silent prepatch
+	$(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) -o $@ $(GETTIME_C) $< $(LDLIBS)
+	@$(MAKE) --silent postpatch
 
-$(BIN): $(SRC)
-	$(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) -o $@ $^ $(LDLIBS)
+# targets for backwards compatibility
+debug: $(BIN)
+norl: $(BIN)
+nolc: $(BIN)
 
-debug: $(SRC)
-	$(CC) -DDEBUGMODE -g $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) -o $(BIN) $^ $(LDLIBS)
+src/$(ICONS_INCLUDE): src/icons-hash.c src/icons.h src/icons-in-terminal.h
+	$(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) -DICONS_GENERATE -o src/icons-hash-gen src/icons-hash.c
+	./src/icons-hash-gen > $@
+
+install-desktop: $(DESKTOPFILE)
+	$(INSTALL) -m 0755 -d $(DESTDIR)$(DESKTOPPREFIX)
+	$(INSTALL) -m 0644 $(DESKTOPFILE) $(DESTDIR)$(DESKTOPPREFIX)
+	$(INSTALL) -m 0755 -d $(DESTDIR)$(DESKTOPICONPREFIX)/scalable/apps
+	$(INSTALL) -m 0644 $(LOGOSVG) $(DESTDIR)$(DESKTOPICONPREFIX)/scalable/apps/nnn.svg
+	$(INSTALL) -m 0755 -d $(DESTDIR)$(DESKTOPICONPREFIX)/64x64/apps
+	$(INSTALL) -m 0644 $(LOGO64X64) $(DESTDIR)$(DESKTOPICONPREFIX)/64x64/apps/nnn.png
+
+uninstall-desktop:
+	$(RM) $(DESTDIR)$(DESKTOPPREFIX)/$(DESKTOPFILE)
+	$(RM) $(DESTDIR)$(DESKTOPICONPREFIX)/scalable/apps/nnn.svg
+	$(RM) $(DESTDIR)$(DESKTOPICONPREFIX)/64x64/apps/nnn.png
 
 install: all
 	$(INSTALL) -m 0755 -d $(DESTDIR)$(PREFIX)/bin
@@ -43,16 +259,118 @@ uninstall:
 strip: $(BIN)
 	$(STRIP) $^
 
+upx: $(BIN)
+	$(STRIP) $^
+	upx -qqq $^
+
+static:
+	# regular static binary
+	make O_STATIC=1 strip
+	mv $(BIN) $(BIN)-static
+	# static binary with icons-in-terminal support
+	make O_STATIC=1 O_ICONS=1 strip
+	mv $(BIN) $(BIN)-icons-static
+	# static binary with patched nerd font support
+	make O_STATIC=1 O_NERD=1 strip
+	mv $(BIN) $(BIN)-nerd-static
+	# static binary with emoji support
+	make O_STATIC=1 O_EMOJI=1 strip
+	mv $(BIN) $(BIN)-emoji-static
+
+musl:
+	cp misc/musl/musl-static-ubuntu.sh .
+	./musl-static-ubuntu.sh 1
+	rm ./musl-static-ubuntu.sh
+
+shellcheck:
+	find ./plugins/ -type f -not -name "*.md" -exec shellcheck {} +
+
 dist:
 	mkdir -p nnn-$(VERSION)
 	$(CP) -r $(DISTFILES) nnn-$(VERSION)
-	tar -cf nnn-$(VERSION).tar nnn-$(VERSION)
-	gzip nnn-$(VERSION).tar
+	tar -cf - nnn-$(VERSION) | gzip > nnn-$(VERSION).tar.gz
 	$(RM) -r nnn-$(VERSION)
 
+sign:
+	git archive -o nnn-$(VERSION).tar.gz --format tar.gz --prefix=nnn-$(VERSION)/ v$(VERSION)
+	gpg --detach-sign --yes nnn-$(VERSION).tar.gz
+	rm -f nnn-$(VERSION).tar.gz
+
+upload-local: sign static musl
+	$(eval ID=$(shell curl -s 'https://api.github.com/repos/jarun/nnn/releases/tags/v$(VERSION)' | jq .id))
+	# upload sign file
+	curl -XPOST 'https://uploads.github.com/repos/jarun/nnn/releases/$(ID)/assets?name=nnn-$(VERSION).tar.gz.sig' \
+	    -H 'Authorization: token $(NNN_SIG_UPLOAD_TOKEN)' -H 'Content-Type: application/pgp-signature' \
+	    --upload-file nnn-$(VERSION).tar.gz.sig
+	# upx compress all static binaries
+	upx -qqq $(BIN)-static
+	upx -qqq $(BIN)-icons-static
+	upx -qqq $(BIN)-nerd-static
+	upx -qqq $(BIN)-emoji-static
+	# upload static binary
+	tar -zcf $(BIN)-static-$(VERSION).x86_64.tar.gz $(BIN)-static
+	curl -XPOST 'https://uploads.github.com/repos/jarun/nnn/releases/$(ID)/assets?name=$(BIN)-static-$(VERSION).x86_64.tar.gz' \
+	    -H 'Authorization: token $(NNN_SIG_UPLOAD_TOKEN)' -H 'Content-Type: application/x-sharedlib' \
+	    --upload-file $(BIN)-static-$(VERSION).x86_64.tar.gz
+	# upload icons-in-terminal compiled static binary
+	tar -zcf $(BIN)-icons-static-$(VERSION).x86_64.tar.gz $(BIN)-icons-static
+	curl -XPOST 'https://uploads.github.com/repos/jarun/nnn/releases/$(ID)/assets?name=$(BIN)-icons-static-$(VERSION).x86_64.tar.gz' \
+	    -H 'Authorization: token $(NNN_SIG_UPLOAD_TOKEN)' -H 'Content-Type: application/x-sharedlib' \
+	    --upload-file $(BIN)-icons-static-$(VERSION).x86_64.tar.gz
+	# upload patched nerd font compiled static binary
+	tar -zcf $(BIN)-nerd-static-$(VERSION).x86_64.tar.gz $(BIN)-nerd-static
+	curl -XPOST 'https://uploads.github.com/repos/jarun/nnn/releases/$(ID)/assets?name=$(BIN)-nerd-static-$(VERSION).x86_64.tar.gz' \
+	    -H 'Authorization: token $(NNN_SIG_UPLOAD_TOKEN)' -H 'Content-Type: application/x-sharedlib' \
+	    --upload-file $(BIN)-nerd-static-$(VERSION).x86_64.tar.gz
+	# upload emoji compiled static binary
+	tar -zcf $(BIN)-emoji-static-$(VERSION).x86_64.tar.gz $(BIN)-emoji-static
+	curl -XPOST 'https://uploads.github.com/repos/jarun/nnn/releases/$(ID)/assets?name=$(BIN)-emoji-static-$(VERSION).x86_64.tar.gz' \
+	    -H 'Authorization: token $(NNN_SIG_UPLOAD_TOKEN)' -H 'Content-Type: application/x-sharedlib' \
+	    --upload-file $(BIN)-emoji-static-$(VERSION).x86_64.tar.gz
+	# upload musl static binary
+	tar -zcf $(BIN)-musl-static-$(VERSION).x86_64.tar.gz $(BIN)-musl-static
+	curl -XPOST 'https://uploads.github.com/repos/jarun/nnn/releases/$(ID)/assets?name=$(BIN)-musl-static-$(VERSION).x86_64.tar.gz' \
+	    -H 'Authorization: token $(NNN_SIG_UPLOAD_TOKEN)' -H 'Content-Type: application/x-sharedlib' \
+	    --upload-file $(BIN)-musl-static-$(VERSION).x86_64.tar.gz
+
 clean:
-	$(RM) -f $(BIN) nnn-$(VERSION).tar.gz
+	$(RM) -f $(BIN) nnn-$(VERSION).tar.gz *.sig $(BIN)-static $(BIN)-static-$(VERSION).x86_64.tar.gz $(BIN)-icons-static $(BIN)-icons-static-$(VERSION).x86_64.tar.gz $(BIN)-nerd-static $(BIN)-nerd-static-$(VERSION).x86_64.tar.gz $(BIN)-emoji-static $(BIN)-emoji-static-$(VERSION).x86_64.tar.gz $(BIN)-musl-static $(BIN)-musl-static-$(VERSION).x86_64.tar.gz src/icons-hash-gen src/icons-generated-*.h
+
+checkpatches:
+	./patches/check-patches.sh
+
+prepatch:
+ifeq ($(strip $(O_NAMEFIRST)),1)
+	patch --forward $(PATCH_OPTS) --strip=1 --input=$(NAMEFIRST)/mainline.diff
+ifeq ($(strip $(O_GITSTATUS)),1)
+	patch --forward $(PATCH_OPTS) --strip=1 --input=$(GITSTATUS)/namefirst.diff
+endif
+else ifeq ($(strip $(O_GITSTATUS)),1)
+	patch --forward $(PATCH_OPTS) --strip=1 --input=$(GITSTATUS)/mainline.diff
+endif
+ifeq ($(strip $(O_RESTOREPREVIEW)),1)
+	patch --forward $(PATCH_OPTS) --strip=1 --input=$(RESTOREPREVIEW)/mainline.diff
+endif
+ifeq ($(strip $(O_COLEMAK)),1)
+	patch --forward $(PATCH_OPTS) --strip=1 --input=$(COLEMAK)/mainline.diff
+endif
+
+postpatch:
+ifeq ($(strip $(O_NAMEFIRST)),1)
+ifeq ($(strip $(O_GITSTATUS)),1)
+	patch --reverse $(PATCH_OPTS) --strip=1 --input=$(GITSTATUS)/namefirst.diff
+endif
+	patch --reverse $(PATCH_OPTS) --strip=1 --input=$(NAMEFIRST)/mainline.diff
+else ifeq ($(strip $(O_GITSTATUS)),1)
+	patch --reverse $(PATCH_OPTS) --strip=1 --input=$(GITSTATUS)/mainline.diff
+endif
+ifeq ($(strip $(O_RESTOREPREVIEW)),1)
+	patch --reverse $(PATCH_OPTS) --strip=1 --input=$(RESTOREPREVIEW)/mainline.diff
+endif
+ifeq ($(strip $(O_COLEMAK)),1)
+	patch --reverse $(PATCH_OPTS) --strip=1 --input=$(COLEMAK)/mainline.diff
+endif
 
 skip: ;
 
-.PHONY: $(BIN) $(SRC) all debug install uninstall strip dist clean
+.PHONY: all install uninstall strip static dist sign upload-local clean install-desktop uninstall-desktop

README.md

@@ -1,528 +1,165 @@
-## nnn
-
-Noice is Not Noice, a noicer fork...
+<h3 align="center"><img src="misc/logo/logo-128x128.png" alt="nnn"><br>nnn - <i>Supercharge your productivity!</i></h3>
 
 <p align="center">
-<a href="https://github.com/jarun/nnn/releases/latest"><img src="https://img.shields.io/github/release/jarun/nnn.svg?maxAge=600" alt="Latest release" /></a>
-<a href="http://formulae.brew.sh/formula/nnn"><img src="https://img.shields.io/homebrew/v/nnn.svg?maxAge=600" alt="Homebrew" /></a>
-<a href="https://www.archlinux.org/packages/community/x86_64/nnn/"><img src="https://img.shields.io/badge/archlinux-rolling-blue.svg?maxAge=600" alt="Arch Linux" /></a>
-<a href="https://packages.debian.org/search?keywords=nnn&searchon=names&exact=1"><img src="https://img.shields.io/badge/debian-10+-blue.svg?maxAge=2592000" alt="Debian Buster+" /></a>
-<a href="https://apps.fedoraproject.org/packages/nnn"><img src="https://img.shields.io/badge/fedora-27+-blue.svg?maxAge=2592000" alt="Fedora 27+" /></a>
-<a href="https://software.opensuse.org/package/nnn"><img src="https://img.shields.io/badge/opensuse%20leap-15.0+-blue.svg?maxAge=2592000" alt="openSUSE Leap 15.0+" /></a>
-<a href="https://packages.ubuntu.com/search?keywords=nnn&searchon=names&exact=1"><img src="https://img.shields.io/badge/ubuntu-17.10+-blue.svg?maxAge=2592000" alt="Ubuntu Artful+" /></a>
+<a href="https://github.com/jarun/nnn/releases/latest"><img src="https://img.shields.io/github/release/jarun/nnn.svg?maxAge=600&label=rel" alt="Latest release" /></a>
+<a href="https://repology.org/project/nnn/versions"><img src="https://repology.org/badge/tiny-repos/nnn.svg?header=repos" alt="Availability"></a>
+<a href="https://circleci.com/gh/jarun/workflows/nnn"><img src="https://img.shields.io/circleci/project/github/jarun/nnn.svg?label=circle%20ci" alt="CircleCI Status" /></a>
+<a href="https://github.com/jarun/nnn/actions"><img src="https://github.com/jarun/nnn/workflows/ci/badge.svg?branch=master" alt="GitHub CI Status" /></a>
+<a href="https://en.wikipedia.org/wiki/Privacy-invasive_software"><img src="https://img.shields.io/badge/privacy-✓-crimson?maxAge=2592000" alt="Privacy Awareness" /></a>
+<a href="https://github.com/jarun/nnn/blob/master/LICENSE"><img src="https://img.shields.io/badge/©-BSD%202--Clause-important.svg?maxAge=2592000" alt="License" /></a>
 </p>
 
-<p align="center">
-<a href="https://travis-ci.org/jarun/nnn"><img src="https://img.shields.io/travis/jarun/nnn/master.svg" alt="Build Status" /></a>
-<a href="https://github.com/jarun/nnn/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-BSD%202--Clause-yellow.svg?maxAge=2592000" alt="License" /></a>
-</p>
+<p align="center"><a href="http://i.imgur.com/kOld6HT.gif"><img src="https://i.imgur.com/NUsSA2u.jpg"></a></p>
 
-[![nnn screencast](https://i.imgur.com/wNtI24c.jpg)](https://vimeo.com/233223942 "Click to see nnn in action!")
+<h3 align="center">[<a
+href="https://github.com/jarun/nnn#features">Features</a>] [<a
+href="https://github.com/jarun/nnn#quickstart">Quickstart</a>] [<a
+href="https://github.com/jarun/nnn/tree/master/plugins#nnn-plugins">Plugins</a>] [<a
+href="https://github.com/jarun/nnn/wiki">Wiki</a>]</h3>
 
-<p align="center"><i>nnn in action! (click to play video)</i></a></p>
+`nnn` (_n³_) is a full-featured terminal file manager. It's tiny, nearly 0-config and [incredibly fast](https://github.com/jarun/nnn/wiki/Performance).
 
-`nnn` is probably the [fastest and most resource-sensitive](#performance) file manager you have ever used. It integrates seamlessly with your DE and favourite GUI utilities, has a unique [navigate-as-you-type](#navigate-as-you-type-mode) mode with auto-select, disk usage analyzer mode, bookmarks, contexts, application launcher, familiar navigation shortcuts, subshell spawning and much more.
+It is designed to be unobtrusive with smart workflows to match the trains of thought.
 
-[Integrate utilities](https://github.com/jarun/nnn#sample-scripts) like sxiv or fzy easily; `nnn` supports as many scripts as you need!
+`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. [live previews](https://github.com/jarun/nnn/wiki/Live-previews), (un)mount disks, find & list, file/dir diff, upload files. A [patch framework](https://github.com/jarun/nnn/tree/master/patches) hosts sizable user-submitted patches which are subjective in nature.
 
-It runs on Linux, OS X, Raspberry Pi, Cygwin, Linux subsystem for Windows and Termux.
+Independent (neo)vim plugins - [nnn.vim](https://github.com/mcchrish/nnn.vim), [vim-floaterm nnn wrapper](https://github.com/voldikss/vim-floaterm#nnn) and [nnn.nvim](https://github.com/luukvbaal/nnn.nvim) (neovim exclusive).
 
-[Quickstart](#quickstart) and see how `nnn` simplifies those long desktop sessions... Missing a feature? Want to contribute? Head to the rolling [ToDo list](https://github.com/jarun/nnn/issues/110).
+Runs on the Pi, [Termux](https://www.youtube.com/embed/AbaauM7gUJw) (Android), Linux, macOS, BSD, Haiku, Cygwin, WSL, across DEs or a strictly CLI env.
 
-*Love smart and efficient utilities? Explore [my repositories](https://github.com/jarun?tab=repositories). Buy me a cup of coffee if they help you.*
+[_(there's more)_](https://github.com/jarun/nnn/wiki/Basic-use-cases#the_nnn-magic)
 
-<p align="center">
-<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RMLTQ76JSXJ4Q"><img src="https://img.shields.io/badge/PayPal-donate-green.svg" alt="Donate via PayPal!" /></a>
-</p>
-
-#### TABLE OF CONTENTS
-
-- [Features](#features)
-- [Performance](#performance)
-- [Installation](#installation)
-  - [Dependencies](#dependencies)
-  - [From a package manager](#from-a-package-manager)
-  - [Release packages](#release-packages)
-  - [From source](#from-source)
-  - [Shell completion](#shell-completion)
-- [Usage](#usage)
-  - [Cmdline options](#cmdline-options)
-  - [Keyboard shortcuts](#keyboard-shortcuts)
-  - [Leader key](#leader-key)
-  - [Contexts](#contexts)
-  - [Filters](#filters)
-  - [Navigate-as-you-type mode](#navigate-as-you-type-mode)
-  - [File indicators](#file-indicators)
-  - [File handling](#file-handling)
-  - [Help](#help)
-- [Quickstart](#quickstart)
-- [How to](#how-to)
-  - [add bookmarks](#add-bookmarks)
-  - [copy file paths](#copy-file-paths)
-    - [selection](#selection)
-    - [quote paths](#quote-paths)
-    - [to clipboard](#to-clipboard)
-  - [cd on quit](#cd-on-quit)
-  - [run custom scripts](#run-custom-scripts)
-    - [sample scripts](#sample-scripts)
-  - [change dir color](#change-dir-color)
-  - [integrate patool](#integrate-patool)
-  - [work faster at rename prompt](#work-faster-at-rename-prompt)
-  - [set idle timeout](#set-idle-timeout)
-  - [show hot plugged drives](#show-hot-plugged-drives)
-  - [tmux configuration](#tmux-configuration)
-  - [BSD terminal issue](#bsd-terminal-issue)
-- [Why fork?](#why-fork)
-- [Mentions](#mentions)
-- [Developers](#developers)
-
-#### FEATURES
+## 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
-  - Basic, detail (default), disk usage analyzer (du)
+  - Light (default), detail
+  - Disk usage analyzer (block/apparent)
+  - File picker, (neo)vim plugin
 - Navigation
-  - Familiar, easy shortcuts (arrows, `~`, `-`, `&`)
-  - *Navigate-as-you-type* with auto-select directory
-  - Contexts (_aka_ tabs _aka_ workspaces)
-  - Bookmarks
-  - Pin and visit a directory
-- Sorting
-  - Directories always listed on top
-  - Sort by file name, modification time, size
-  - Numeric order for numeric names (visit _/proc_)
+  - Filter with automatic dir entry on unique match
+  - *Type-to-nav* (turbo navigation/always filter) mode
+  - Contexts (_aka_ tabs/workspaces) with custom colors
+  - Sessions, bookmarks, mark and visit a dir
+  - Remote mounts (needs `sshfs`, `rclone`)
+  - Familiar shortcuts (arrows, <kbd>~</kbd>, <kbd>-</kbd>, <kbd>@</kbd>), quick look-up
+  - `cd` on quit (*easy* shell integration)
+  - Proceed to next file on file open and selection
 - 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
+  - Directory-specific ordering
 - Mimes
-  - Open with desktop opener or specify a custom app
-  - Create, list, extract archives (needs (p)atool)
-  - Open all text files in EDITOR (optional)
-- Information
-  - Detailed stat-like file information
-  - Media information (needs mediainfo/exiftool)
+  - 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 and Emojis support (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
-  - Create, rename files and directories
-  - Select multiple files; copy, move, delete selection
-  - Batch rename/move/delete (needs vidir)
-  - Show directories in custom color (default: blue)
-  - Spawn a subshell in the current directory
-  - Run custom scripts in the current directory
-  - Change directory at exit (*easy* shell integration)
-  - Edit file in EDITOR or open in PAGER
-  - GUI app launcher (up to 2 space-separated args)
-  - Terminal locker integration
-- Unicode support
-- Highly optimized, static analysis integrated code
-- Available on many distros
-
-#### PERFORMANCE
-
-`nnn` vs. ncdu memory usage in disk usage analyzer mode (400K files on disk):
-
-<pre>
-  PID USER      PR  NI    VIRT    <b>RES</b>    SHR S  %CPU %MEM     TIME+ COMMAND
- 5034 vaio      20   0   71628  <b>59932</b>   2412 S   0.0  0.7   0:01.22 ncdu /
- 4949 vaio      20   0   14812   <b>3616</b>   2560 S   0.0  0.0   0:00.83 nnn -S /
-</pre>
-
-`nnn` vs. midnight commander vs. ranger memory usage while viewing a directory with 13.5K files, sorted by size:
-
-<pre>
-  PID USER      PR  NI    VIRT    <b>RES</b>    SHR S  %CPU %MEM     TIME+ COMMAND
-31885 vaio      20   0  139720  <b>91220</b>   8460 S   0.0  1.1   0:02.96 /usr/bin/python -O /usr/bin/ranger
-30108 vaio      20   0   72152  <b>12468</b>   7336 S   0.0  0.2   0:00.06 mc
-30168 vaio      20   0   16476   <b>5072</b>   2640 S   0.0  0.1   0:00.22 nnn -c 1 -i
-</pre>
-
-Intrigued? Find out [HOW](https://github.com/jarun/nnn/wiki/performance-factors).
-
-#### INSTALLATION
-
-#### Dependencies
-
-`nnn` needs libncursesw (on Linux or ncurses on OS X) and standard libc.
-
-#### From a package manager
-
-- [Arch Linux](https://www.archlinux.org/packages/community/x86_64/nnn/) (`pacman -S nnn`)
-- [Debian](https://packages.debian.org/search?keywords=nnn&searchon=names&exact=1) (`apt-get install nnn`)
-- [Fedora](https://apps.fedoraproject.org/packages/nnn) (`dnf install nnn`)
-- [FreeBSD](https://www.freshports.org/misc/nnn) (`pkg install nnn`)
-- [Gentoo](https://packages.gentoo.org/packages/app-misc/nnn) (`emerge nnn`)
-- [Homebrew](http://formulae.brew.sh/formula/nnn) (`brew install nnn`)
-- [NixOS](https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/misc/nnn) (`nix-env -i nnn`)
-- [OpenBSD](https://cvsweb.openbsd.org/cgi-bin/cvsweb/ports/sysutils/nnn/) (`pkg_add nnn`)
-- [openSUSE](https://software.opensuse.org/package/nnn) (and packages for several other distros) (`zypper in nnn`)
-- [Raspbian Testing](https://archive.raspbian.org/raspbian/pool/main/n/nnn/) (`apt-get install nnn`)
-- [Slackware](http://slackbuilds.org/repository/14.2/system/nnn/) (`slackpkg install nnn`)
-- [Source Mage](http://codex.sourcemage.org/test/shell-term-fm/nnn/) (`cast nnn`)
-- [Termux](https://github.com/termux/termux-packages/tree/master/packages/nnn) (`pkg in nnn`)
-- [Ubuntu](https://packages.ubuntu.com/search?keywords=nnn&searchon=names&exact=1) (`apt-get install nnn`)
-- [Ubuntu PPA](https://launchpad.net/~twodopeshaggy/+archive/ubuntu/jarun/) (`apt-get install nnn`)
-- [Void Linux](https://github.com/void-linux/void-packages/tree/master/srcpkgs/nnn) (`xbps-install -S nnn`)
-
-#### Release packages
-
-Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the [latest stable release](https://github.com/jarun/nnn/releases/latest).
-
-#### From source
-
-To cook yourself, download the [latest stable release](https://github.com/jarun/nnn/releases/latest) or clone this repository (*risky*). Then install the dependencies and compile (e.g. on Ubuntu 16.04):
-
-    $ sudo apt-get install pkg-config libncursesw5-dev
-    $ make
-    $ sudo make install
-
-`PREFIX` is supported, in case you want to install to a different location.
-
-#### Shell completion
-
-Search keyword and option completion scripts for Bash, Fish and Zsh can be found in respective subdirectories of [`scripts/auto-completion/`](scripts/auto-completion). Please refer to your shell's manual for installation instructions.
-
-#### USAGE
-
-#### Cmdline options
-
-```
-usage: nnn [-b key] [-c N] [-e] [-i] [-l]
-           [-S] [-v] [-h] [PATH]
-
-The missing terminal file manager for X.
-
-positional args:
-  PATH   start dir [default: current dir]
-
-optional args:
- -b key  bookmark key to open
- -c N    dir color, disables if N>7
- -e      use exiftool instead of mediainfo
- -i      start in navigate-as-you-type mode
- -l      start in light mode
- -S      start in disk usage analyser mode
- -v      show program version
- -h      show this help
-```
-
-`>` indicates the currently selected entry in `nnn`.
-
-#### Keyboard shortcuts
-
-Press <kbd>?</kbd> in `nnn` to see the list anytime.
-
-```
- NAVIGATION
-       ↑, k, ^P  Up             PgUp, ^U  Scroll up
-       ↓, j, ^N  Down           PgDn, ^D  Scroll down
- Home, g, ^, ^A  First entry           ~  Go HOME
-  End, G, $, ^E  Last entry            &  Start dir
- ←, Bksp, h, ^H  Parent dir            -  Last visited dir
-    →, ↵, l, ^M  Open file/enter dir   .  Toggle show hidden
-              /  Filter          Ins, ^I  Toggle nav-as-you-type
-              b  Pin current dir      ^W  Go to pinned dir
-          `, ^/  Leader key      LeaderN  Switch to context N
-            Esc  Exit prompt          ^L  Redraw, clear prompt
-             ^G  Quit and cd           q  Quit context
-          Q, ^Q  Quit                  ?  Help, config
- FILES
-             ^O  Open with...          n  Create new
-              D  File details          d  Toggle detail view
-             ^R  Rename entry          r  Open dir in vidir
-          Y, ^Y  Toggle selection      y  List selection
-          ⎵, ^K  Copy entry path      ^T  Toggle path quote
-              P  Copy selection        X  Delete selection
-              V  Move selection       ^X  Delete entry
-              f  Archive entry         F  List archive
-             ^F  Extract archive    m, M  Brief/full media info
-              e  Edit in EDITOR        p  Open in PAGER
- ORDER
-             ^J  Toggle du mode        S  Toggle apparent size
-              s  Toggle sort by size   t  Toggle sort by mtime
- MISC
-              o  Launch GUI app    !, ^]  Spawn SHELL in dir
-              R  Run custom script     L  Lock terminal
-```
-
-Help & settings, file details, media info and archive listing are shown in the PAGER. Please use the PAGER-specific keys in these screens.
-
-#### Leader key
-
-The Leader key (<kbd>`</kbd> or <kbd>^/</kbd>) provides a powerful multi-functional navigation mechanism. It is case-sensitive and understands contexts, bookmarks and handy location shortcuts.
-
-| Key | Function |
-|:---:| --- |
-| <kbd>1-4</kbd> | Go to selected context |
-| <kbd>></kbd>, <kbd>.</kbd> | Go to next active context |
-| <kbd><</kbd>, <kbd>,</kbd> | Go to previous active context |
-| key | Go to bookmarked location |
-| <kbd>~</kbd> | Go to HOME directory |
-| <kbd>-</kbd> | Go to last visited directory |
-| <kbd>&</kbd> | Go to start directory |
-| <kbd>q</kbd> | Quit context |
-
-#### Contexts
-
-Contexts serve the purpose of exploring multiple directories simultaneously. 4 contexts are available. The status of the contexts are shown in the top left corner:
-
-- the current context is in reverse
-- other used contexts are underlined
-- rest are unused
-
-To switch to a context press the Leader key followed by the context number (1-4).
-
-The first time a context is entered, it copies the state of the last visited context. Each context remembers its start directory and last visited directory.
-
-When a context is quit, the next active context is selected. If the last active context is quit, the program quits.
-
-#### Filters
-
-Filters support regexes to instantly (search-as-you-type) list the matching entries in the current directory.
-
-Ways to exit filter prompt:
-- press <kbd>^L</kbd> to clear filter followed by <kbd>Bksp</kbd> (to clear the filter symbol, like vi)
-  - at other prompts <kbd>^L</kbd> followed by <kbd>Enter</kbd> discards all changes and exits prompt
-- run a search with no matches and press <kbd>Enter</kbd>
-
-Common use cases:
-- to list all matches starting with the filter expression, start the expression with a `^` (caret) symbol
-- type `\.mkv` to list all MKV files
-- use `.*` to match any character (_sort of_ fuzzy search)
-
-If `nnn` is invoked as root or the environment variable `NNN_SHOW_HIDDEN` is set the default filter will also match hidden files.
-
-#### Navigate-as-you-type mode
-
-In this mode directories are opened in filter mode, allowing continuous navigation. Works best with the **arrow keys**.
-
-In case of only one match and it's a directory, `nnn` auto selects the directory and enters it in this mode. To disable this behaviour,
-
-    export NNN_NO_AUTOSELECT=1
-
-#### File indicators
-
-The following indicators are used in the detail view:
-
-| Indicator | File Type |
-|:---:| --- |
-| `/` | Directory |
-| `*` | Executable |
-| <code>&#124;</code> | Fifo |
-| `=` | Socket |
-| `@` | Symbolic Link |
-| `@/` | Symbolic Link to directory |
-| `b` | Block Device |
-| `c` | Character Device |
-
-#### File handling
-
-| External dependency | Operation |
-| --- | --- |
-| xdg-open (Linux), open(1) (OS X), cygstart (Cygwin) | desktop opener |
-| file | determine file type |
-| cp, mv, rm | copy, move and remove files |
-| mediainfo, exiftool | multimedia file details |
-| atool, patool ([integration](#integrate-patool)) | create, list and extract archives |
-| vidir (from moreutils) | batch rename, move, delete dir entries |
-| vlock (Linux), bashlock (OS X), lock(1) (BSD) | terminal locker |
-| $EDITOR (overridden by $VISUAL, if defined) | edit files (fallback vi) |
-| $PAGER | page through files (fallback less) |
-| $SHELL | spawn a shell, run script (fallback sh) |
-
-- To edit all text files in EDITOR (preferably CLI, fallback vi):
-
-      export NNN_USE_EDITOR=1
-
-#### Help
-
-    $ nnn -h
-    $ man nnn
-To lookup keyboard shortcuts at runtime, press <kbd>?</kbd>.
-
-#### QUICKSTART
-
-1. Install the [utilities required](#file-handling) for your regular activities.
-2. Configure [cd on quit](#cd-on-quit).
-3. Optionally open all text files in EDITOR (fallback vi):
-
-       export NNN_USE_EDITOR=1
-4. Run `n`.
-5. Press <kbd>?</kbd> for help on keyboard shortcuts anytime.
-6. For additional functionality [setup custom scripts](#run-custom-scripts).
-
-#### HOW TO
-
-#### add bookmarks
-
-Set environment variable `NNN_BMS` as a string of `key_char:location` pairs (max 10) separated by semicolons (`;`):
-
-    export NNN_BMS='d:~/Documents;u:/home/user/Cam Uploads;D:~/Downloads/'
-
-NOTE: Bookmark keys should be single-character to use them in combination with the Leader key.
-
-#### copy file paths
-
-##### selection
-
-Use <kbd>^K</kbd> to copy the absolute path of the file under the cursor.
-
-To copy multiple absolute file paths:
-
-- press <kbd>^Y</kbd> (or <kbd>Y</kbd>) to enter selection mode. In this mode it's possible to
-  - cherry-pick individual files one by one by pressing <kbd>^K</kbd> on each entry; or,
-  - navigate to another file in the same directory to select a range of files
-- press <kbd>^Y</kbd> (or <kbd>Y</kbd>) _again_ to copy the paths and exit the selection mode
-
-The files in the list can now be copied (<kbd>P</kbd>), moved (<kbd>V</kbd>) or removed (<kbd>X</kbd>).
-
-To list the file paths copied to memory press <kbd>y</kbd>.
-
-File paths are copied to the temporary file `DIR/.nnncp`, where `DIR` (by priority) is:
-
-    $HOME or,
-    $TMPDIR or,
-    /tmp
-
-To see the path to the temporary copy file, run `nnn`, press <kbd>?</kbd> and look up `copy file`.
-
-To use the copied paths from the cmdline, use command substitution. For example, if `DIR` above is `/home/user`:
-
-    # bash/zsh
-    ls -ltr `cat /home/user/.nnncp`
-    ls -ltr $(cat /home/user/.nnncp)
-
-    # fish
-    ls -ltr (cat /home/user/.nnncp)
-
-An alias may be handy:
-
-    alias ncp='cat /home/user/.nnncp'
-
-so you can easily handle files together:
-
-    # bash/zsh
-    ls -ltr `ncp`
-    ls -ltr $(ncp)
-
-    # fish
-    ls -ltr (ncp)
-
-##### quote paths
-
-To wrap each file path within single quotes while selecting:
-
-    export NNN_QUOTE_ON=1
-This is particularly useful if you are planning to copy the whole string to the shell to run a command. Quotes can be toggled at runtime using <kbd>^T</kbd>.
-
-Note that the filename is not escaped. So copying may still fail for filenames having quote(s) in them.
-
-##### to clipboard
-
-Along with default copy, `nnn` can pipe the absolute path of the current file or multiple files to a copier script. For example, you can use `xsel` on Linux or `pbcopy` on OS X.
-
-Sample Linux copier script:
-
-    #!/bin/sh
-
-    # comment the next line to convert newlines to spaces
-    IFS=
-
-    echo -n $1 | xsel --clipboard --input
-
-export `NNN_COPIER`:
-
-    export NNN_COPIER="/path/to/copier.sh"
-
-#### cd on quit
-
-To quit `nnn` and switch to the directory last opened follow the instructions below.
-
-Pick the appropriate file for your shell from [`scripts/quitcd`](scripts/quitcd) and add the contents to your shell's rc file. You'll need to spawn a new shell for the change to take effect. You should start `nnn` as `n` (or modify the function name to something else). To change directory on quit press `^G` while exiting.
-
-As you might notice, `nnn` uses the environment variable `NNN_TMPFILE` to write the last visited directory path. You can change it.
-
-#### run custom scripts
-
-`nnn` can invoke custom scripts with the currently selected file name as argument 1.
-
-Export the path to the custom executable script:
-
-    export NNN_SCRIPT=/usr/local/bin/nscript
-
-Press <kbd>R</kbd> to run the script in the current directory.
-
-It's possible to run multiple scripts with `nnn` as long as the scripts are in the same location and share the same prefix. To enable multiple scripts,
-
-    export NNN_MULTISCRIPT=1
-
-With the example of `NNN_SCRIPT` above, some more scripts could be:
-
-    /usr/local/bin/nscript1
-    /usr/local/bin/nscript2
-    /usr/local/bin/nscriptcustom1
-    /usr/local/bin/nscriptcustom2
-    and so on...
-
-Type the correct suffix  when prompted on pressing the keybind <kbd>R</kbd>. To use the base script (`NNN_SCRIPT`), just press <kbd>Enter</kbd>.
-
-##### sample scripts
-
-- Open image files in current dir in **sxiv**:
-
-      #!/usr/bin/env sh
-
-      sxiv -q * >/dev/null 2>&1
-
-- Fuzzy find files in **fzy** and open with xdg-open:
-
-      #!/usr/bin/env sh
-
-      xdg-open $(find -type f | fzy) >/dev/null 2>&1
-
-#### change dir color
-
-The default color for directories is blue. Option `-c` accepts color codes from 0 to 7 to use a different color:
-
-    0-black, 1-red, 2-green, 3-yellow, 4-blue, 5-magenta, 6-cyan, 7-white
-
-Any other value disables colored directories.
-
-#### integrate patool
-
-On systems where `atool` is not available but `patool` is, drop two copies of the Python3 script [natool](https://github.com/jarun/nnn/blob/master/scripts/natool) as `atool` and `apack` somewhere in `$PATH`.
-
-#### work faster at rename prompt
-
-The rename prompt supports some bash-like command-line shortcuts - <kbd>^A</kbd>, <kbd>^E</kbd>, <kbd>^U</kbd>. <kbd>^L</kbd> clears the name.
-
-#### set idle timeout
-
-The terminal locker is disabled by default. To set the wait time in seconds, use environment variable `NNN_IDLE_TIMEOUT`.
-
-#### show hot plugged drives
-
-Enable volume management in your DE file manager and set removable drives or media to be auto-mounted when inserted. Then visit the usual mount point location (`/mnt` or `/media/user`) in `nnn`.
-
-#### tmux configuration
-
-`nnn` might not handle keypresses correctly when used with tmux (see issue #104 for more details). Set `TERM=xterm-256color` to address it.
-
-#### BSD terminal issue
-
-By default in OpenBSD & FreeBSD, `stty` maps <kbd>^Y</kbd> to `DSUSP`. This means that typing <kbd>^Y</kbd> will suspend `nnn` as if you typed <kbd>^Z</kbd> (you can bring `nnn` back to the foreground by issuing `fg`) instead of entering multi-copy 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 <kbd>^Y</kbd> instead.
-
-#### WHY FORK?
-
-`nnn` was initially forked from [noice](http://git.2f30.org/noice/) but is significantly [different](https://github.com/jarun/nnn/wiki/nnn-vs.-noice) today. I chose to fork because:
-- one can argue my approach deviates from the goal of the original project -  keep the utility `suckless`. `noice` was rudimentary. In my opinion evolution is the taste of time.
-- I would like to have a bit of control on what features are added in the name of desktop integration. A feature-bloat is the last thing in my mind. Check out [nnn design considerations](https://github.com/jarun/nnn/wiki/nnn-design-considerations) for more details.
-
-#### MENTIONS
-
+  - 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
+  - Create new file or directory (tree) on startup
+  - 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 context paths/files 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](https://github.com/jarun/nnn/wiki/Usage) `nnn` and the dependencies you need.
+2. The desktop opener is default. Use `-e` to open text files in the terminal. Optionally [open detached](https://github.com/jarun/nnn/wiki/Basic-use-cases#detached-text).
+3. Configure [`cd` on quit](https://github.com/jarun/nnn/wiki/Basic-use-cases#configure-cd-on-quit).
+4. [Sync subshell `$PWD`](https://github.com/jarun/nnn/wiki/Basic-use-cases#sync-subshell-pwd) to `nnn`.
+5. [Install plugins](https://github.com/jarun/nnn/tree/master/plugins#installation).
+6. Use `-x` to sync selection to clipboard, show notis on `cp`, `mv`, `rm` and set xterm title.
+7. For a CLI-only environment, set [`NNN_OPENER`](https://github.com/jarun/nnn/wiki/Usage#configuration) to [`nuke`](https://github.com/jarun/nnn/blob/master/plugins/nuke). Use option `-c`.
+8. Bid `ls` goodbye! `alias ls='nnn -de'` :sunglasses:
+9. Visit the [Live previews](https://github.com/jarun/nnn/wiki/Live-previews) and [Troubleshooting](https://github.com/jarun/nnn/wiki/Troubleshooting) Wiki pages.
+
+Don't memorize! Arrows, <kbd>/</kbd>, <kbd>q</kbd> suffice. <kbd>Tab</kbd> creates and/or cycles contexts. <kbd>?</kbd> lists shortcuts.
+
+[![](https://i.imgur.com/TN3xYQz.jpg)](https://www.youtube.com/embed/-knZwdd1ScU)
+
+[![Wiki](https://img.shields.io/badge/RTFM-nnn%20Wiki-important?maxAge=2592000)](https://github.com/jarun/nnn/wiki)
+
+## Videos
+
+- [nnn file manager on Termux (Android)](https://www.youtube.com/embed/AbaauM7gUJw)
+- [NNN File Manager](https://www.youtube.com/embed/1QXU4XSqXNo)
+- [This Week in Linux 114 - TuxDigital](https://www.youtube.com/watch?v=5W9ja0DQjSY&t=2059s)
+- [nnn file manager basics - Linux](https://www.youtube.com/embed/il2Fm-KJJfM)
+- [I'M GOING TO USE THE NNN FILE BROWSER! 😮](https://www.youtube.com/embed/U2n5aGqou9E)
+- [NNN: Is This Terminal File Manager As Good As People Say?](https://www.youtube.com/embed/KuJHo-aO_FA)
+- [nnn - A File Manager (By Uoou, again.)](https://www.youtube.com/embed/cnzuzcCPYsk)
+
+## Elsewhere
+
+- [AddictiveTips](https://www.addictivetips.com/ubuntu-linux-tips/navigate-linux-filesystem/)
+- [ArchWiki](https://wiki.archlinux.org/index.php/Nnn)
 - [FOSSMint](https://www.fossmint.com/nnn-linux-terminal-file-browser/)
+- [gHacks Tech News](https://www.ghacks.net/2019/11/01/nnn-is-an-excellent-command-line-based-file-manager-for-linux-macos-and-bsds/)
+- Hacker News [[1](https://news.ycombinator.com/item?id=18520898)] [[2](https://news.ycombinator.com/item?id=19850656)]
 - [It's FOSS](https://itsfoss.com/nnn-file-browser-linux/)
-- [LinuxLinks](https://www.linuxlinks.com/nnn-fast-and-flexible-file-manager/)
-- [Ubuntu Full Circle Magazine - Issue 135](https://fullcirclemagazine.org/issue-135/)
+- [Linux Format Issue 265; Manage files with nnn](https://linuxformat.com/archives?issue=265)
+- LinuxLinks [[1](https://www.linuxlinks.com/nnn-fast-and-flexible-file-manager/)] [[2](https://www.linuxlinks.com/bestconsolefilemanagers/)] [[3](https://www.linuxlinks.com/excellent-system-tools-nnn-portable-terminal-file-manager/)]
+- [Linux Magazine; FOSSPicks](https://www.linux-magazine.com/Issues/2017/205/FOSSPicks/(offset)/15)
+- [Make Tech Easier](https://www.maketecheasier.com/nnn-file-manager-terminal/)
+- [Opensource.com](https://opensource.com/article/22/12/linux-file-manager-nnn)
+- [Open Source For You](https://www.opensourceforu.com/2019/12/nnn-this-feature-rich-terminal-file-manager-will-enhance-your-productivity/)
+- [PCLinuxOS Magazine Issue June 2021](https://pclosmag.com/html/Issues/202106/page08.html)
+- [Suckless Rocks](https://suckless.org/rocks/)
+- [Ubuntu Full Circle Magazine Issue 135; Review: nnn](https://fullcirclemagazine.org/issue-135/)
+- [Using and Administering Linux: Volume 2: Zero to SysAdmin: Advanced Topics](https://books.google.com/books?id=MqjDDwAAQBAJ&pg=PA32)
+- [Wikipedia](https://en.wikipedia.org/wiki/Nnn_(file_manager))
 
-#### DEVELOPERS
+## Developers
 
-1. Copyright © 2014-2016 Lazaros Koromilas
-2. Copyright © 2014-2016 Dimitris Papastamos
-3. Copyright © 2016-2018 [Arun Prakash Jana](https://github.com/jarun)
+- [Arun Prakash Jana](https://github.com/jarun) (Copyright © 2016-2023)
+- [0xACE](https://github.com/0xACE)
+- [Anna Arad](https://github.com/annagrram)
+- [KlzXS](https://github.com/KlzXS)
+- [Léo Villeveygoux](https://github.com/leovilok)
+- [Luuk van Baal](https://github.com/luukvbaal)
+- [NRK](https://codeberg.org/NRK)
+- [Sijmen J. Mulder](https://github.com/sjmulder)
+- and other contributors
+
+Visit the [Tracker](https://github.com/jarun/nnn/issues/1546) thread for a list of features in progress and anything up for grabs. Feel free to [discuss](https://github.com/jarun/nnn/discussions) new ideas or enhancement requests.

misc/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+Contributions to nnn are welcome! There's always an open issue with the current ToDo list, which contains the proposed features for the next release you can get your hands on. Any small changes or ideas should go in there, rather than in a separate issue.
+
+Before suggesting changes, please read a bit about [the design principles nnn follows](https://github.com/jarun/nnn/wiki/concepts#design), and make sure you aren't breaking any of them.
+
+Feel free to join the [Discussions](https://github.com/jarun/nnn/discussions). We highly recommended a discussion before raising a PR.
+
+## Coding standard
+
+`nnn` follows the Linux kernel coding style closely. The C source code uses TABs and the plugins use 4 spaces for indentation.
+
+- Code changes should not break the patch framework. Please run `make checkpatches` to ensure.
+- Run `make shellcheck` if adding/modifying plugins.
+
+CI runs patch framework sanity test and `shellcheck`. Please watch out for any failures after raising the PR.
+
+## Resources
+The [wiki](https://github.com/jarun/nnn/wiki/Developer-guides) has some resources for developers you might be interested in: building, debugging...
+
+## Communication
+* [Gitter chat](https://gitter.im/jarun/nnn)
+* [GitHub team](https://github.com/nnn-devs) (if you plan on contributing regularly, ask for an invitation).

misc/auto-completion/bash/nnn-completion.bash

@@ -0,0 +1,74 @@
+#
+# Rudimentary Bash completion definition for nnn.
+#
+# Author:
+#   Arun Prakash Jana <engineerarun@gmail.com>
+#
+
+_nnn ()
+{
+    COMPREPLY=()
+    local IFS=$'\n'
+    local cur=$2 prev=$3
+    local -a opts
+    opts=(
+        -a
+        -A
+        -b
+        -B
+        -c
+        -C
+        -d
+        -D
+        -e
+        -E
+        -f
+        -g
+        -H
+        -i
+        -J
+        -K
+        -l
+        -n
+        -o
+        -p
+        -P
+        -Q
+        -r
+        -R
+        -s
+        -S
+        -t
+        -T
+        -u
+        -U
+        -V
+        -x
+        -h
+    )
+    if [[ $prev == -b ]]; then
+        local bookmarks=$(echo $NNN_BMS | awk -F: -v RS=\; '{print $1}')
+        COMPREPLY=( $(compgen -W "$bookmarks" -- "$cur") )
+    elif [[ $prev == -l ]]; then
+        return 1
+    elif [[ $prev == -p ]]; then
+        COMPREPLY=( $(compgen -f -d -- "$cur") )
+    elif [[ $prev == -P ]]; then
+        local plugins=$(echo $NNN_PLUG | awk -F: -v RS=\; '{print $1}')
+        COMPREPLY=( $(compgen -W "$plugins" -- "$cur") )
+    elif [[ $prev == -s ]]; then
+        local sessions_dir=${XDG_CONFIG_HOME:-$HOME/.config}/nnn/sessions
+        COMPREPLY=( $(cd "$sessions_dir" && compgen -f -d -- "$cur") )
+    elif [[ $prev == -t ]]; then
+        return 1
+    elif [[ $prev == -T ]]; then
+        local keys=$(echo "a d e r s t v" | awk -v RS=' ' '{print $0}')
+        COMPREPLY=( $(compgen -W "$keys" -- "$cur") )
+    elif [[ $cur == -* ]]; then
+        COMPREPLY=( $(compgen -W "${opts[*]}" -- "$cur") )
+    else
+        COMPREPLY=( $(compgen -f -d -- "$cur") )
+    fi
+}
+
+complete -o filenames -F _nnn nnn

misc/auto-completion/fish/nnn.fish

@@ -0,0 +1,46 @@
+#
+# Fish completion definition for nnn.
+#
+# Author:
+#   Arun Prakash Jana <engineerarun@gmail.com>
+#
+
+if test -n "$XDG_CONFIG_HOME"
+    set sessions_dir $XDG_CONFIG_HOME/.config/nnn/sessions
+else
+    set sessions_dir $HOME/.config/nnn/sessions
+end
+
+complete -c nnn -s a    -d 'auto-create NNN_FIFO'
+complete -c nnn -s A    -d 'disable dir auto-enter'
+complete -c nnn -s b -r -d 'bookmark key to open' -x -a '(echo $NNN_BMS | awk -F: -v RS=\; \'{print $1"\t"$2}\')'
+complete -c nnn -s B    -d 'use bsdtar for archives'
+complete -c nnn -s c    -d 'cli-only opener'
+complete -c nnn -s C    -d 'color by context'
+complete -c nnn -s d    -d 'start in detail mode'
+complete -c nnn -s D    -d 'dirs in context color'
+complete -c nnn -s e    -d 'open text files in $VISUAL/$EDITOR/vi'
+complete -c nnn -s E    -d 'use EDITOR for undetached edits'
+complete -c nnn -s f    -d 'use readline history file'
+complete -c nnn -s g    -d 'regex filters'
+complete -c nnn -s H    -d 'show hidden files'
+complete -c nnn -s i    -d 'show current file info'
+complete -c nnn -s J    -d 'no auto-advance on selection'
+complete -c nnn -s K    -d 'detect key collision and exit'
+complete -c nnn -s l -r -d 'lines to move per scroll'
+complete -c nnn -s n    -d 'start in type-to-nav mode'
+complete -c nnn -s o    -d 'open files only on Enter'
+complete -c nnn -s p -r -d 'copy selection to file' -a '-\tstdout'
+complete -c nnn -s P -r -d 'plugin key to run' -x -a '(echo $NNN_PLUG | awk -F: -v RS=\; \'{print $1"\t"$2}\')'
+complete -c nnn -s Q    -d 'disable quit confirmation'
+complete -c nnn -s r    -d 'show cp, mv progress (Linux-only)'
+complete -c nnn -s R    -d 'disable rollover at edges'
+complete -c nnn -s s -r -d 'load session by name' -x -a '@\t"last session" (ls $sessions_dir)'
+complete -c nnn -s S    -d 'persistent session'
+complete -c nnn -s t -r -d 'timeout in seconds to lock'
+complete -c nnn -s T -r -d 'a d e r s t v'
+complete -c nnn -s u    -d 'use selection (no prompt)'
+complete -c nnn -s U    -d 'show user and group'
+complete -c nnn -s V    -d 'show program version and exit'
+complete -c nnn -s x    -d 'notis, sel to system clipboard, xterm title'
+complete -c nnn -s h    -d 'show program help'

misc/auto-completion/zsh/_nnn

@@ -0,0 +1,47 @@
+#compdef nnn
+#
+# Completion definition for nnn.
+#
+# Author:
+#   Arun Prakash Jana <engineerarun@gmail.com>
+#
+
+setopt localoptions noshwordsplit noksharrays
+local -a args
+args=(
+    '(-a)-a[auto-create NNN_FIFO]'
+    '(-A)-A[disable dir auto-enter]'
+    '(-b)-b[bookmark key to open]:key char'
+    '(-B)-B[use bsdtar for archives]'
+    '(-c)-c[cli-only opener]'
+    '(-C)-C[color by context]'
+    '(-d)-d[start in detail mode]'
+    '(-D)-D[dirs in context color]'
+    '(-e)-e[open text files in $VISUAL/$EDITOR/vi]'
+    '(-E)-E[use EDITOR for undetached edits]'
+    '(-f)-f[use readline history file]'
+    '(-g)-g[regex filters]'
+    '(-H)-H[show hidden files]'
+    '(-i)-i[show current file info]'
+    '(-J)-J[no auto-advance on selection]'
+    '(-K)-K[detect key collision and exit]'
+    '(-l)-l[lines to move per scroll]:val'
+    '(-n)-n[start in type-to-nav mode]'
+    '(-o)-o[open files only on Enter]'
+    '(-p)-p[copy selection to file]:file name'
+    '(-P)-P[plugin key to run]:key char'
+    '(-Q)-Q[disable quit confirmation]'
+    '(-r)-r[show cp, mv progress (Linux-only)]'
+    '(-R)-R[disable rollover at edges]'
+    '(-s)-s[load session]:session name'
+    '(-S)-S[persistent session]'
+    '(-t)-t[timeout to lock]:seconds'
+    '(-T)-T[a d e r s t v]:key'
+    '(-u)-u[use selection (no prompt)]'
+    '(-U)-U[show user and group]'
+    '(-V)-V[show program version and exit]'
+    '(-x)-x[notis, sel to system clipboard, xterm title]'
+    '(-h)-h[show program help]'
+    '*:filename:_files'
+)
+_arguments -S -s $args

misc/desktop/nnn.desktop

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Type=Application
+Name=nnn
+Comment=Terminal file manager
+Exec=nnn
+Terminal=true
+Icon=nnn
+MimeType=inode/directory
+Categories=System;FileTools;FileManager;ConsoleOnly
+Keywords=File;Manager;Management;Explorer;Launcher

misc/haiku/Makefile

@@ -0,0 +1,250 @@
+VERSION = $(shell grep -m1 VERSION $(SRC) | cut -f 2 -d'"')
+
+PREFIX ?= /boot/system/non-packaged
+MANPREFIX ?= $(PREFIX)/documentation/man
+STRIP ?= strip
+PKG_CONFIG ?= pkg-config
+INSTALL ?= install
+CP ?= cp
+
+CFLAGS_OPTIMIZATION ?= -O3
+
+O_DEBUG := 0  # debug binary
+O_NORL := 0  # no readline support
+O_PCRE := 0  # link with PCRE library
+O_NOLC := 0  # no locale support
+O_NOMOUSE := 0  # no mouse support
+O_NOBATCH := 0  # no built-in batch renamer
+O_NOFIFO := 0  # no FIFO previewer support
+O_CTX8 := 0  # enable 8 contexts
+O_ICONS := 0  # support icons-in-terminal
+O_NERD := 0  # support icons-nerdfont
+O_QSORT := 0  # use Alexey Tourbin's QSORT implementation
+O_BENCH := 0  # benchmark mode (stops at first user input)
+O_NOSSN := 0  # disable session support
+O_NOUG := 0  # disable user, group name in status bar
+O_NOX11 := 0  # disable X11 integration
+O_MATCHFLTR := 0  # allow filters without matches
+
+# User patches
+O_GITSTATUS := 0 # add git status to detail view
+O_NAMEFIRST := 0 # print file name first, add uid and guid to detail view
+
+ifeq ($(strip $(O_GITSTATUS)),1)
+	LDLIBS += -lgit2
+endif
+
+# convert targets to flags for backwards compatibility
+ifneq ($(filter debug,$(MAKECMDGOALS)),)
+	O_DEBUG := 1
+endif
+ifneq ($(filter norl,$(MAKECMDGOALS)),)
+	O_NORL := 1
+endif
+ifneq ($(filter nolc,$(MAKECMDGOALS)),)
+	O_NORL := 1
+	O_NOLC := 1
+endif
+
+ifeq ($(strip $(O_DEBUG)),1)
+	CPPFLAGS += -DDEBUG
+	CFLAGS += -g
+	LDLIBS += -lrt
+endif
+
+ifeq ($(strip $(O_NORL)),1)
+	CPPFLAGS += -DNORL
+else ifeq ($(strip $(O_STATIC)),1)
+	CPPFLAGS += -DNORL
+else
+	LDLIBS += -lreadline
+endif
+
+ifeq ($(strip $(O_PCRE)),1)
+	CPPFLAGS += -DPCRE
+	LDLIBS += -lpcre
+endif
+
+ifeq ($(strip $(O_NOLC)),1)
+	ifeq ($(strip $(O_ICONS)),1)
+$(info *** Ignoring O_NOLC since O_ICONS is set ***)
+	else ifeq ($(strip $(O_NERD)),1)
+$(info *** Ignoring O_NOLC since O_NERD is set ***)
+	else
+		CPPFLAGS += -DNOLC
+	endif
+endif
+
+ifeq ($(strip $(O_NOMOUSE)),1)
+	CPPFLAGS += -DNOMOUSE
+endif
+
+ifeq ($(strip $(O_NOBATCH)),1)
+	CPPFLAGS += -DNOBATCH
+endif
+
+ifeq ($(strip $(O_NOFIFO)),1)
+	CPPFLAGS += -DNOFIFO
+endif
+
+ifeq ($(strip $(O_CTX8)),1)
+	CPPFLAGS += -DCTX8
+endif
+
+ifeq ($(strip $(O_ICONS)),1)
+	CPPFLAGS += -DICONS
+endif
+
+ifeq ($(strip $(O_NERD)),1)
+	CPPFLAGS += -DNERD
+endif
+
+ifeq ($(strip $(O_QSORT)),1)
+	CPPFLAGS += -DTOURBIN_QSORT
+endif
+
+ifeq ($(strip $(O_BENCH)),1)
+	CPPFLAGS += -DBENCH
+endif
+
+ifeq ($(strip $(O_NOSSN)),1)
+	CPPFLAGS += -DNOSSN
+endif
+
+ifeq ($(strip $(O_NOUG)),1)
+	CPPFLAGS += -DNOUG
+endif
+
+ifeq ($(strip $(O_NOX11)),1)
+	CPPFLAGS += -DNOX11
+endif
+
+ifeq ($(strip $(O_MATCHFLTR)),1)
+	CPPFLAGS += -DMATCHFLTR
+endif
+
+ifeq ($(shell $(PKG_CONFIG) ncursesw && echo 1),1)
+	CFLAGS_CURSES ?= $(shell $(PKG_CONFIG) --cflags ncursesw)
+	LDLIBS_CURSES ?= $(shell $(PKG_CONFIG) --libs   ncursesw)
+else ifeq ($(shell $(PKG_CONFIG) ncurses && echo 1),1)
+	CFLAGS_CURSES ?= $(shell $(PKG_CONFIG) --cflags ncurses)
+	LDLIBS_CURSES ?= $(shell $(PKG_CONFIG) --libs   ncurses)
+else
+	LDLIBS_CURSES ?= -lncurses
+endif
+
+ifeq ($(shell uname -s), Haiku)
+	LDLIBS_HAIKU ?= -lstdc++ -lgnu -lbe
+	SRC_HAIKU ?= misc/haiku/nm.cpp
+	OBJS_HAIKU ?= misc/haiku/nm.o
+endif
+
+CFLAGS += -std=c11 -Wall -Wextra -Wshadow
+CFLAGS += $(CFLAGS_OPTIMIZATION)
+CFLAGS += $(CFLAGS_CURSES)
+
+LDLIBS += $(LDLIBS_CURSES) -lpthread $(LDLIBS_HAIKU)
+# static compilation needs libgpm development package
+ifeq ($(strip $(O_STATIC)),1)
+	LDFLAGS += -static
+	LDLIBS += -lgpm
+endif
+
+DISTFILES = src nnn.1 Makefile README.md LICENSE
+SRC = src/nnn.c
+HEADERS = src/nnn.h
+BIN = nnn
+OBJS := nnn.o $(OBJS_HAIKU)
+
+GITSTATUS = patches/gitstatus
+NAMEFIRST = patches/namefirst
+
+all: $(BIN)
+
+ifeq ($(shell uname -s), Haiku)
+$(OBJS_HAIKU): $(SRC_HAIKU)
+	$(CC) -c $(CPPFLAGS) $(CFLAGS) -o $@ $<
+endif
+
+nnn.o: $(SRC) $(HEADERS)
+	$(CC) -c $(CPPFLAGS) $(CFLAGS) -o $@ $<
+
+$(BIN): $(OBJS)
+	@$(MAKE) --silent prepatch
+	$(CC) $(LDFLAGS) -o $@ $^ $(LDLIBS)
+	@$(MAKE) --silent postpatch
+
+# targets for backwards compatibility
+debug: $(BIN)
+norl: $(BIN)
+nolc: $(BIN)
+
+install: all
+	$(INSTALL) -m 0755 -d $(DESTDIR)$(PREFIX)/bin
+	$(INSTALL) -m 0755 $(BIN) $(DESTDIR)$(PREFIX)/bin
+	$(INSTALL) -m 0755 -d $(DESTDIR)$(MANPREFIX)/man1
+	$(INSTALL) -m 0644 $(BIN).1 $(DESTDIR)$(MANPREFIX)/man1
+
+uninstall:
+	$(RM) $(DESTDIR)$(PREFIX)/bin/$(BIN)
+	$(RM) $(DESTDIR)$(MANPREFIX)/man1/$(BIN).1
+
+strip: $(BIN)
+	$(STRIP) $^
+
+static:
+	# regular static binary
+	make O_STATIC=1 strip
+	mv $(BIN) $(BIN)-static
+
+dist:
+	mkdir -p nnn-$(VERSION)
+	$(CP) -r $(DISTFILES) nnn-$(VERSION)
+	mkdir -p nnn-$(VERSION)/misc
+	$(CP) -r misc/haiku nnn-$(VERSION)/misc
+	tar -cf - nnn-$(VERSION) | gzip > nnn-$(VERSION).tar.gz
+	$(RM) -r nnn-$(VERSION)
+
+sign:
+	git archive -o nnn-$(VERSION).tar.gz --format tar.gz --prefix=nnn-$(VERSION)/ v$(VERSION)
+	gpg --detach-sign --yes nnn-$(VERSION).tar.gz
+	rm -f nnn-$(VERSION).tar.gz
+
+upload-local: sign static
+	$(eval ID=$(shell curl -s 'https://api.github.com/repos/jarun/nnn/releases/tags/v$(VERSION)' | jq .id))
+	# upload sign file
+	curl -XPOST 'https://uploads.github.com/repos/jarun/nnn/releases/$(ID)/assets?name=nnn-$(VERSION).tar.gz.sig' \
+	    -H 'Authorization: token $(NNN_SIG_UPLOAD_TOKEN)' -H 'Content-Type: application/pgp-signature' \
+	    --upload-file nnn-$(VERSION).tar.gz.sig
+	tar -zcf $(BIN)-static-$(VERSION).x86_64.tar.gz $(BIN)-static
+	# upload static binary
+	curl -XPOST 'https://uploads.github.com/repos/jarun/nnn/releases/$(ID)/assets?name=$(BIN)-static-$(VERSION).x86_64.tar.gz' \
+	    -H 'Authorization: token $(NNN_SIG_UPLOAD_TOKEN)' -H 'Content-Type: application/x-sharedlib' \
+	    --upload-file $(BIN)-static-$(VERSION).x86_64.tar.gz
+
+clean:
+	$(RM) -f $(BIN) nnn-$(VERSION).tar.gz *.sig $(BIN)-static $(BIN)-static-$(VERSION).x86_64.tar.gz
+
+prepatch:
+ifeq ($(strip $(O_NAMEFIRST)),1)
+	patch --forward --strip=1 --input=$(NAMEFIRST)/mainline.diff
+ifeq ($(strip $(O_GITSTATUS)),1)
+	patch --forward --strip=1 --input=$(GITSTATUS)/namefirst.diff
+endif
+else ifeq ($(strip $(O_GITSTATUS)),1)
+	patch --forward --strip=1 --input=$(GITSTATUS)/mainline.diff
+endif
+
+postpatch:
+ifeq ($(strip $(O_NAMEFIRST)),1)
+ifeq ($(strip $(O_GITSTATUS)),1)
+	patch --reverse --strip=1 --input=$(GITSTATUS)/namefirst.diff
+endif
+	patch --reverse --strip=1 --input=$(NAMEFIRST)/mainline.diff
+else ifeq ($(strip $(O_GITSTATUS)),1)
+	patch --reverse --strip=1 --input=$(GITSTATUS)/mainline.diff
+endif
+
+skip: ;
+
+.PHONY: all install uninstall strip static dist sign upload-local clean

misc/haiku/haiku_interop.h

@@ -0,0 +1,14 @@
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef struct haiku_nm_t *haiku_nm_h;
+haiku_nm_h haiku_init_nm();
+void haiku_close_nm(haiku_nm_h hnd);
+int haiku_watch_dir(haiku_nm_h hnd, const char *path);
+int haiku_stop_watch(haiku_nm_h hnd);
+int haiku_is_update_needed(haiku_nm_h hnd);
+
+#ifdef __cplusplus
+}
+#endif

misc/haiku/nm.cpp

@@ -0,0 +1,83 @@
+#include <Directory.h>
+#include <Looper.h>
+#include <NodeMonitor.h>
+#include <MessageFilter.h>
+
+#include "haiku_interop.h"
+
+filter_result dir_mon_flt(BMessage *message, BHandler **hnd, BMessageFilter *fltr) {
+	(void) hnd;
+	(void) fltr;
+
+	if (message->what == B_NODE_MONITOR) {
+		int32 val;
+		message->FindInt32("opcode", &val);
+
+		switch (val) {
+			case B_ENTRY_CREATED:
+			case B_ENTRY_MOVED:
+			case B_ENTRY_REMOVED:
+				return B_DISPATCH_MESSAGE;
+		}
+	}
+
+	return B_SKIP_MESSAGE;
+}
+
+class DirectoryListener : public BLooper {
+public:
+	bool recv_reset() {
+		Lock();
+		bool val = _ev_on;
+		_ev_on = false;
+		Unlock();
+
+		return val;
+	}
+private:
+	void MessageReceived(BMessage * message) override {
+		Lock();
+		_ev_on = true;
+		Unlock();
+		BLooper::MessageReceived(message);
+	}
+
+	bool _ev_on = false;
+};
+
+struct haiku_nm_t {
+	haiku_nm_t() {
+		dl = new DirectoryListener();
+		flt = new BMessageFilter(B_PROGRAMMED_DELIVERY, B_LOCAL_SOURCE, dir_mon_flt);
+		dl->AddCommonFilter(flt);
+		dl->Run();
+	}
+
+	DirectoryListener *dl;
+	BMessageFilter *flt;
+	node_ref nr;
+};
+
+haiku_nm_h haiku_init_nm() {
+	return new haiku_nm_t();
+}
+
+void haiku_close_nm(haiku_nm_h hnd) {
+	delete hnd->flt;
+	// This is the way of deleting a BLooper
+	hnd->dl->PostMessage(B_QUIT_REQUESTED);
+	delete hnd;
+}
+int haiku_watch_dir(haiku_nm_h hnd, const char *path) {
+	BDirectory dir(path);
+	dir.GetNodeRef(&(hnd->nr));
+
+	return watch_node(&(hnd->nr), B_WATCH_DIRECTORY, nullptr, hnd->dl);
+}
+int haiku_stop_watch(haiku_nm_h hnd) {
+	return watch_node(&(hnd->nr), B_STOP_WATCHING, nullptr, hnd->dl);
+}
+
+int haiku_is_update_needed(haiku_nm_h hnd) {
+	return hnd->dl->recv_reset();
+}

misc/haiku/nnn-master.recipe

@@ -0,0 +1,58 @@
+SUMMARY="A blazing-fast lightweight terminal file manager"
+DESCRIPTION="nnn is a full-featured terminal file manager. It's tiny and \
+nearly 0-config with an incredible performance.
+
+nnn is also a du analyzer, an app launcher, a batch renamer and a file picker. \
+The plugin repository has tons of plugins and documentation to extend the \
+capabilities further. You can plug new functionality and play with a \
+custom keybind instantly. There's an independent (neo)vim plugin.
+
+It runs smoothly on the Raspberry Pi, Termux on Android, Linux, macOS, BSD, \
+Cygwin, WSL, Haiku and works seamlessly with DEs and GUI utilities.
+
+Visit the Wiki for concepts, program usage, how-tos and troubleshooting."
+HOMEPAGE="https://github.com/jarun/nnn"
+COPYRIGHT="2016-2023 Arun Prakash Jana"
+LICENSE="BSD (2-clause)"
+REVISION="1"
+SOURCE_URI="git://github.com/jarun/nnn.git"
+
+ARCHITECTURES="!x86_gcc2 x86_64"
+SECONDARY_ARCHITECTURES="x86"
+
+PROVIDES="
+	nnn$secondaryArchSuffix = $portVersion
+	cmd:nnn = $portVersion
+	"
+REQUIRES="
+	haiku$secondaryArchSuffix
+	file$secondaryArchSuffix
+	lib:libncurses$secondaryArchSuffix
+	lib:libreadline$secondaryArchSuffix
+	"
+
+BUILD_REQUIRES="
+	haiku${secondaryArchSuffix}_devel
+	devel:libncurses$secondaryArchSuffix
+	devel:libreadline$secondaryArchSuffix
+	"
+BUILD_PREREQUIRES="
+	cmd:g++$secondaryArchSuffix
+	cmd:gcc$secondaryArchSuffix
+	cmd:install
+	cmd:ld$secondaryArchSuffix
+	cmd:make
+	cmd:pkg_config$secondaryArchSuffix
+	"
+
+BUILD()
+{
+	make -f misc/haiku/Makefile $jobArgs
+}
+
+INSTALL()
+{
+	make -f misc/haiku/Makefile install PREFIX=$prefix
+
+	addResourcesToBinaries misc/haiku/nnn.rdef $prefix/bin/nnn
+}

misc/haiku/nnn.rdef

@@ -0,0 +1,140 @@
+
+// How to apply this resource definition file manually (Haiku only):
+// First, make sure that nnn is compiled.
+// Next, run "rc nnn.rdef -o nnn.rsrc" to compile this resource file.
+// Then, run "xres -o nnn nnn.rsrc" to apply the resource file to nnn.
+// Finally, run "mimeset -f nnn" to refresh Haiku's MIME database.
+
+resource app_signature "application/x-vnd.Jarun-nnn";
+
+resource app_version {
+	major  = 4,
+	middle = 9,
+	minor  = 0,
+
+	variety = B_APPV_DEVELOPMENT,
+	internal = 0,
+
+	short_info = "nnn",
+	long_info  = "A blazing-fast lightweight terminal file manager"
+};
+
+resource app_flags B_MULTIPLE_LAUNCH | B_BACKGROUND_APP | B_ARGV_ONLY;
+
+resource file_types message {
+    "types" = "application/x-vnd.Be-directory"
+};
+
+resource vector_icon {
+	$"6E6369660805FF032E343602011202B8E0C339BAC3B985CFB8B7E549F5FF4994"
+	$"000000FFFF0000020112023745BA3659FABA87063B846942D03049EBF80000FF"
+	$"FF0000020112033BE54D39FE49B857E23A493A4A91FF489000000000AF0000FF"
+	$"00FF020112022D299A3B3A49BCE2FF2ED4134A65A94C096A0000FFFF00000201"
+	$"1202365425358147B6C63037AFB14669664AB9F30000FFFF0000020112023673"
+	$"5235AC4EB7FB7138A81D481E6A48C2C50000FFFF00000F0241BE60B360BE60B3"
+	$"60BE5FB360BE3EB364BE46B362BE2AB369BE17B371BE1FB36DBE03B379BDF3B3"
+	$"85BDFCB37EBDE3B38EBDCEB3A0BDD9B398BDB8B3B1BD8BB3DDBDA4B3C5BD58B4"
+	$"0EBCCDB4A0BD17B450BC93B4DBBC36B539BC61B50DBC35B537BC32B536BC34B5"
+	$"37BBE6B50ABB0FB48BBB7EB4CEBA9EB448B9E8B3DDBA36B40AB9C1B3C5B987B3"
+	$"A5B9A0B3B3B97AB39FB967B394B971B399B961B391B954B38CB95DB390B94FB3"
+	$"89B942B385B94CB388B93FB382B92FB37EB939B381B926B37DB8FFB379B900B3"
+	$"79B8E9B379B87FB3A4B8B1B37DB84CB3C8B82FB418B838B3FBB81FB453B826B4"
+	$"89B825B466B827B4CDB841B5F9B82FB534B848B656B854B6F9B84EB6B1B85AB7"
+	$"41B85CB776B85CB782B85CB75BB83AB7A7B860B772B814B7DBB767B88FB7CEB8"
+	$"29B6E7B90DB65CB9D1B694B955B626BA4CB62ABB5AB62CBAB9B629BC54B606BC"
+	$"9DB634BC1BB5CDBD3EB4B1BEF5B597BDA1B445BF96B3B0C089B3DDC033B31AC1"
+	$"A4B318C3DAB2D2C2D1B371C536B61FC639B4ABC60FB641C680B698C6F2B65CC6"
+	$"CFB698C6F2B69AC6F2B69AC6F2B71EC742B838C6F9B7BDC733B8B2C6BEB96CC5"
+	$"E2B919C65DB99BC59FBA11C4C4B9D8C530BA78C400BB14C34ABAB4C3A1BB75C2"
+	$"F2BD20C209BC0BC29ABDDEC1A6BED6C108BE5244BED6C121BED8C151BED9C139"
+	$"BECCC24CBE29C3E9BE9AC307BDC3C4B6BC1DC63ABD84C4F7BB43C700BA57C7FA"
+	$"BAB9C781B9F5C872B99DC966B9BCC8EBB961CA48B95ECBBBB955CB0830CBFDB9"
+	$"65CC7FB962CC3DBFC3CC7F60CC7FC621CC7FCC7ECBDECC7ACA9BCC7CCB3CCC6F"
+	$"C6D6CA63BE51CB9AC1F5C98736C731B8ADC899BA16C5F2B76EC2C4B648C477B6"
+	$"A1C212B625BFF7B63643B625C013B634C04A28C02FB631C027B5E2BFE0B546C0"
+	$"04B593BFAFB4D8BF5EB436BF81B47BBF4DB415BF30B3E0BF3FB3F8BF28B3D3BF"
+	$"18B3BBBF22B3C9BF11B3B4BEFFB39DBF0CB3ABBEF8B398BEE2B385BEF1B390BE"
+	$"DAB380BEC5B375BED1B37ABEB9B36EBE96B364BE96B364BE96B364BE95B364BE"
+	$"95B364BE93B364BE93B364BE93B364BE93B364BE60B360BE60B360BE60B36002"
+	$"23BCA6C6D2BCA6C6D2BE0FC58CBEDFC443BE70C523BF5BC34EBFA3C159BF97C2"
+	$"6DBFAAC0AEBF80BFC2BF99BFDABF7ABFBBBF34BFE33FBFC7BEA9C048BCC3C154"
+	$"BDD9C0C2BA90C277B95BC467BA2FC2CFB926C4CCB8C5C56FB8E2C542B83EC636"
+	$"B702C644B780C68FB6CEC624B6A8C5B6B6B4C5FDB6A1C587B660C581B69CC584"
+	$"B510C56EB3DDC3A7B426C4C2B3ACC2EDB465C0E9B3E0C1E1B481C0B1B55ABF67"
+	$"B4F0C005B642BE10B6C7BCE0B689BD92B6F5BC5DB6F6BB5AB6F5BC55B6F7BA1A"
+	$"B7F5B921B6F5BA1EB8CDB84DB928B776B928B7CEB928B757B90CB5E9B91BB6A4"
+	$"B8EBB45DB8FFB446B8EBB446B907B446BAA6B53A31B4B4BB85B5C0BC54B62FBC"
+	$"47B62FBC6128BD60B52BBCDBB5BABDF2B491BE6BB42BBE5EB428BE78B42EBF27"
+	$"B59ABEC3B4C2BF5DB613BFCBB704BF95B68DBFDEB703C005B702BFF2B702C0F0"
+	$"B6F1C29CB70FC229B6F9C42AB761C6A0B93DC57CB818C7F0BA8FC9A0BE92C8CC"
+	$"BC13CACFC21CCBAECA9DCBA3C6F5CBAFCAFBCBB15ECBB0CB56C5D85EBA295EC0"
+	$"015EBA21CB0FBA61C99A32CA68BA97C8CBBCA6C6D2BAF4C858BCA6C6D20215C8"
+	$"1C5EC81C5EC80FCB23C7DAC9A7C805CA9DC79EC84BC6E7C4FBC747C6A251C353"
+	$"C5B5C054C61BC1ACC54FBEF9C4A1BD7F4DBDEFC457BD12C3C3BC5FC40EBCB4C3"
+	$"79BC0DC2D8BB87C32B36C285BB4BC1C8BAF0C22BBB19C195BADDC120BAC444BA"
+	$"D2C13EBADEC177BB1CC15CBAF6C19EBB66C1B9BC18C1B5BBBAC1BCBC74C184BD"
+	$"41C1ABBCD8C15CBDA9C0C1BE85C11DBE17C0683EBF5CBFD2BFF2BF64BF69BFCD"
+	$"BF80BFC2BF7EBFBFBF99BFDABFA3C159BFAAC0AEBF97C26DBEE1C443BF5BC34E"
+	$"BE70C523BCA6C6D2BE0FC58CBAF4C858BA61C99ABA97C8CB32CA68BA295EBA21"
+	$"CB0FBECF5EC81C5EC3755EC81C5E021CBE6BB42BBE6BB42BBE5EB428BD60B52B"
+	$"BDF2B491BCDBB5BABC54B62FBC6128BC47B62FBAA6B53ABB85B5C031B4B4B8FF"
+	$"B446B907B446B8EBB446B90CB5E9B8EBB45DB91BB6A4B928B776B928B757B928"
+	$"B7CEB7F5B921B8CDB84DB6F5BA1EB6F6BB5AB6F7BA1AB6F5BC55B6C7BCE0B6F5"
+	$"BC5DB689BD92B55ABF67B642BE10B4F0C005B465C0E9B481C0B1B3E0C1E1B3DD"
+	$"C3A7B3ACC2EEB426C4C2B660C581B510C56EB680C583B697C58AB68FC583B74F"
+	$"C477B90545B815C32CB9FCC041BC10BD70BB07BEB8BC94BCCCBD99BBBBBD18BC"
+	$"36BE19BB41BF0DBAA0BE96BADFBF49BA82BFBBBA5FBF82BA6BBFF3BA52C05CBA"
+	$"59C028BA50C090BA6143BA94C0C2BA75C103BA9FC120BAC4C110BAB6C125BAC5"
+	$"C130BAC7C12ABAC6C0BBB986BFCEB704C043B846BFCDB704BFCBB704BFCDB704"
+	$"BF95B68BBF27B59ABF5DB613BEC4B4C2BE6BB42BBE78B42EBE6BB42B0207BFCE"
+	$"B704BFCEB704C063B85EC18FBB10C0F9B9B7C1C2BB1DC2BCBB74C28DBB61C6B9"
+	$"BBACC6A0B93DCB98BF33C57CB818C29CB70FC42AB761C229B6F9C005B702C0F0"
+	$"B6F1BFF3B702BFCEB704BFDFB703BFCEB7040207BCA6C6D2BCA6C6D2474ACB64"
+	$"C69E5149CB91C805CBAECA9DCBABC963CBAFCAFBCBB15ECBB0CB56C5D85EBA29"
+	$"5EC0015EBA21CB0FBA61C99A32CA68BA97C8CBBCA6C6D2BAF4C858BCA6C6D206"
+	$"04BFB67CC579B67CC579B7C1C49BB900C2AFB8F9C22FB906C32EB6F5C5CDB841"
+	$"C6ABB5AA4DB67CC5790211BD5BC297BD5BC297BDC5C279BEE5C244BE49C25EBF"
+	$"83C22BC0E8C21FC02EC21FC19DC21FC2AAC26CC234C238C323C29CC3C4C33EC3"
+	$"81C2E1C40BC399C45BC485C43EC405C478C502C487C626C487C58DC487C7BCC4"
+	$"87CAE7C487C9514ACAE746CAE7C2EFCAE746C96B46C67346C7EF46C5A0C1DDC4"
+	$"ABC20BC508C1AFC44FC0C2C421C151C421C097C421C040C424C06D4BC018C428"
+	$"BFBFC434BFEEC42CBFBFC66FBFBFCAE7BFBFC8ACBEF3CAE7BD5BCAE7BE27CAE7"
+	$"BD5BC821BD5BC297BD5BC55BBD5BC2970211BE27C363BE27C363BE91C345BFB1"
+	$"C310BF16C32AC050C2F7C1B4C2EBC0FAC2EBC269C2EBC376C338C300C304C3EF"
+	$"C368C490C40AC44DC3ADC4D7C465C527C551C50AC4D1C544C5CE4EC6F24EC659"
+	$"4EC8454ECAE74EC9964CCAE748CAE74ACAE748C9C548C77F48C8A148C6B9C2A9"
+	$"C5D4C2D7C62BC27BC57FC18EC553C21DC553C163C553C10CC557C1394EC0E4C5"
+	$"5A42C565C0BAC55E42C73A42CAE742C91140CAE73CCAE73ECAE73CC866BE27C3"
+	$"63BE27C5E4BE27C3630206B669C28FB669C28FB669C25DB613C207B642C21EB5"
+	$"8645B4F5C338B507C245B4F1C374B4F7C3BEB4F3C3B2B503C3DAB59DC370B507"
+	$"C3D7B632C309B669C28FB669C2CAB669C28F0207BAE6BC94BAE6BC94BC1EBB5D"
+	$"BD8EB8BBBD8EB948BD8EB89BBD1AB854BD5AB86DBBF7B7E7B988B975BA7DB85F"
+	$"B902BA0EB763BDFCB82DBAE5B751BE42B7F5BEBCB6C13FB92ABE1DBAE6BC94B9"
+	$"EDBD8CBAE6BC940207B9EABBF2B9EABBF2BA4CBB90BABFBABCBABFBAE9BABFBA"
+	$"B2BA9BBA9CBAAEBAA3BA40BA79B97BBAF7B9C8BA9EB952BB27B85BBCCCB85BBC"
+	$"B7B85BBCE3B8FCBC9EB89BBCCFB95EBC6CB9EABBF2B99CBC3FB9EABBF2020FC0"
+	$"E42CC0E42CC0BFB7C942B801C09DB7E0C07BB825C096B86CC080B84DC0ADB889"
+	$"C0F8B893C0D4B899C2D4B862C515B9BAC413B8E0C617BA94C789BD20C6D6BBD2"
+	$"C7CFBDA0C8EFC1C5C869BF62C977C428CA19CA85C9F2C73ACA1BCAABCA4FCADD"
+	$"CA30CACCCA6FCAEDCAB5CAD7CA97CAEBCAD4CAC4CAE5CA7DCAE7CAA1CABDC722"
+	$"59C19ACA3FC408C92DBF2BC83CBCC0C89FBD76C786BB6DC599B920C6BEBA17C4"
+	$"73B827C0E42CC2EEB794C0E42C020AC70ABC69C70ABC69C1BB3BC864C462C353"
+	$"50C8CFC440C982C3CEC930C411C983C3CDC984C3CCC983C3CCC985C3CAC987C3"
+	$"C7C986C3C9C9D4C384CA37C2CDCA13C32DCA59C272CA1945CA19C220C9B33FC8"
+	$"5ABC98C9B33DC85ABC98C859BC98C859BC98C7F2BC76C70ABC69C785BC69C70A"
+	$"BC690220C6E2C242C6E2C242C740C242C7A5C216C782C234C7CCC1F8C7DFC1AB"
+	$"C7DFC1D6C7DFC141C6C8C10CC782C10CC690C10CC622C10CC659C10CC622C0A1"
+	$"C622BFC8C622C035C659BFC8C6C8BFC8C690BFC8C705BFC8C75FBFA5C738BFBD"
+	$"C785BF8DC798BF35C798BF67C798BEE3C6EBBEB9C75FBEB9C6ADBEB9C635BED9"
+	$"C66FBEC3C5FABEEEC587BF1BC5BFBF03C555BEB4C4F0BDE5C523BE4CC532BDBA"
+	$"C5E5BD79C584BD98C64ABD5AC709BD4AC6ABBD4AC774BD4AC814BD6CC7CDBD54"
+	$"C85EBD84C8C6BDCEC89ABDA5C8F1BDF5C922BE5CC911BE24C935BE91C93DBF04"
+	$"C93DBECAC93DBF3EC916BFA5C931BF73C8FEBFD4C89AC038C8D4C005C8EEC05D"
+	$"58C0D7C92CC092C975C117C988C1B0C988C160C988C1FAC966C27CC97DC23EC9"
+	$"4EC2BBC8F1C321C927C2F1C8BCC34DC821C38BC878C370C7CCC3A5C6E7C3B4C7"
+	$"63C3B4C68DC3B4C5C5C399C62EC3AAC562C384C4D6C348C511C36AC4F5C2D4C5"
+	$"34C1EAC515C25EC58CC210C616C236C5D7C229C653C23EC6E2C242C698C242C6"
+	$"E2C2420F0A000100000A010101000A020102000A030103000A040104000A0501"
+	$"05000A060106000A010107000A000108000A000109000A07010A000A00010B00"
+	$"0A00010C000A01010D000A00010E00"
+};

misc/logo/logo.svg

@@ -0,0 +1,302 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="63.999996"
+   height="63.999996"
+   viewBox="0 0 16.933332 16.933333"
+   version="1.1"
+   id="svg8"
+   inkscape:version="0.92.5 (2060ec1f9f, 2020-04-08)"
+   sodipodi:docname="logo.svg"
+   inkscape:export-filename="logo-64x64.png"
+   inkscape:export-xdpi="96.000008"
+   inkscape:export-ydpi="96.000008">
+  <title
+     id="title1733">n³ logo</title>
+  <defs
+     id="defs2">
+    <linearGradient
+       inkscape:collect="always"
+       id="linearGradient4258">
+      <stop
+         style="stop-color:#000000;stop-opacity:1;"
+         offset="0"
+         id="stop4254" />
+      <stop
+         style="stop-color:#000000;stop-opacity:0;"
+         offset="1"
+         id="stop4256" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       id="linearGradient3891">
+      <stop
+         style="stop-color:#000000;stop-opacity:1;"
+         offset="0"
+         id="stop3887" />
+      <stop
+         style="stop-color:#000000;stop-opacity:0;"
+         offset="1"
+         id="stop3889" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       id="linearGradient3746">
+      <stop
+         style="stop-color:#000000;stop-opacity:0"
+         offset="0"
+         id="stop3742" />
+      <stop
+         id="stop3750"
+         offset="0.68665242"
+         style="stop-color:#000000;stop-opacity:0" />
+      <stop
+         style="stop-color:#000000;stop-opacity:1"
+         offset="1"
+         id="stop3744" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       id="linearGradient3628">
+      <stop
+         style="stop-color:#000000;stop-opacity:1"
+         offset="0"
+         id="stop3624" />
+      <stop
+         style="stop-color:#000000;stop-opacity:0"
+         offset="1"
+         id="stop3626" />
+    </linearGradient>
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3628"
+       id="radialGradient4190"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(0.10643412,0.08213184,-0.08695471,0.11268405,2.5028417,-19.507024)"
+       cx="80.745285"
+       cy="31.199144"
+       fx="80.745285"
+       fy="31.199144"
+       r="17.514044" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3628"
+       id="radialGradient4200"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(0.1591284,-0.22144644,0.05150741,0.03701252,-10.674157,4.5498963)"
+       cx="63.691868"
+       cy="24.91503"
+       fx="63.691868"
+       fy="24.91503"
+       r="16.80954" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3746"
+       id="radialGradient4206"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(0.08312121,-0.16218012,0.2763752,0.1416496,-5.8976633,2.3429863)"
+       cx="109.63785"
+       cy="27.735554"
+       fx="109.63785"
+       fy="27.735554"
+       r="14.917971" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3891"
+       id="radialGradient4208"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(0.77009845,-0.00589491,0.0032956,0.4305302,1.4732687,-112.12628)"
+       cx="10.145939"
+       cy="261.29977"
+       fx="10.145939"
+       fy="261.29977"
+       r="7.9343286" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient4258"
+       id="radialGradient4260"
+       cx="38.219185"
+       cy="-11.155752"
+       fx="38.219185"
+       fy="-11.155752"
+       r="2.5266471"
+       gradientTransform="matrix(0.41700468,-0.5564057,0.25660676,0.1923169,-8.5901303,12.321222)"
+       gradientUnits="userSpaceOnUse" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3891"
+       id="radialGradient4271"
+       cx="36.437771"
+       cy="11.167927"
+       fx="36.437771"
+       fy="11.167927"
+       r="0.92064488"
+       gradientTransform="matrix(0.79726776,-1.0594042,0.6692442,0.50364803,-33.972333,27.585938)"
+       gradientUnits="userSpaceOnUse" />
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1"
+     inkscape:cx="43.627536"
+     inkscape:cy="44.431591"
+     inkscape:document-units="mm"
+     inkscape:current-layer="layer2"
+     showgrid="true"
+     units="px"
+     inkscape:snap-bbox="true"
+     inkscape:snap-bbox-midpoints="false"
+     inkscape:bbox-nodes="true"
+     inkscape:object-nodes="false"
+     inkscape:snap-global="true"
+     inkscape:snap-nodes="true"
+     inkscape:window-width="1918"
+     inkscape:window-height="1060"
+     inkscape:window-x="0"
+     inkscape:window-y="18"
+     inkscape:window-maximized="0"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     showguides="false">
+    <inkscape:grid
+       type="xygrid"
+       id="grid815"
+       empspacing="2"
+       dotted="true"
+       originx="0"
+       originy="0" />
+    <inkscape:grid
+       type="xygrid"
+       id="grid1158"
+       spacingx="16.933333"
+       spacingy="16.933333"
+       empcolor="#3fff3f"
+       empopacity="0.25098039"
+       enabled="true"
+       color="#52ff3f"
+       opacity="0.1254902"
+       originx="0"
+       originy="0" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata5">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title>n³ logo</dc:title>
+        <dc:creator>
+          <cc:Agent>
+            <dc:title>Léo Villeveygoux</dc:title>
+          </cc:Agent>
+        </dc:creator>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="fg"
+     transform="translate(1.6666665e-6,16.933336)"
+     style="display:inline">
+    <path
+       sodipodi:nodetypes="ccccccccccccccccscccsccccccccccccccccscccccccccccccscccccsccsccccc"
+       inkscape:connector-curvature="0"
+       id="path4096"
+       d="m 7.5563837,-16.683514 c -6.37e-4,4e-5 -0.06582,0.008 -0.08984,0.0137 -0.04805,0.0106 -0.07759,0.0228 -0.101563,0.0332 -0.04795,0.0209 -0.07078,0.0351 -0.0918,0.0488 -0.04203,0.0274 -0.06833,0.0495 -0.0957,0.0723 -0.05474,0.0455 -0.10969,0.0967 -0.175781,0.16016 -0.132182,0.127 -0.300521,0.29823 -0.492188,0.50195 -0.146719,0.15595 -0.277344,0.28701 -0.388672,0.39649 -0.0057,-0.003 -0.0078,-0.004 -0.01367,-0.008 -0.197393,-0.11237 -0.466421,-0.2688 -0.753907,-0.4414 -0.292561,-0.17566 -0.563176,-0.33604 -0.765625,-0.45313 -0.101224,-0.0585 -0.185684,-0.10714 -0.25,-0.14258 -0.03216,-0.0177 -0.05714,-0.0313 -0.08398,-0.0449 -0.01342,-0.007 -0.02769,-0.0122 -0.04883,-0.0215 -0.01057,-0.005 -0.02139,-0.0114 -0.04492,-0.0195 -0.01177,-0.004 -0.02683,-0.008 -0.05078,-0.0137 -0.02395,-0.006 -0.124654,-0.0156 -0.125,-0.0156 -0.05674,0 -0.203301,0.0121 -0.333985,0.10937 -0.130683,0.0973 -0.184045,0.2292 -0.205078,0.30469 -0.04207,0.15099 -0.02811,0.20268 -0.02539,0.29102 0.0054,0.17668 0.02754,0.44302 0.07031,0.95703 0.02009,0.24144 0.03761,0.47757 0.05078,0.66211 0.01317,0.18453 0.02149,0.35714 0.02149,0.32617 -2.5e-5,-0.0716 0.0084,-0.0136 -0.08984,0.12305 -0.09824,0.13666 -0.280681,0.34121 -0.548828,0.60546 -0.331583,0.32677 -0.546477,0.51342 -0.689453,0.83204 -0.142977,0.31862 -0.12766,0.605 -0.128907,1.01953 -0.0019,0.65046 0.02339,0.50097 -0.0957,0.84179 -0.144761,0.41429 -0.289011,0.6739003 -0.884765,1.5566403 -0.27946103,0.41409 -0.54683003,0.82021 -0.66601603,1.04493 -0.389514,0.73442 -0.574283,1.51442 -0.394531,2.20507 0.234069,0.89938 1.04359803,1.46551 2.00976503,1.57227 0.08937,0.18231 0.157509,0.38673 0.316407,0.48242 h 0.002 c 0.344505,0.20741 0.757366,0.16421 1.074218,0.0137 0.316853,-0.15053 0.584433,-0.40119 0.802735,-0.72265 0.11807,-0.17388 0.279753,-0.46209 0.423828,-0.73828 0.267813,-0.5134 0.424453,-0.75918 0.673828,-0.98438 0.249375,-0.2252 0.638049,-0.4572 1.359375,-0.83203 0.492658,-0.25601 0.795852,-0.45655 1.134766,-0.66797 -3.2e-5,0.0656 0.0067,0.12864 0.0039,0.18945 -0.02949,0.65113 -0.155996,1.13801 -0.449219,1.72266 -0.266512,0.53141 -0.429772,0.70223 -1.361329,1.54102 -0.567672,0.51114 -0.922548,0.84685 -1.177734,1.16015 -0.255186,0.31331 -0.40187,0.6268 -0.484375,0.94336 -0.153164,0.58764 -0.184601,1.08693002 -0.164063,1.55274002 L 4.2498067,-3.675972e-6 H 16.933332 L 16.919662,-1.2538237 c -0.0264,-2.50458 -0.581284,-5.74387 -1.388672,-8.16016 -0.567382,-1.6980103 -1.186678,-2.8095203 -2.121093,-3.7480403 -0.824138,-0.82775 -1.808365,-1.36141 -2.937501,-1.58985 -0.460672,-0.0932 -1.2090663,-0.0911 -1.8593753,-0.0488 l 0.216796,-0.0137 -0.277343,-0.60742 c -0.129838,-0.28446 -0.245022,-0.52486 -0.335938,-0.70312 -0.04546,-0.0891 -0.0838,-0.16151 -0.121094,-0.22461 -0.01865,-0.0315 -0.03654,-0.0597 -0.06445,-0.0977 -0.01396,-0.019 -0.02894,-0.0405 -0.0625,-0.0742 -0.01678,-0.0169 -0.03866,-0.0381 -0.07617,-0.0644 -0.01876,-0.0132 -0.04084,-0.0276 -0.07227,-0.043 -0.03143,-0.0154 -0.12448,-0.0429 -0.125,-0.043 h -0.0039 l -0.0019,-0.002 c -5.15e-4,-10e-5 -0.132175,-0.01 -0.132812,-0.01 z"
+       style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';font-variant-ligatures:normal;font-variant-position:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-feature-settings:normal;text-indent:0;text-align:start;text-decoration:none;text-decoration-line:none;text-decoration-style:solid;text-decoration-color:#000000;letter-spacing:0px;word-spacing:0px;text-transform:none;writing-mode:lr-tb;direction:ltr;text-orientation:mixed;dominant-baseline:auto;baseline-shift:baseline;text-anchor:start;white-space:normal;shape-padding:0;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;vector-effect:none;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1.05833328;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:markers stroke fill;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate" />
+    <path
+       inkscape:connector-curvature="0"
+       id="path4098"
+       d="m 6.4080867,-3.7690437 c 0.938534,-0.84507 1.188659,-1.11552 1.48007,-1.69657 0.320921,-0.63988 0.47318,-1.22312 0.505483,-1.9363 0.02009,-0.44367 -0.02591,-0.99383 -0.08833,-1.05625 -0.01983,-0.0198 -0.09943,0.0146 -0.196664,0.0851 -0.362858,0.26298 -0.902924,0.58065 -1.625708,0.95624 -1.458811,0.75805 -1.708252,0.98331 -2.259881,2.04078 -0.136798,0.26224 -0.312882,0.57127 -0.391298,0.68675 -0.348405,0.51305 -0.842285,0.74905 -1.167444,0.55329 -0.136991,-0.0825 -0.203307,-0.18758 -0.23386,-0.37066 -0.0206,-0.1234 -0.02893,-0.12948 -0.189186,-0.13815 -0.869164,-0.047 -1.47390803,-0.49276 -1.66510103,-1.22739 -0.125725,-0.48307 0.0075,-1.1762 0.35022,-1.82239 0.076,-0.14329 0.36220403,-0.59246 0.63600503,-0.99816 0.601277,-0.89093 0.78603,-1.21845 0.946654,-1.6781303 0.120217,-0.34405 0.12288,-0.36238 0.124815,-1.01425 0.0025,-0.83103 -0.0022,-0.82067 0.662064,-1.47528 0.558243,-0.55015 0.795236,-0.87983 0.795158,-1.10615 -2.8e-5,-0.0813 -0.0332,-0.54616 -0.07371,-1.033 -0.08546,-1.02692 -0.08733,-1.08802 -0.03345,-1.08802 0.02217,0 0.515642,0.2854 1.096601,0.63421 0.58096,0.34881 1.083868,0.63511 1.117573,0.63621 0.03371,10e-4 0.347056,-0.30174 0.696336,-0.67299 0.374566,-0.39812 0.657987,-0.67043 0.690965,-0.66387 0.03324,0.007 0.230015,0.39256 0.485181,0.95161 l 0.429268,0.94049 0.146868,-0.01 c 0.609325,-0.0396 1.4254303,-0.0214 1.7210693,0.0384 1.033646,0.20912 1.909331,0.68342 2.667218,1.44463 0.872014,0.87585 1.440968,1.88647 1.994305,3.5424503 0.784909,2.34901 1.335797,5.56889 1.361403,7.99842 l 0.0076,0.71920002 H 4.7566417 c -0.01888,-0.4282 0.0079,-0.85904002 0.147789,-1.39575002 0.139882,-0.53671 0.378578,-0.83142 1.503656,-1.84447 z"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';letter-spacing:0px;word-spacing:0px;display:inline;fill:#2e3436;fill-opacity:1;stroke:none;stroke-width:1.05833328;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill" />
+    <path
+       inkscape:connector-curvature="0"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';letter-spacing:0px;word-spacing:0px;display:inline;fill:url(#radialGradient4190);fill-opacity:1;stroke:none;stroke-width:1.05833328;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill"
+       d="m 14.019296,-0.52863368 c -0.03236,-0.37147 -0.05679,-0.71947002 -0.168981,-1.35909002 -0.15856,-0.90396 -0.383199,-2.00523 -0.634071,-3.1042 -0.25087,-1.09897 -0.528185,-2.19572 -0.792716,-3.09077 -0.264533,-0.89505 -0.516175,-1.58828 -0.715719,-1.8805 -0.190129,-0.2784503 -0.377891,-0.5254103 -0.572058,-0.7420803 -0.194167,-0.21666 -0.394798,-0.40292 -0.611333,-0.5612 -0.216532,-0.15828 -0.448667,-0.28843 -0.7058983,-0.39171 -0.131273,-0.0527 -0.29119,-0.0793 -0.436667,-0.11834 0.07747,0.0695 0.156587,0.13071 0.227892,0.22944 0.09939,0.19294 0.158695,0.41322 0.167431,0.65319 0.0087,0.23998 -0.03275,0.49928 -0.135908,0.77102 -0.103153,0.2717303 -0.267553,0.5556703 -0.503845,0.8438703 -0.233789,0.28516 -0.540714,0.57454 -0.925525,0.86093 0.03184,-0.0131 0.08412,-0.0497 0.09353,-0.0403 0.06242,0.0624 0.108457,0.6126 0.08837,1.05627 -0.0323,0.71318 -0.184474,1.29644 -0.505395,1.93632 -0.291411,0.58105 -0.541995,0.85146 -1.48053,1.69653 -1.125078,1.01305 -1.363385,1.30814 -1.503267,1.84485 -0.139889,0.53671 -0.166675,0.96758002 -0.147795,1.39578002 z"
+       id="path4106" />
+    <path
+       inkscape:connector-curvature="0"
+       id="path4116"
+       d="m 7.5855797,-16.154034 c -0.03298,-0.007 -0.316348,0.26592 -0.690914,0.66404 -0.34928,0.37125 -0.662888,0.67383 -0.696598,0.67283 -0.0337,-10e-4 -0.536801,-0.28733 -1.117761,-0.63614 -0.58096,-0.34881 -1.074404,-0.63407 -1.096574,-0.63407 -0.05388,0 -0.05187,0.0609 0.03359,1.08779 0.04051,0.48684 0.07387,0.95171 0.0739,1.03301 7.7e-5,0.22632 -0.237058,0.55625 -0.795301,1.1064 -0.664264,0.65461 -0.659475,0.64381 -0.661975,1.47484 -0.0019,0.65187 -0.0048,0.67036 -0.125057,1.01441 -0.160624,0.4596803 -0.345435,0.7870003 -0.946712,1.6779303 -0.273801,0.4057 -0.55962,0.8551 -0.63562003,0.99839 -0.34272,0.64619 -0.476091,1.33956 -0.350366,1.82263 0.191193,0.73463 0.79585103,1.18032 1.66501403,1.22732 0.08533,0.005 0.123824,0.005 0.147795,0.0264 0.474897,-0.71432 0.990332,-1.57106 1.609204,-2.52181 0.642554,-0.98713 1.335583,-2.00634 2.022099,-2.85977 0.343258,-0.4267203 0.685028,-0.8121303 1.018026,-1.1312003 0.332998,-0.31907 0.65726,-0.57187 0.965832,-0.73381 0.154287,-0.081 0.304578,-0.13915 0.450102,-0.17156 0.145524,-0.0324 0.286173,-0.0389 0.421163,-0.0165 0.13499,0.0223 0.264371,0.0733 0.387056,0.15658 0.04214,0.0286 0.07884,0.0836 0.119373,0.11989 0.01427,0.004 0.02839,0.008 0.04289,0.0114 l -0.920357,-2.49752 -0.0047,5.1e-4 -0.428914,-0.94051 c -0.255166,-0.55905 -0.452002,-0.94436 -0.485242,-0.95136 z"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';letter-spacing:0px;word-spacing:0px;display:inline;fill:url(#radialGradient4200);fill-opacity:1;stroke:none;stroke-width:1.05833328;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill" />
+    <path
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';letter-spacing:0px;word-spacing:0px;display:inline;fill:url(#radialGradient4206);fill-opacity:1;stroke:none;stroke-width:1.05833328;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill"
+       d="m 8.5043867,-14.262674 1.165911,2.68461 c 0.133392,0.0334 0.6612493,0.21144 0.7796483,0.25898 2.649479,0.14717 5.883653,2.4870503 2.584913,-1.46978 -0.757881,-0.76121 -1.633374,-1.23575 -2.667019,-1.44487 -0.29564,-0.0598 -1.1120183,-0.0778 -1.7213433,-0.0382 z"
+       id="path4122"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="ccccccc" />
+    <path
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';letter-spacing:0px;word-spacing:0px;display:inline;fill:url(#radialGradient4208);fill-opacity:1;stroke:none;stroke-width:1.05833328;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill"
+       d="m 6.4080867,-3.7690437 c 3.9106623,-2.0517737 6.5564953,-2.316357 9.7896183,-0.1353155 0.116365,0.9327131 0.184394,1.8392243 0.193006,2.6563355 l 0.0076,0.71920002 H 4.7566417 c -0.01888,-0.4282 0.0079,-0.85904002 0.147789,-1.39575002 0.139882,-0.53671 0.378578,-0.83142 1.503656,-1.84447 z"
+       id="path4124"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="ccccccc" />
+    <path
+       style="display:inline;opacity:0.33200001;fill:url(#radialGradient4271);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:0.26458332px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 2.3150987,-4.6632687 c 0.84336,-0.578776 1.653646,-2.182813 1.670183,-1.852083 0.01654,0.330729 -0.496094,2.645833 -1.35599,2.067057 -0.859896,-0.578776 -0.314193,-0.214974 -0.314193,-0.214974 z"
+       id="path4262"
+       inkscape:connector-curvature="0" />
+    <path
+       sodipodi:nodetypes="ccscccsccscsccccc"
+       inkscape:connector-curvature="0"
+       d="m 6.8791644,-6.5799967 c 0.277182,-0.0747 0.617361,-0.14533 1.020535,-0.21177 0.411575,-0.0665 0.856747,-0.0997 1.335516,-0.0997 0.470371,0 0.8609466,0.0664 1.1717256,0.19932 0.310781,0.12456 0.554366,0.30725 0.730754,0.54808 0.18479,0.23253 0.314982,0.51489 0.390577,0.8470599 0.0756,0.32387 0.113393,0.68512 0.113393,1.08374 v 3.1548598 h -1.5875 v -2.9555598 c 0,-0.5481 -0.06013,-0.94256 -0.1803996,-1.18338 -0.120264,-0.2408299 -0.364802,-0.3612399 -0.733616,-0.3612399 -0.112248,0 -0.224495,0.004 -0.336742,0.0125 -0.10423,0.008 -0.216478,0.0208 -0.336743,0.0373 v 4.4503697 h -1.5875 z"
+       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:14.11111069px;line-height:80.00000119%;font-family:'Ubuntu Mono';-inkscape-font-specification:'Ubuntu Mono Bold';letter-spacing:0px;word-spacing:0px;fill:#2e3436;fill-opacity:1;stroke:none;stroke-width:0.23356323px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       id="path4273" />
+    <path
+       sodipodi:nodetypes="ccscccsccscsccccc"
+       inkscape:connector-curvature="0"
+       d="m 7.4083317,-6.0508267 c 0.277182,-0.0747 0.617361,-0.14533 1.020535,-0.21177 0.411575,-0.0665 0.856747,-0.0997 1.335516,-0.0997 0.4703713,0 0.8609463,0.0664 1.1717253,0.19932 0.310781,0.12456 0.554366,0.30725 0.730754,0.54808 0.18479,0.23253 0.314982,0.5148899 0.390577,0.8470599 0.0756,0.32387 0.113393,0.68512 0.113393,1.08374 v 2.6257298 h -1.5875 v -2.2633598 c 0,-0.51127 -0.06013,-0.87922 -0.180399,-1.10385 -0.120264,-0.22465 -0.364802,-0.33697 -0.7336163,-0.33697 -0.112248,0 -0.224495,0.004 -0.336742,0.0117 -0.10423,0.007 -0.216478,0.0194 -0.336743,0.0348 v 3.6577098 h -1.5875 z"
+       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:14.11111069px;line-height:80.00000119%;font-family:'Ubuntu Mono';-inkscape-font-specification:'Ubuntu Mono Bold';letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:0.23356323px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       id="path4158" />
+    <path
+       inkscape:connector-curvature="0"
+       id="path4160"
+       d="m 2.2657997,-6.5970811 c 2.39e-4,-0.13158 -0.102021,-0.29549 -0.222752,-0.3571395 -0.367285,-0.18754 -0.694817,0.1635095 -0.738403,0.7914195 -0.01108,0.15956 -0.0093,0.31791 0.0038,0.35187 0.0276,0.071 0.04155,0.0639 0.42986,-0.20266 0.388306,-0.26657 0.527201,-0.43437 0.527446,-0.58349 z"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.05833328;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill" />
+    <path
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';letter-spacing:0px;word-spacing:0px;opacity:0.44600004;fill:url(#radialGradient4260);fill-opacity:1;stroke:none;stroke-width:3.37220645;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill"
+       d="m 5.2460787,-10.568226 c 0.812188,-0.809811 1.765374,-2.190004 1.765374,-2.556274 0,-0.0838 -0.135642,-0.203925 -0.301459,-0.267015 -0.752294,-0.286133 -1.733457,0.02549 -2.369685,0.748534 -0.347846,0.396158 -0.900949,0.953943 -1.423035,3.0038925 -0.04718,0.1852661 -0.424024,0.9086143 0.377177,0.4985965 0.801204,-0.4100179 1.308944,-0.7869297 1.951628,-1.427734 z"
+       id="path4252"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="ssccscs" />
+    <path
+       inkscape:connector-curvature="0"
+       id="path4162"
+       d="m 4.5914317,-10.992111 c 0.254897,-0.254151 0.554045,-0.687311 0.554045,-0.802261 0,-0.0263 -0.04257,-0.064 -0.09461,-0.0838 -0.2361,-0.0898 -0.544028,0.008 -0.743702,0.23492 -0.109168,0.12433 -0.747614,1.164311 -0.747614,1.217801 0,0.06 0.167933,0.0101 0.419382,-0.11858 0.25145,-0.12868 0.410799,-0.24697 0.612499,-0.44808 z"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.05833328;stroke-linecap:square;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill" />
+    <path
+       inkscape:connector-curvature="0"
+       id="path4164"
+       d="m 9.2282597,-13.755752 a 0.26460981,0.26460981 0 1 0 0.05273,0.52539 c 1.2306523,-0.12455 2.0604593,0.20175 2.7285163,0.76758 0.668056,0.56582 1.165386,1.39097 1.630859,2.255861 0.179199,0.3329602 0.577259,1.4975302 0.927734,3.0839804 0.350476,1.5864495 0.671479,3.6240594 0.771485,5.8124992 a 0.26490778,0.26490778 0 1 0 0.529297,-0.0234 c -0.101686,-2.2251898 -0.428845,-4.2894697 -0.785157,-5.9023392 -0.356311,-1.6128702 -0.723527,-2.7469202 -0.978515,-3.2207004 -0.472697,-0.878311 -0.99272,-1.763511 -1.753906,-2.408211 -0.761187,-0.6447 -1.771873,-1.02737 -3.1230473,-0.89062 z"
+       style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10.58333302px;line-height:80.00000119%;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans';font-variant-ligatures:normal;font-variant-position:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-feature-settings:normal;text-indent:0;text-align:start;text-decoration:none;text-decoration-line:none;text-decoration-style:solid;text-decoration-color:#000000;letter-spacing:0px;word-spacing:0px;text-transform:none;writing-mode:lr-tb;direction:ltr;text-orientation:mixed;dominant-baseline:auto;baseline-shift:baseline;text-anchor:start;white-space:normal;shape-padding:0;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;vector-effect:none;fill:#ffffff;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:0.5291667;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate" />
+    <path
+       sodipodi:nodetypes="ccccccccccc"
+       inkscape:connector-curvature="0"
+       id="path4275"
+       d="m 13.309647,-10.683461 c -3.5259213,0.8942402 -2.467588,6.4504898 0.896553,5.2949099 0.277432,-0.0861 0.529922,-0.20786 0.742188,-0.38476 l 0.0059,-0.006 0.0078,-0.008 c 0.200661,-0.17837 0.36145,-0.4014 0.457031,-0.65235 0.08874,-0.23296 -0.07914,-0.44979 -0.07914,-0.7037295 -0.264584,-1.5875002 -0.264584,-2.1166602 -1.157186,-3.4173504 -0.0012,-3.9e-4 -0.0027,3.9e-4 -0.0039,0 -0.266042,-0.0881 -0.551145,-0.12305 -0.86914,-0.12305 z"
+       style="color:#000000;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:14.11111069px;line-height:80.00000119%;font-family:'Ubuntu Mono';-inkscape-font-specification:'Ubuntu Mono Bold';font-variant-ligatures:normal;font-variant-position:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-feature-settings:normal;text-indent:0;text-align:start;text-decoration:none;text-decoration-line:none;text-decoration-style:solid;text-decoration-color:#000000;letter-spacing:0px;word-spacing:0px;text-transform:none;writing-mode:lr-tb;direction:ltr;text-orientation:mixed;dominant-baseline:auto;baseline-shift:baseline;text-anchor:start;white-space:normal;shape-padding:0;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;vector-effect:none;fill:#2e3436;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1.16429496;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:markers stroke fill;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate" />
+    <path
+       inkscape:connector-curvature="0"
+       id="path4168"
+       style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:14.11111069px;line-height:80.00000119%;font-family:'Ubuntu Mono';-inkscape-font-specification:'Ubuntu Mono Bold';letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;stroke-width:1.16429496;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;paint-order:markers stroke fill"
+       d="m 13.205251,-6.7970011 q 0.368361,0 0.506496,-0.11511 0.149645,-0.1151195 0.149645,-0.2762795 0,-0.4144001 -0.725209,-0.4144001 h -0.425918 v -0.8403301 h 0.425918 q 0.241736,0 0.391383,-0.0921 0.149647,-0.0921 0.149647,-0.28779 0,-0.32231 -0.448939,-0.32231 -0.241738,0 -0.471962,0.0806 -0.230226,0.0806 -0.448941,0.17266 l -0.391382,-0.80578 q 0.253249,-0.16115 0.63312,-0.27626 0.391383,-0.1266202 0.759743,-0.1266202 0.414405,0 0.690677,0.0921 0.28778,0.0921 0.46045,0.2532602 0.172659,0.14964 0.241735,0.36836 0.06909,0.20721 0.06909,0.43744 0,0.2187 -0.103625,0.41439 -0.09207,0.18419 -0.322314,0.3798801 0.333821,0.14965 0.471953,0.4144 0.149648,0.25326 0.149648,0.5640601 0,0.2877795 -0.09208,0.5295095 -0.09207,0.24173 -0.299287,0.42592 -0.207203,0.17268 -0.541028,0.27628 -0.333827,0.10365 -0.817301,0.10365 -0.345337,0 -0.748232,-0.0691 -0.391384,-0.0806 -0.621608,-0.20719 l 0.241736,-0.9093995 q 0.345339,0.1496595 0.587075,0.1956995 0.241736,0.0345 0.529518,0.0345 z" />
+  </g>
+</svg>

misc/macos-legacy/mach_gettime.c

@@ -0,0 +1,42 @@
+#include "mach_gettime.h"
+#include <mach/mach_time.h>
+
+#define MT_NANO (+1.0E-9)
+#define MT_GIGA UINT64_C(1000000000)
+
+// TODO create a list of timers,
+static double mt_timebase = 0.0;
+static uint64_t mt_timestart = 0;
+
+int clock_gettime(clockid_t clk_id, struct timespec *tp)
+{
+	kern_return_t retval = KERN_SUCCESS;
+
+	if (clk_id == TIMER_ABSTIME) {
+		if (!mt_timestart) { // only one timer, initialized on the first call to the TIMER
+			mach_timebase_info_data_t tb;
+			mach_timebase_info(&tb);
+			mt_timebase = tb.numer;
+			mt_timebase /= tb.denom;
+			mt_timestart = mach_absolute_time();
+		}
+
+		double diff = (mach_absolute_time() - mt_timestart) * mt_timebase;
+		tp->tv_sec = diff * MT_NANO;
+		tp->tv_nsec = diff - (tp->tv_sec * MT_GIGA);
+	} else { // other clk_ids are mapped to the corresponding mach clock_service
+		clock_serv_t cclock;
+		mach_timespec_t mts;
+
+		host_get_clock_service(mach_host_self(), clk_id, &cclock);
+		retval = clock_get_time(cclock, &mts);
+		mach_port_deallocate(mach_task_self(), cclock);
+
+		tp->tv_sec = mts.tv_sec;
+		tp->tv_nsec = mts.tv_nsec;
+	}
+
+	return retval;
+}
+
+/*  Copyright (c) 2015-2018 Alf Watt - Open Source - https://opensource.org/licenses/MIT */

misc/macos-legacy/mach_gettime.h

@@ -0,0 +1,28 @@
+#ifndef mach_time_h
+#define mach_time_h
+
+#include <sys/types.h>
+#include <sys/_types/_timespec.h>
+#include <mach/mach.h>
+#include <mach/clock.h>
+
+/* The opengroup spec isn't clear on the mapping from REALTIME to CALENDAR
+ being appropriate or not.
+ http://pubs.opengroup.org/onlinepubs/009695299/basedefs/time.h.html */
+
+// XXX only supports a single timer
+#define TIMER_ABSTIME -1
+#define CLOCK_REALTIME CALENDAR_CLOCK
+#define CLOCK_MONOTONIC SYSTEM_CLOCK
+
+typedef int clockid_t;
+
+/* the mach kernel uses struct mach_timespec, so struct timespec
+	is loaded from <sys/_types/_timespec.h> for compatibility */
+// struct timespec { time_t tv_sec; long tv_nsec; };
+
+int clock_gettime(clockid_t clk_id, struct timespec *tp);
+
+#endif
+
+/*  Copyright (c) 2015-2018 Alf Watt - Open Source - https://opensource.org/licenses/MIT */

misc/musl/musl-static-ubuntu.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env sh
+
+# Statically compile nnn with netbsd-curses, musl-fts and musl libc on Ubuntu
+#
+# netbsd-curses: https://github.com/sabotage-linux/netbsd-curses
+# musl-fts: https://github.com/void-linux/musl-fts
+# musl libc: https://www.musl-libc.org/
+#
+# Dependencies: git
+#
+# Usage: musl-static-ubuntu.sh [no_run]
+#        # optional argument - do not to execute the binary after compilation
+#
+# Notes:
+#   - run the script within the top-level nnn directory
+#   - installs musl & gits netbsd-curses, musl-fts libs
+#
+# Tested on Ubuntu 20.04 x86_64
+# Author: Arun Prakash Jana
+
+# Exit on first failure
+set -e
+
+# Output binary name
+BIN=nnn-musl-static
+
+# Install musl
+sudo apt install -y --no-install-recommends musl musl-dev musl-tools
+
+# Get netbsd-curses
+[ ! -d "./netbsd-curses" ] && git clone https://github.com/sabotage-linux/netbsd-curses
+
+# Enter the library dir
+cd netbsd-curses
+
+# Get the last known working version
+git checkout v0.3.2
+
+# Compile the static netbsd-curses libraries
+if [ ! -d "./libs" ]; then
+    mkdir libs
+else
+    rm -vf -- libs/*
+fi
+make CC=musl-gcc CFLAGS=-O3 LDFLAGS=-static all-static -j$(($(nproc)+1))
+cp -v libcurses/libcurses.a libterminfo/libterminfo.a libs/
+
+# Get musl-fts library
+cd ..
+[ ! -d "./musl-fts" ] && git clone https://github.com/void-linux/musl-fts --depth=1
+
+# Compile the static musl-fts library
+cd musl-fts
+./bootstrap.sh
+./configure
+make CC=musl-gcc CFLAGS=-O3 LDFLAGS=-static -j$(($(nproc)+1))
+
+# Compile nnn
+cd ..
+[ -e "./netbsd-curses" ] || rm -- "$BIN"
+musl-gcc -O3 -DNORL -DNOMOUSE -std=c11 -Wall -Wextra -Wshadow -I./netbsd-curses/libcurses -I./musl-fts -o "$BIN" src/nnn.c -Wl,-Bsymbolic-functions -lpthread -L./netbsd-curses/libs -lcurses -lterminfo -static -L./musl-fts/.libs -lfts
+strip "$BIN"
+
+if [ -z "$1" ]; then
+    # Run the binary with it selected
+    ./"$BIN" -d "$BIN"
+fi

misc/natool/natool

@@ -3,36 +3,41 @@
 # #############################################################################
 # natool: a wrapper script to patool to list, extract and create archives
 #
-# usage: natool [-l] [-x] [archive] [file/dir]
+# usage: natool [-a] [-l] [-x] [archive] [file/dir]
 #
 # Examples:
+# - create archive : natool -a archive.7z archive_dir
 # - list archive   : natool -l archive.7z
 # - extract archive: natool -x archive.7z
-# - create archive : natool archive.7z archive_dir
 #
 # Brief:
 # natool is written to integrate patool (instead of the default atool) with nnn
-# Two copies of this file should be dropped somewhere in $PATH - atool, apack
+# A copies of this file should be dropped somewhere in $PATH as atool
 #
 # Author: Arun Prakash Jana
 # Email: engineerarun@gmail.com
 # Homepage: https://github.com/jarun/nnn
-# Copyright © 2018 Arun Prakash Jana
+# Copyright © 2019 Arun Prakash Jana
 # #############################################################################
 
 import sys
-from subprocess import Popen, PIPE, DEVNULL
+from subprocess import Popen, PIPE
 
-if len(sys.argv) != 3:
-    print('usage: natool [-l] [-x] [archive] [file/dir]')
+if len(sys.argv) < 3:
+    print('usage: natool [-a] [-l] [-x] [archive] [file/dir]')
     sys.exit(0)
 
-if sys.argv[1] == '-x':
-    cmd = ['patool', '--non-interactive', 'extract', sys.argv[2]]
+if sys.argv[1] == '-a':
+    cmd = ['patool', '--non-interactive', 'create', sys.argv[2]]
+    cmd.extend(sys.argv[3:])
 elif sys.argv[1] == '-l':
-    cmd = ['patool', '--non-interactive', 'list', sys.argv[2]]
+    cmd = ['patool', '--non-interactive', 'list']
+    cmd.extend(sys.argv[2:])
+elif sys.argv[1] == '-x':
+    cmd = ['patool', '--non-interactive', 'extract']
+    cmd.extend(sys.argv[2:])
 else:
-    cmd = ['patool', '--non-interactive', 'create', sys.argv[1], sys.argv[2]]
+    sys.exit(0)
 
 pipe = Popen(cmd, stdin=PIPE, stdout=PIPE, stderr=PIPE)
 out, err = pipe.communicate()

misc/packagecore/packagecore.yaml

@@ -1,50 +1,61 @@
 name: nnn
 maintainer: Arun Prakash Jana <engineerarun@gmail.com>
 license: BSD 2-Clause
-summary: The missing terminal file manager for X.
+summary: The unorthodox terminal file manager.
 homepage: https://github.com/jarun/nnn
 commands:
   install:
     - make PREFIX="/usr" strip install DESTDIR="${BP_DESTDIR}"
 packages:
-  archlinux:
-    builddeps:
-      - make
-      - gcc
-      - pkg-config
-    deps:
-      - ncurses
-    container: "base/archlinux"
-  centos7.2:
+  centos7.5:
     builddeps:
       - make
       - gcc
       - pkgconfig
       - ncurses-devel
+      - readline-devel
     deps:
       - ncurses
+      - readline
     commands:
       pre:
         - yum install epel-release
-  centos7.3:
+  centos7.6:
     builddeps:
       - make
       - gcc
       - pkgconfig
       - ncurses-devel
+      - readline-devel
     deps:
       - ncurses
+      - readline
     commands:
       pre:
         - yum install epel-release
-  centos7.4:
+  centos7.7:
     builddeps:
       - make
       - gcc
       - pkgconfig
       - ncurses-devel
+      - readline-devel
     deps:
       - ncurses
+      - readline
+    commands:
+      pre:
+        - yum install epel-release
+  centos8.0:
+    builddeps:
+      - make
+      - gcc
+      - pkgconfig
+      - ncurses-devel
+      - readline-devel
+    deps:
+      - ncurses
+      - readline
     commands:
       pre:
         - yum install epel-release
@@ -54,61 +65,77 @@ packages:
       - gcc
       - pkg-config
       - libncursesw5-dev
+      - libreadline-dev
     deps:
       - libncursesw5
-  fedora25:
+      - readline-common
+  debian10:
     builddeps:
       - make
       - gcc
-      - pkgconfig
-      - ncurses-devel
+      - pkg-config
+      - libncurses-dev
+      - libreadline-dev
     deps:
-      - ncurses
-  fedora26:
+      - libncursesw6
+      - readline-common
+  fedora32:
     builddeps:
       - make
       - gcc
       - pkg-config
       - ncurses-devel
+      - readline-devel
     deps:
       - ncurses
-  fedora27:
-    builddeps:
-      - make
-      - gcc
-      - pkg-config
-      - ncurses-devel
-    deps:
-      - ncurses
-  fedora28:
-    builddeps:
-      - make
-      - gcc
-      - pkg-config
-      - ncurses-devel
-    deps:
-      - ncurses
-#  opensuse42.3:
+      - readline
+#  opensuse15.2:
 #    builddeps:
 #      - make
 #      - gcc
 #      - pkg-config
+#      - readline-devel
 #      - ncurses-devel
 #    deps:
-#      - ncurses
+#      - libncurses6
+#      - libreadline7
+#  opensuse.tumbleweed:
+#    builddeps:
+#      - make
+#      - gcc
+#      - pkg-config
+#      - readline-devel
+#      - ncurses-devel
+#    deps:
+#      - libncurses6
+#      - libreadline8
   ubuntu16.04:
     builddeps:
       - make
       - gcc
       - pkg-config
       - libncursesw5-dev
+      - libreadline6-dev
     deps:
       - libncursesw5
+      - libreadline6
   ubuntu18.04:
     builddeps:
       - make
       - gcc
       - pkg-config
       - libncursesw5-dev
+      - libreadline-dev
     deps:
       - libncursesw5
+      - libreadline7
+  ubuntu20.04:
+    builddeps:
+      - make
+      - gcc
+      - pkg-config
+      - libncurses-dev
+      - libreadline-dev
+    deps:
+      - libncursesw6
+      - libreadline8

misc/quitcd/quitcd.bash_sh_zsh

@@ -0,0 +1,30 @@
+n ()
+{
+    # Block nesting of nnn in subshells
+    [ "${NNNLVL:-0}" -eq 0 ] || {
+        echo "nnn is already running"
+        return
+    }
+
+    # The behaviour is set to cd on quit (nnn checks if NNN_TMPFILE is set)
+    # If NNN_TMPFILE is set to a custom path, it must be exported for nnn to
+    # see. To cd on quit only on ^G, remove the "export" and make sure not to
+    # use a custom path, i.e. set NNN_TMPFILE *exactly* as follows:
+    #      NNN_TMPFILE="${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.lastd"
+    export NNN_TMPFILE="${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.lastd"
+
+    # Unmask ^Q (, ^V etc.) (if required, see `stty -a`) to Quit nnn
+    # stty start undef
+    # stty stop undef
+    # stty lwrap undef
+    # stty lnext undef
+
+    # The command builtin allows one to alias nnn to n, if desired, without
+    # making an infinitely recursive alias
+    command nnn "$@"
+
+    [ ! -f "$NNN_TMPFILE" ] || {
+        . "$NNN_TMPFILE"
+        rm -f -- "$NNN_TMPFILE" > /dev/null
+    }
+}

misc/quitcd/quitcd.csh

@@ -0,0 +1,17 @@
+# NOTE: set NNN_TMPFILE correctly if you use 'XDG_CONFIG_HOME'
+
+# The behaviour is set to cd on quit (nnn checks if NNN_TMPFILE is set)
+# If NNN_TMPFILE is set to a custom path, it must be exported for nnn to see.
+# To cd on quit only on ^G, set NNN_TMPFILE after the nnn invocation, and make
+# sure not to use a custom path.
+set NNN_TMPFILE=~/.config/nnn/.lastd
+
+# Unmask ^Q (, ^V etc.) (if required, see `stty -a`) to Quit nnn
+# stty start undef
+# stty stop undef
+# stty lwrap undef
+# stty lnext undef
+
+# The backslash allows one to alias n to nnn if desired without making an
+# infinitely recursive alias
+alias n '\nnn; source "$NNN_TMPFILE"; rm -f -- "$NNN_TMPFILE"'

misc/quitcd/quitcd.elv

@@ -0,0 +1,41 @@
+# Append this file to ~/.elvish/rc.elv (Elvish > 0.17.0)
+
+use path
+
+fn n {|@a|
+	# Block nesting of nnn in subshells
+	if (has-env NNNLVL) {
+		try {
+			if (>= $E:NNNLVL 1) {
+				echo "nnn is already running"
+				return
+			}
+		} catch e {
+			nop
+		}
+	}
+
+	# The behaviour is set to cd on quit (nnn checks if NNN_TMPFILE is set)
+  # If NNN_TMPFILE is set to a custom path, it must be exported for nnn to
+  # see.
+  if (has-env XDG_CONFIG_HOME) {
+		set-env NNN_TMPFILE $E:XDG_CONFIG_HOME/nnn/.lastd
+	} else {
+		set-env NNN_TMPFILE $E:HOME/.config/nnn/.lastd
+	}
+
+	# Unmask ^Q (, ^V etc.) (if required, see `stty -a`) to Quit nnn
+  # stty start undef
+  # stty stop undef
+  # stty lwrap undef
+  # stty lnext undef
+
+	# The e: prefix allows one to alias n to nnn if desired without making an
+	# infinitely recursive alias
+	e:nnn $@a
+
+	if (path:is-regular $E:NNN_TMPFILE) {
+		eval (slurp < $E:NNN_TMPFILE)
+		rm -- $E:NNN_TMPFILE
+	}
+}

misc/quitcd/quitcd.fish

@@ -0,0 +1,36 @@
+# Rename this file to match the name of the function
+# e.g. ~/.config/fish/functions/n.fish
+# or, add the lines to the 'config.fish' file.
+
+function n --wraps nnn --description 'support nnn quit and change directory'
+    # Block nesting of nnn in subshells
+    if test -n "$NNNLVL" -a "$NNNLVL" -ge 1
+        echo "nnn is already running"
+        return
+    end
+
+    # The behaviour is set to cd on quit (nnn checks if NNN_TMPFILE is set)
+    # If NNN_TMPFILE is set to a custom path, it must be exported for nnn to
+    # see. To cd on quit only on ^G, remove the "-x" from both lines below,
+    # without changing the paths.
+    if test -n "$XDG_CONFIG_HOME"
+        set -x NNN_TMPFILE "$XDG_CONFIG_HOME/nnn/.lastd"
+    else
+        set -x NNN_TMPFILE "$HOME/.config/nnn/.lastd"
+    end
+
+    # Unmask ^Q (, ^V etc.) (if required, see `stty -a`) to Quit nnn
+    # stty start undef
+    # stty stop undef
+    # stty lwrap undef
+    # stty lnext undef
+
+    # The command function allows one to alias this function to `nnn` without
+    # making an infinitely recursive alias
+    command nnn $argv
+
+    if test -e $NNN_TMPFILE
+        source $NNN_TMPFILE
+        rm -- $NNN_TMPFILE
+    end
+end

misc/quitcd/quitcd.nu

@@ -0,0 +1,37 @@
+# Run nnn with dynamic changing directory to the environment.
+#
+# $env.XDG_CONFIG_HOME sets the home folder for `nnn` folder and its $env.NNN_TMPFILE variable.
+# See manual NNN(1) for more information.
+#
+# Import module using `use quitcd.nu n` to have `n` command in your context.
+export def --env n [
+	...args : string # Extra flags to launch nnn with.
+	--selective = false # Change directory only when exiting via ^G.
+] -> nothing {
+
+	# The behaviour is set to cd on quit (nnn checks if $env.NNN_TMPFILE is set).
+	# Hard-coded to its respective behaviour in `nnn` source-code.
+	let nnn_tmpfile = $env
+		| default '~/.config/' 'XDG_CONFIG_HOME'
+		| get 'XDG_CONFIG_HOME'
+		| path join 'nnn/.lastd'
+		| path expand
+
+	# Launch nnn. Add desired flags after `^nnn`, ex: `^nnn -eda ...$args`,
+	# or make an alias `alias n = n -eda`.
+	if $selective {
+		^nnn ...$args
+	} else {
+		NNN_TMPFILE=$nnn_tmpfile ^nnn ...$args
+	}
+
+	if ($nnn_tmpfile | path exists) {
+		# Remove <cd '> from the first part of the string and the last single quote <'>.
+		# Fix post-processing of nnn's given path that escapes its single quotes with POSIX syntax.
+		let path = open $nnn_tmpfile | str substring 4..-1 | str replace --all `'\''` `'`
+
+		^rm -- $nnn_tmpfile
+
+		cd $path
+	}
+}

misc/test/benchmark.sh

@@ -0,0 +1,37 @@
+#!/bin/sh
+#
+# Usage: ./misc/test/benchmark.sh ./nnn /tmp/testdir1 ./testdir2 ...
+#
+# Don't forget to build nnn in benchmark mode: make O_BENCH=1
+
+# Use a test dir filled with genfiles.sh to get interesting output
+# (or maybe /usr/lib/)
+
+LANG=C
+
+TIME_VAL=${TIME_VAL:-"real"}
+
+SAMPLES=${SAMPLES:-100}
+
+EXE=$1
+
+bench_val () {
+    (time "$1" "$2") 2>&1 |\
+    awk '$1=="'"$TIME_VAL"'"{match($2, /[0-9]*\.[0-9]*/) ; print substr($2, RSTART, RLENGTH)}'
+}
+
+bench_dir () {
+    i=$SAMPLES
+    printf "$2"
+    while [ $((i--)) -gt 0 ] ; do
+        printf "\t%s" "$(bench_val "$1" "$2")"
+    done
+    printf "\n"
+}
+
+shift
+
+for dir in "$@" ; do
+    bench_dir "$EXE" "$dir"
+done
+

misc/test/genfiles.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+# Generates 100000 files in the current directory
+
+i=1; while [ $i -le 100000 ]; do
+    mktemp -p . -t 'XXXXXXXXXXXXXXXXXXXXX'
+    i=$(( i + 1 ))
+done

misc/test/mktest.sh

@@ -7,7 +7,7 @@ test -e outdir && {
     exit 1
 }
 
-mkdir -p outdir && cd outdir
+mkdir -p outdir && cd outdir || exit 1
 
 echo 'It works!' > normal.txt
 echo 'Με δουλέβει;' > 'κοινό.txt'
@@ -30,6 +30,21 @@ echo 'chmod 000 test/cage' > cage/lock.sh
 echo 'chmod 755 test/cage' > cage-unlock.sh
 mkdir -p cage/lion
 echo 'chmod 000 test/cage' > cage/lion/lock.sh
+mkdir -p korean
+touch 'korean/[ENG sub] PRODUCE48 울림ㅣ김채원ㅣ행복 나눠주는 천사소녀 @자기소개_1분 PR 180615 EP.0-Cgnmr6Fd82'
+touch 'korean/[ENG sub] PRODUCE48 [48스페셜] 윙크요정, 내꺼야!ㅣ김채원(울림) 180615 EP.0-K7ulTiuJZK8.mp4'
+touch 'korean/[FULL ENG SUB] 181008 SALEWA x IZ_ONE Long Padding Photoshoot Behind Film-[오늘의 시구] 아이즈원 (IZONE) 장원영&미야와키 사쿠라! 시구 시타! (10.06)-VmDl5eBJ3x0.mkv'
+touch 'korean/IZ_ONE (아이즈원) - 1st Mini Album [COLOR_IZ] Highlight Medley-w9V2xFrYIgk.web'
+touch 'korean/IZ_ONE (아이즈원) - 1st Mini Album [COLOR_IZ] MV TEASER 1-uhnJLBNBNto.mkv'
+touch 'korean/IZ_ONE CHU [1회] ′순도 100%′ 우리즈원 숙소 생활 ★최초 공개★ 181025 EP.1-pcutrQN1Sbg.mkv'
+touch 'korean/IZ_ONE CHU [1회_예고] 아이즈원 데뷔 준비 과정 ★독점 공개★ 아이즈원 츄 이번주 (목) 밤 11시 첫방송 181025'
+touch 'korean/IZ_ONE CHU [1회] 도치기현 1호 이모 팬과의 만남! 181025 EP.1-5kYoReT5x44.mp4'
+touch 'korean/IZ_ONE CHU [1회] ′12명 소녀들의 새로운 시작′ 앞으로 아이즈원 잘 부탁해♥ 181025 EP.1-RVNvgbdLQLQ'
+touch 'korean/IZ_ONE CHU [1회] ′앗..그것만은!′ 자비없는 합숙생활 폭로전 181025 EP.1-AmP5KzpoI38.mkv'
+touch 'korean/IZ_ONE CHU [1회] 휴게소 간식 내기 노래 맞히기 게임 181025 EP.1-LyNDKflpWYE.mp4'
+touch 'korean/IZ_ONE CHU [1회] 2018 아이즈원 걸크러시능력시험 (feat. 치타쌤) 181025 EP.1-9qHWpbo0eB8.mp4'
+touch 'korean/IZ_ONE CHU [1회] ′돼지요′ 아니죠, ′되지요′ 맞습니다! (feat. 꾸라먹방) 181025EP.1-WDLFqMWiKn'
+touch 'korean/IZ_ONE CHU [1회] ′두근두근′ 첫 MT를 앞둔 비글력 만렙의 아이즈원 181025 EP.1'
 mkdir -p unicode
 touch 'unicode/Malgudi Days - मालगुडी डेज - E05. Swami and Friends - स्वामी और उसके दोस्त (Part 1)'
 touch 'unicode/Malgudi Days - मालगुडी डेज - E05. Swami and Friends - स्वामी और उसके दोस्त (Part 2)'

misc/test/plot-bench.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+#
+# Usage: ./plot-bench.py datafile
+# (where datafile is the output of benchmark.sh)
+
+import matplotlib.pyplot as plt
+import sys
+
+def bench_file_to_lists(infile):
+    return [[float(entry) for entry in line.split('\t')[1:]] for line in infile.readlines()]
+
+def plot_data(data):
+    fig = plt.figure()
+    ax = fig.add_axes([0,0,1,1])
+    ax.violinplot(data)
+    plt.savefig("plot.svg")
+
+filename = sys.argv[1]
+
+plot_data(bench_file_to_lists(open(filename)))

nnn.1

@@ -1,323 +1,619 @@
-.Dd Nov 23, 2018
+.Dd Aug 27, 2023
 .Dt NNN 1
 .Os
 .Sh NAME
 .Nm nnn
-.Nd the missing terminal file manager for X
+.Nd The unorthodox terminal file manager.
 .Sh SYNOPSIS
 .Nm
+.Op Ar -aAcCdDeEfgHJKnQrRSuUVxh
 .Op Ar -b key
-.Op Ar -c N
-.Op Ar -e
-.Op Ar -i
-.Op Ar -l
-.Op Ar -S
-.Op Ar -v
-.Op Ar -h
+.Op Ar -F val
+.Op Ar -l val
+.Op Ar -p file
+.Op Ar -P key
+.Op Ar -s name
+.Op Ar -t secs
+.Op Ar -T key
 .Op Ar PATH
 .Sh DESCRIPTION
 .Nm
-(Noice is Not Noice) is a performance-optimized, feature-packed fork of noice (http://git.2f30.org/noice/) with seamless desktop integration, simplified navigation, \fInavigate-as-you-type\fR mode, disk usage analyzer mode, bookmarks, contexts, application launcher, familiar navigation shortcuts, subshell spawning and much more. It remains a simple and efficient file manager that stays out of your way.
+.Pq Nnn's Not Noice
+is a performance-optimized, feature-packed fork of noice
+.Em http://git.2f30.org/noice/
+with seamless desktop integration, simplified navigation,
+.Em type-to-nav
+mode with dir auto-enter, disk usage analyzer mode, bookmarks,
+contexts, application launcher, familiar navigation shortcuts,
+subshell spawning and much more. It remains a simple and
+efficient file manager that stays out of your way.
 .Pp
 .Nm
-opens the current working directory by default if
+opens the current working directory if
 .Ar PATH
-is not specified.
+is not specified. If
+.Ar PATH
+is specified and it exists,
+.Nm
+will open it. If the
+.Ar PATH
+doesn't exist and ends with a \fB/\fR,
+.Nm
+will attempt to create the directory tree and open it. Otherwise,
+.Ar PATH
+is considered a path to a regular file and
+.Nm
+attempts to create the complete directory tree to the file, open
+the parent directory and prompt to create the new file in it with
+the base filename.
 .Sh KEYBINDS
 .Pp
+Press
+.Ql \&?
+in
 .Nm
-supports both vi-like and emacs-like key bindings as listed below.
-.Pp
-NAVIGATION
-.Pp
-.Bl -tag -width "l, [Right], [Return] or C-mXXXX" -offset indent -compact
-.It Ic [Up], k, ^P
-Move to previous entry
-.It Ic [Down], j, ^N
-Move to next entry
-.It Ic [PgUp], ^U
-Scroll up half a page
-.It Ic [PgDn], ^D
-Scroll down half a page
-.It Ic [Home], g, ^, ^A
-Move to the first entry
-.It Ic [End], G, $, ^E
-Move to the last entry
-.It Ic [Left], [Backspace], h, ^H
-Go to parent directory
-.It Ic [Right], [Enter], l, ^M
-Open file or enter directory
-.It Ic ~
-Change to the HOME directory
-.It Ic &
-Change to initial directory
-.It Ic \-
-Change to the last visited directory
-.It Ic \&.
-Toggle show hidden . (dot) files
-.It Ic /
-Change filter (more information below)
-.It Ic [Insert], ^I
-Toggle navigate-as-you-type mode
-.It Ic b
-Pin current directory
-.It Ic ^W
-Visit pinned directory
-.It Ic `, ^/
-Leader key
-.It Ic LeaderN
-Switch to context N
-.It Ic Esc
-Exit prompt
-.It Ic ^L
-Force a redraw, clear prompt
-.It Ic q
-Quit the current context
-.It Ic ^G
-Quit and change directory
-.It Ic Q, ^Q
-Quit
-.It Ic \&?
-Help and configuration screen
-.El
-.Pp
-FILES
-.Pp
-.Bl -tag -width "l, [Right], [Return] or C-mXXXX" -offset indent -compact
-.It Ic ^O
-Open with an application
-.It Ic n
-Create a new file or directory
-.It Ic D
-Show entry details
-.It Ic d
-Toggle detail view
-.It Ic ^R
-Rename selected entry
-.It Ic r
-Open directory in vidir
-.It Ic Y, ^Y
-Toggle selection mode
-.It Ic Space, ^K
-Copy entry absolute path
-.It Ic y
-Show selection list
-.It Ic ^T
-Toggle path quote
-.It Ic P
-Copy files from selection
-.It Ic V
-Move files from selection
-.It Ic X
-Delete files from selection
-.It Ic ^X
-Delete entry
-.It Ic f
-Archive entry
-.It Ic F
-List files in archive
-.It Ic ^F
-Extract archive in current directory
-.It Ic m, M
-Show brief/full media info
-.It Ic e
-Open entry in EDITOR (fallback vi)
-.It Ic p
-Open entry in PAGER (fallback less)
-.El
-.Pp
-ORDER
-.Pp
-.Bl -tag -width "l, [Right], [Return] or C-mXXXX" -offset indent -compact
-.It Ic ^J
-Toggle disk usage analyzer mode
-.It Ic S
-Toggle sort by apparent size
-.It Ic s
-Toggle sort by file size
-.It Ic t
-Toggle sort by time modified
-.El
-.Pp
-MISC
-.Pp
-.Bl -tag -width "l, [Right], [Return] or C-mXXXX" -offset indent -compact
-.It Ic o
-Launch a GUI application
-.It Ic \&!, ^]
-Spawn SHELL in current directory (fallback sh)
-.It Ic R
-Run a custom script
-.It Ic L
-Lock terminal (Linux only)
-.El
-.Pp
-Backing up one directory level will set the cursor position at the
-directory you came out of.
-.Pp
-Help & settings, file details, media info and archive listing are shown in the
-PAGER. Please use the PAGER-specific keys in these screens.
+to see the list of keybinds.
 .Sh OPTIONS
 .Pp
 .Nm
 supports the following options:
 .Pp
+.Fl a
+        auto-setup temporary \fBNNN_FIFO\fR (described in \fIENVIRONMENT\fR section)
+.Pp
+.Fl A
+        disable directory auto-enter on unique filter match
+.Pp
 .Fl "b key"
         specify bookmark key to open
 .Pp
-.Fl "c N"
-        specify dir color (default blue), disables if N>7
-        0-black, 1-red, 2-green, 3-yellow, 4-blue, 5-magenta, 6-cyan, 7-white
+.Fl B
+        use bsdtar for archives (default: atool)
+.Pp
+.Fl c
+        indicates that the opener is a cli-only opener (overrides -e)
+.Pp
+.Fl C
+        8-color scheme - color directories by context, disable file colors
+.Pp
+.Fl d
+        detail mode
+.Pp
+.Fl D
+        show directories in context color with \fBNNN_FCOLORS\fR set
 .Pp
 .Fl e
-        use exiftool instead of mediainfo
+        open text files in $VISUAL (else $EDITOR, fallback vi) [preferably CLI]
+.Pp
+.Fl E
+        use $EDITOR for internal undetached edits
+.Pp
+.Fl f
+        use readline history file
+.Pp
+.Fl "F val"
+        fifo notification mode
+        0: notify as previewer, 1: notify as explorer
+.Pp
+.Fl g
+        use regex filters instead of substring match
+.Pp
+.Fl H
+        show hidden files
 .Pp
 .Fl i
-        start in navigate-as-you-type mode
+        show current file information in info bar (may be slow)
 .Pp
-.Fl l
-        start in light mode (fewer details)
+.Fl J
+        disable auto-advance on selection
+        (eg. selecting an entry will no longer move cursor to the next entry)
+.Pp
+.Fl K
+        test for keybind collision and exit
+.Pp
+.Fl "l val"
+        number of lines to move per mouse wheel scroll
+.Pp
+.Fl n
+        start in type-to-nav mode
+.Pp
+.Fl o
+        open files only on Enter key
+.Pp
+.Fl "p file"
+        copy (or \fIpick\fR) selection to file, or stdout if file='-'
+.Pp
+.Fl "P key"
+        specify plugin key to run
+.Pp
+.Fl Q
+        disable confirmation on quit with multiple contexts active
+.Pp
+.Fl r
+        show cp, mv progress
+        (Linux-only, needs \fIadvcpmv\fR; '^T' shows the progress on BSD/macOS)
+.Pp
+.Fl R
+        disable rollover at edges (eg. pressing \fIdown\fR while on the last
+        entry will no longer move cursor to the first entry and vice\-versa)
+.Pp
+.Fl "s name"
+        load a session by name
 .Pp
 .Fl S
-        start in disk usage analyzer mode
+        persistent session
 .Pp
-.Fl v
+.Fl "t secs"
+        idle timeout in seconds to lock terminal
+.Pp
+.Fl "T key"
+        sort order
+        keys: 'a'pparent disk usage / 'd'isk usage / 'e'xtension / 'r'everse / 's'ize / 't'ime / 'v'ersion
+        capitalize to reverse (except 'r')
+.Pp
+.Fl u
+        use selection if available, don't prompt to choose between selection and hovered entry
+.Pp
+.Fl U
+        show user and group names in status bar
+.Pp
+.Fl V
         show version and exit
 .Pp
+.Fl x
+        show notifications on selection cp, mv, rm completion (requires \fI.ntfy\fR plugin)
+        copy path to system clipboard on selection (requires \fI.cbcp\fR plugin)
+        show xterm title (if non-picker mode)
+.Pp
 .Fl h
         show program help and exit
 .Sh CONFIGURATION
-.Nm
-uses \fIxdg-open\fR (on Linux) and \fIopen(1)\fR (on OS X) as the desktop opener.
+There is no configuration file. Associated files are at
 .Pp
-There is no configuration file. Settings work on environment variables. Please
-refer to the ENVIRONMENT section below.
+.Pa ${XDG_CONFIG_HOME:-$HOME/.config}/nnn/
+.Pp
+Configuration is done using a few optional (set if you need) environment
+variables. See ENVIRONMENT section.
 .Pp
-Configuring
 .Nm
-to change to the last visited directory on quit requires shell integration in a
-few easy steps. Please visit the project page (linked below) for the
-instructions.
+uses \fIxdg-open\fR (on Linux), \fIopen(1)\fR (on macOS), \fIcygstart\fR on
+(Cygwin) and \fIopen\fR on (Haiku) as the desktop opener. It's also possible
+to specify a custom opener. See ENVIRONMENT section.
 .Sh CONTEXTS
-Contexts serve the purpose of exploring multiple directories simultaneously. 4 contexts
-are available. The status of the contexts are shown in the top left corner:
+Open multiple locations with 4 contexts. The status is shown in the top left
+corner:
 .Pp
-- the current context is in reverse
+- the current context is in reverse video
 .br
-- other used contexts are underlined
+- other active contexts are underlined
 .br
-- rest are unused
+- rest are inactive
 .Pp
-To switch to a context press the Leader key followed by the context number (1-4).
+A new context copies the state of the previous context. Each context can have
+its own color. See ENVIRONMENT section.
+.Sh SESSIONS
+Sessions are a way to save and restore states of work. A session stores the
+settings and contexts. Sessions can be loaded at runtime or with a program
+option.
 .Pp
-The first time a context is entered, it copies the state of the last visited context. Each context remembers its start directory and last visited directory.
+- When a session is loaded at runtime, the last working state is saved
+automatically to a dedicated "auto session" session file. Session option
+\fIrestore\fR would restore the "auto session".
+.br
+- The persistent session option is global. If it is used, the last active session
+will be updated with the final state at program quit.
+.br
+- The "auto session" is used in persistent session mode if no session is active.
+.br
+- Listing input stream and opening a bookmark by key have a higher priority to
+session options (-s/-S).
 .Pp
-When a context is quit, the next active context is selected. If the last active context is quit, the program quits.
+All the session files are located by session name in the directory
+.Pp
+\fB${XDG_CONFIG_HOME:-$HOME/.config}/nnn/sessions\fR
+.Pp
+"@" is the "auto session" file.
 .Sh FILTERS
-Filters support regexes to instantly (search-as-you-type) list the matching
-entries in the current directory.
-.Pp
-Ways to exit filter prompt:
-.Pp
-(1) press \fI^L\fR to clear filter followed by \fIBksp\fR (to clear the filter symbol, like vi)
+Filters are strings (or regex patterns) to find matching entries in the current
+directory instantly (\fIsearch-as-you-type\fR). Matches are case-insensitive by
+default. The last filter in each context is persisted at runtime or in saved
+sessions.
 .br
-  - at other prompts \fI^L\fR followed by \fIEnter\fR discards all changes and exits prompt
-.br
-(2) run a search with no matches and press \fIEnter\fR
+When there's a unique match and it's a directory,
+.Nm
+auto enters the directory. Use the relevant program option to disable this.
 .Pp
-Common use cases:
+Special keys at filter prompt:
+.Bd -literal
+-------- + ---------------------------------------
+  Key    |                Function
+-------- + ---------------------------------------
+ ^char   | Usual keybind functionality
+ Esc     | Exit filter prompt but skip dir refresh
+ Alt+Esc | Unfilter, quit context
+-------- + ---------------------------------------
+.Ed
 .Pp
-(1) To list all matches starting with the filter expression, start the expression
-with a '^' (caret) symbol.
+Special keys at \fBempty filter prompt\fR:
+.Bd -literal
+------ + ---------------------------------------
+  Key  |                Function
+------ + ---------------------------------------
+   ?   | Show help and config screen
+   /   | Toggle between string and regex
+   :   | Toggle case-sensitivity
+  ^L   | Clear filter (\fIif prompt is non-empty\fR)
+       | OR apply last filter
+  Bksp | Stay at filter prompt and refresh dir
+  Del  | Stay at filter prompt and refresh dir
+------ + ---------------------------------------
+.Ed
+.Pp
+Common regex use cases:
+.Pp
+(1) To list all matches starting with the filter expression,
+    start the expression with a '^' (caret) symbol.
 .br
 (2) Type '\\.mkv' to list all MKV files.
 .br
 (3) Use '.*' to match any character (\fIsort of\fR fuzzy search).
+.br
+(4) Exclude filenames having 'nnn' (compiled with PCRE lib): '^(?!nnn)'
 .Pp
-If
+In the \fBtype-to-nav\fR mode directories are opened in filter
+mode, allowing continuous navigation.
+.Pp
+Additional special keys at \fBempty filter prompt\fR
+in \fBtype-to-nav\fR mode:
+.Bd -literal
+------ + ------------------------
+  Key  |         Function
+------ + ------------------------
+   '   | Go to first non-dir file
+   +   | Toggle file selection
+   ,   | Mark CWD
+   -   | Go to last visited dir
+   .   | Show hidden files
+   ;   | Run a plugin by its key
+   =   | Launch a GUI application
+   >   | Export file list
+   @   | Visit start dir
+   ]   | Show command prompt
+   `   | Visit /
+   ~   | Go HOME
+------ + ------------------------
+.Ed
+.Sh SELECTION
 .Nm
-is invoked as root or the environment variable \fBNNN_SHOW_HIDDEN\fR is set the default filter will also match hidden files.
+allows file selection across directories and contexts!
 .Pp
-In the \fInavigate-as-you-type\fR mode directories are opened in filter mode,
-allowing continuous navigation. Works best with the \fBarrow keys\fR.
+There are 3 groups of keybinds to add files to selection:
+.Pp
+(1) hovered file selection toggle
+    - deselects if '+' is visible before the entry, else adds to selection
 .br
-In case of only one match and it's a directory, `nnn` auto selects the directory and enters it in this mode.
-.Sh SELECTION MODE
-The absolute path of a single file can be copied to clipboard by pressing \fI^K\fR if
-NNN_COPIER is set (see ENVIRONMENT section below).
-.Pp
-To copy multiple file paths the selection mode should be enabled using \fI^Y\fR.
-In this mode it's possible to
-.Pp
-(1) cherry-pick individual files one by one by pressing <kbd>^K</kbd> on each entry; or,
+(2) add a range of files to selection
+    - repeat the range key on the same entry twice to clear selection completely
 .br
-(2) navigate to another file in the same directory to select a range of files.
+(3) add all files in the current directory to selection
 .Pp
-Pressing \fI^Y\fR again copies the paths and exits the selection mode. The files in the list can now
-be copied, moved or removed using respective keyboard shortcuts.
+A selection can be edited, copied, moved, removed, archived or linked.
 .Pp
-To list the file paths copied to memory press \fIy\fR.
+Absolute paths of the selected files are copied to \fB.selection\fR file in
+the config directory. The selection file is shared between multiple program
+instances. Selection from multiple instances are not merged. The last instance
+writing to the file overwrites earlier contents. If you have 2 instances of
+.Nm
+\fIopen\fR in 2 panes of a terminal multiplexer, you can select in one pane and
+use the selection in the other pane. The selection gets cleared in the
+.Nm
+instance where the selection was made on mv/rm (but not on cp).
+.Pp
+.Nm
+clears the selection after a successful operation with the selection. Plugins
+are allowed to define the behaviour individually.
+.Pp
+To edit the selection use the _edit selection_ key. Editing doesn't end the
+selection mode. You can add more files to the selection and edit the list
+again. If no file is selected in the current session, this option attempts
+to list the selection file.
+.Pp
+.Nm
+can show the total size of non-filtered selected files listed in a
+directory. For directories, only the size of the directory is added by
+default. To add the size of the contents of a directory, switch to du mode.
+.Sh FIND AND LIST
+There are two ways to search and list:
+.Pp
+- feed a list of file paths as input
+.br
+- search using a plugin (e.g. \fIfinder\fR) and list the results
+.Pp
+File paths must be NUL-separated ('\\0'). Paths and can be relative to the
+current directory or absolute. Invalid paths in the input are ignored. Input
+processing limit is 16,384 paths or 64 MiB (max_paths x max_path_len) of data.
+.Pp
+To list the input stream, start
+.Nm
+by writing to its standard input. E.g., to list files in current
+directory larger than
+1M:
+.Bd -literal
+    find -maxdepth 1 -size +1M -print0 | nnn
+.Ed
+.Pp
+or redirect a list from a file:
+.Bd -literal
+    nnn < files.txt
+.Ed
+.Pp
+Handy bash/zsh shell function to list files by mime-type in current directory:
+.Bd -literal
+    # to show video files, run: list video
+
+    list ()
+    {
+        find . -maxdepth 1 | file -if- | grep "$1" | awk -F: '{printf "%s%c", $1, 0}' | nnn
+    }
+.Ed
+.Pp
+A temporary directory will be created containing symlinks to the given
+paths. Any action performed on these symlinks will be performed only on their
+targets, after which they might become invalid.
+.Pp
+Right arrow or 'l' on a symlink in the listing dir takes to the target
+file. Press '-' to return to the listing dir. Press 'Enter' to open the symlink.
+.Pp
+Listing input stream can be scripted. It can be extended to pick (option -p)
+selected entries from the listed results.
+.Sh BOOKMARKS
+There are 2 ways (can be used together) to manage bookmarks.
+.Pp
+(1) Bookmark keys: See \fBNNN_BMS\fR under \fIENVIORNMENT\fR section on how to set
+    bookmark keys.
+
+    The select bookmark key \fIb\fR lists all the bookmark keys set in \fBNNN_BMS\fR
+    in the bookmarks prompt.
+.Pp
+(2) Symlinked bookmarks: A symlinked bookmark to the current directory can
+    be created with the \fIB\fR key (or manually under ~/.config/nnn/bookmarks).
+
+    Pressing 'Enter' at the bookmarks prompt takes to this directory.
+    If \fBNNN_BMS\fR is not set, the select bookmark key directly opens it.
+.Pp
+On entering a bookmark, the directory where the select bookmark key was
+pressed is set as the previous directory. Press '-' to return to it.
+.Pp
+.Sh UNITS
+The minimum file size unit is byte (B). The rest are K, M, G, T, P, E, Z, Y
+(powers of 1024), same as the default units in \fIls\fR.
 .Sh ENVIRONMENT
-The SHELL, EDITOR (VISUAL, if defined) and PAGER environment variables take precedence
-when dealing with the !, e and p commands respectively.
+The SHELL, VISUAL (else EDITOR) and PAGER environment variables are
+used. A single combination of arguments is supported for SHELL and PAGER.
 .Pp
-\fBNNN_BMS:\fR bookmark string as \fIkey_char:location\fR pairs (max 10) separated by
-\fI;\fR:
+\fBNNN_OPTS:\fR binary options to
+.Nm
 .Bd -literal
-    export NNN_BMS='d:~/Documents;u:/home/user/Cam Uploads;D:~/Downloads/'
+    export NNN_OPTS="cEnrx"
+.Ed
+.Pp
+\fBNNN_OPENER:\fR specify a custom file opener.
+.Bd -literal
+    export NNN_OPENER=nuke
 
-    NOTE: Bookmark keys should be single-character to use them in combination with the Leader key.
+    NOTE: 'nuke' is a file opener available in the plugin repository.
 .Ed
 .Pp
-\fBNNN_USE_EDITOR:\fR use EDITOR (preferably CLI, fallback vi) to handle text
-files.
+\fBNNN_BMS:\fR bookmark string as \fIkey_char:location\fR pairs
+separated by \fI;\fR:
 .Bd -literal
-    export NNN_USE_EDITOR=1
+    export NNN_BMS="d:$HOME/Docs;u:/home/user/Cam Uploads;D:$HOME/Downloads/"
 .Ed
 .Pp
-\fBNNN_IDLE_TIMEOUT:\fR set idle timeout (in seconds) to invoke terminal locker.
+These bookmarks are listed in the help and config screen (key ?).
 .Pp
-\fBNNN_COPIER:\fR set to a clipboard copier script. For example, on Linux:
+\fBNNN_PLUG:\fR directly executable plugins as \fIkey_char:plugin\fR pairs
+separated by \fI;\fR:
 .Bd -literal
-    -------------------------------------
-    #!/bin/sh
+    export NNN_PLUG='f:finder;o:fzopen;p:mocplay;d:diffs;t:nmount;v:imgview'
 
-    # comment the next line to convert newlines to spaces
-    IFS=
-    echo -n $1 | xsel --clipboard --input
-    -------------------------------------
+    NOTES:
+    1. To run a plugin directly, press \fI;\fR followed by the key.
+    2. Alternatively, combine with \fIAlt\fR (i.e. \fIAlt+key\fR).
+    3. To skip directory refresh after running a plugin, prefix with \fB-\fR.
 
-    If it's not set, by default file paths are copied to the tmp file \fBDIR/.nnncp\fR, where 'DIR' (by priority) is: \fI$HOME\fR or, \fI$TMPDIR\fR or, \fI/tmp\fR.
+    export NNN_PLUG='p:-plugin'
 .Ed
 .Pp
-\fBNNN_QUOTE_ON:\fR wrap copied paths within single quotes. Useful for pasting
-names in the shell. Note that the filename is not escaped. So copying may still fail
-for filenames having quote(s) in them.
-.Pp
-\fBNNN_SCRIPT:\fR path to a custom script to invoke with currently selected file name as argument 1.
+    To assign keys to arbitrary non-background cli commands and invoke like
+    plugins, add \fB!\fR before the command.
 .Bd -literal
-    export NNN_SCRIPT=/usr/local/bin/nscript
+    export NNN_PLUG='x:!chmod +x "$nnn";g:!git log;s:!smplayer "$nnn"'
+
+    To pick and run an unassigned plugin, press \fBEnter\fR at the plugin prompt.
+    To run a plugin at startup, use the option `-P` followed by the plugin key.
+
+    NOTES:
+    1. Place $nnn (or exported variables) in double quotes (\fB"$nnn"\fR)
+    2. Use single quotes for $NNN_PLUG so "$nnn" is not interpreted
+    3. (Again) add \fB!\fR before the command
+    4. To disable directory refresh after running a \fIcommand as plugin\fR,
+       prefix with \fB-!\fR
+    5. To skip user confirmation after command execution, suffix with \fB*\fR
+       Note: Do not use \fB*\fR with programs those run and exit e.g. cat
+
+        export NNN_PLUG='y:-!sync*'
+
+    6. To run a \fIGUI app as plugin\fR, add a \fB&\fR after \fB!\fR.
+
+        export NNN_PLUG='m:-!&mousepad "$nnn"'
+
+    7. To show the output of run-and-exit commands which do not need user input,
+       add \fB|\fR (pipe) after \fB!\fR
+       Note: This option is incompatible with \fB&\fR (terminal output is masked
+       for GUI programs) and ignores \fB*\fR (output is already paged for user).
+
+        export NNN_PLUG='m:-!|mediainfo "$nnn";t:-!|tree -ps;l:-!|ls -lah --group-directories-first'
+
+    EXAMPLES:
+    ------------------------------------ + -------------------------------------------------
+                Key:Command              |                   Description
+    ------------------------------------ + -------------------------------------------------
+    c:!convert "$nnn" png:- | xclip      | Copy image to clipboard
+       -sel clipboard -t image/png*      |
+    C:!cp -rv "$nnn" "$nnn".cp*          | Create a copy of the hovered file
+    e:-!sudo -E vim "$nnn"*              | Edit file as root in vim
+    g:-!git diff                         | Show git diff
+    h:-!hx "$nnn"*                       | Open hovered file in hx hex editor
+    k:-!fuser -kiv "$nnn"*               | Interactively kill process(es) using hovered file
+    l:-!git log                          | Show git log
+    n:-!vi /home/user/Dropbox/dir/note*  | Take quick notes in a synced file/dir of notes
+    p:-!less -iR "$nnn"*                 | Page through hovered file in less
+    s:-!&smplayer -minigui "$nnn"        | Play hovered media file, even unfinished download
+    x:!chmod +x "$nnn"                   | Make the hovered file executable
+    y:-!sync*                            | Flush cached writes
+    ------------------------------------ + -------------------------------------------------
+
+    Online docs: https://github.com/jarun/nnn/tree/master/plugins
 .Ed
 .Pp
-\fBNNN_MULTISCRIPT:\fR run multiple custom scripts.
+\fBNNN_ORDER:\fR directory-specific sort key.
 .Bd -literal
-    export NNN_MULTISCRIPT=1
+    export NNN_ORDER='t:/home/user/Downloads;S:/tmp'
+
+    NOTE: Sort keys can be a/d/e/r/s/t/v (see program option -T).
+          Capitalize to reverse (except 'r').
+          Path must be absolute.
+
+          Timestamps for entries modified/created within 5 minutes are shown in reverse.
 .Ed
 .Pp
-\fBNNN_SHOW_HIDDEN:\fR show hidden files.
+\fBNNN_COLORS:\fR string of color numbers for each context, e.g.:
 .Bd -literal
-    export NNN_SHOW_HIDDEN=1
+    # 8 color numbers:
+    # 0-black, 1-red, 2-green, 3-yellow, 4-blue (default), 5-magenta, 6-cyan, 7-white
+    export NNN_COLORS='1234'
+
+    # xterm 256 color numbers (converted to hex, 2 symbols per context):
+    # see https://user-images.githubusercontent.com/1482942/93023823-46a6ba80-f5e1-11ea-9ea3-6a3c757704f4.png
+    export NNN_COLORS='#0a1b2c3d'
+
+    # both (256 followed by 8 as fallback, separated by ';')
+    export NNN_COLORS='#0a1b2c3d;1234'
+
+    NOTE: If only 256 colors are specified and the terminal doesn't support, default is used.
 .Ed
 .Pp
-\fBNNN_NO_AUTOSELECT:\fR Disable directory auto-selection in \fInavigate-as-you-type\fR mode.
+\fBNNN_FCOLORS:\fR specify file-type specific colors:
 .Bd -literal
-    export NNN_NO_AUTOSELECT=1
+    export NNN_FCOLORS='c1e2272e006033f7c6d6abc4'
+
+    Specify file-specific colors in xterm 256 color hex numbers (2 symbols per color).
+    Order is strict, use 00 to omit/use default terminal color. Defaults:
+
+    ------------------------- + --- + -------------
+              Order           | Hex |    Color
+    ------------------------- + --- + -------------
+    Block device              | c1  | DarkSeaGreen1
+    Char device               | e2  | Yellow1
+    Directory                 | 27  | DeepSkyBlue1
+    Executable                | 2e  | Green1
+    Regular                   | 00  | Normal
+    Hard link                 | 60  | Plum4
+    Symbolic link             | 33  | Cyan1
+    Missing OR file details   | f7  | Grey62
+    Orphaned symbolic link    | c6  | DeepPink1
+    FIFO                      | d6  | Orange1
+    Socket                    | ab  | MediumOrchid1
+    Unknown OR 0B regular/exe | c4  | Red1
+    ------------------------- + --- + -------------
+
+    If the terminal supports xterm 256 colors or more, file-specific colors will be rendered.
+    To force the 8-color scheme use option -C.
+    If xterm 256 colors aren't supported, 8-color scheme will be used.
 .Ed
-.Sh KNOWN ISSUES
-If you are using urxvt you might have to set backspace key to DEC.
+.Pp
+\fBNNN_ARCHIVE:\fR archive extensions to be handled silently (default: bzip2, (g)zip, tar).
+.Bd -literal
+    export NNN_ARCHIVE="\\\\.(7z|bz2|gz|tar|tgz|zip)$"
+
+    NOTE: Non-default formats may require a third-party utility.
+.Ed
+.Pp
+\fBNNN_ARCHMNT:\fR optional archive mounter utility (default: archivemount).
+.Bd -literal
+    export NNN_ARCHIVE='fuse-archive'
+.Ed
+.Pp
+\fBNNN_SSHFS:\fR specify custom sshfs command with options:
+.Bd -literal
+    export NNN_SSHFS='sshfs -o reconnect,idmap=user,cache_timeout=3600'
+
+    NOTE: The options must be comma-separated without any space between them.
+.Ed
+.Pp
+\fBNNN_RCLONE:\fR pass additional options to rclone command:
+.Bd -literal
+    export NNN_RCLONE='rclone mount --read-only --no-checksum'
+
+    NOTE: The options must be preceded by "rclone" and max 5 flags are supported.
+.Ed
+.Pp
+\fBNNN_TRASH:\fR trash (instead of \fIrm -rf\fR) files to desktop Trash.
+.Bd -literal
+    export NNN_TRASH=n
+    # n=1: trash-cli, n=2: gio trash
+.Ed
+.Pp
+\fBNNN_SEL:\fR absolute path to custom selection file.
+.Bd -literal
+    export NNN_SEL='/tmp/.sel'
+.Ed
+.Pp
+\fBNNN_FIFO:\fR path of a named pipe to write the hovered file path:
+.Bd -literal
+    export NNN_FIFO='/tmp/nnn.fifo'
+
+    NOTES:
+    1. Overridden by a temporary path with -a option.
+    2. If the FIFO file doesn't exist it will be created,
+       but not removed (unless it is generated by -a option).
+
+    Online docs: https://github.com/jarun/nnn/wiki/Live-previews
+.Ed
+.Pp
+\fBNNN_LOCKER:\fR terminal locker program.
+.Bd -literal
+    export NNN_LOCKER='bmon -p wlp1s0'
+    export NNN_LOCKER='cmatrix'
+.Ed
+.Pp
+\fBNNN_TMPFILE:\fR \fIalways\fR cd on quit and write the command in the file specified.
+.Bd -literal
+    export NNN_TMPFILE='/tmp/.lastd'
+.Ed
+.Pp
+\fBNNN_HELP:\fR run a program and show the output on top of the program help page.
+.Bd -literal
+    export NNN_HELP='fortune'
+.Ed
+.Pp
+\fBNNN_MCLICK:\fR key emulated by a middle mouse click.
+.Bd -literal
+    export NNN_MCLICK='^R'
+
+    NOTE: Only the first character is considered if not a \fICtrl+key\fR combo.
+.Ed
+.Pp
+\fBnnn:\fR this is a special variable.
+.Bd -literal
+    Set to the hovered file name before starting the command prompt or spawning a shell.
+.Ed
+.Pp
+\fBNO_COLOR:\fR disable ANSI color output (overridden by \fBNNN_COLORS\fR).
 .Sh AUTHORS
+.An Arun Prakash Jana Aq Mt engineerarun@gmail.com ,
 .An Lazaros Koromilas Aq Mt lostd@2f30.org ,
-.An Dimitris Papastamos Aq Mt sin@2f30.org ,
-.An Arun Prakash Jana Aq Mt engineerarun@gmail.com .
+.An Dimitris Papastamos Aq Mt sin@2f30.org .
 .Sh HOME
 .Em https://github.com/jarun/nnn

patches/README.md

@@ -0,0 +1,30 @@
+<h1 align="center">User Patch Framework</h1>
+
+This directory contains sizable user submitted patches that were rejected from mainline as they tend to be more subjective in nature.
+
+The patches will be adapted on each release when necessary (v4.1 onwards). Each patch can be applied through its respective make variable during compilation. In case inter-patch merge conflicts occur, a compatibility patch is provided and will automatically be applied.
+
+## List of patches
+
+| Patch (a-z) | Description | Make var |
+| --- | --- | --- |
+| colemak | Key bindings for Colemak keyboard layout | `O_COLEMAK` |
+| gitstatus | Add git status column to the detail view. Provides command line flag `-G` to show column in normal mode. | `O_GITSTATUS` |
+| namefirst | Print filenames first in the detail view. Print user/group columns when a directory contains different users/groups. | `O_NAMEFIRST` |
+| restorepreview | Add pipe to close and restore [`preview-tui`](https://github.com/jarun/nnn/blob/master/plugins/preview-tui) for internal undetached edits (<kbd>e</kbd> key)| `O_RESTOREPREVIEW` |
+
+To apply a patch, use the corresponding make variable, e.g.:
+
+    make O_NAMEFIRST=1
+
+When contributing/adding a new patch, make sure to add the make variable to the patches array in `./misc/test/check-patches.sh` as well so that patch failures can be easily tested.
+
+## Resolving patch conflicts
+
+Patch conflicts can be checked locally by running `make checkpatches` or by running `./patches/check-patches.sh` manually.
+
+Whenever patch conflicts occur on the latest master, pull requests resolving them are welcome. Let's say a conflict occurs in the `restorepreview` patch. The best way to resolve this conflict would be something along the lines of:
+
+- Ensure you're on latest master and run `PATCH_OPTS="--merge" make O_RESTOREPREVIEW=1`. This will generate the conflict markers in `src/nnn.c`.
+- Next edit `src/nnn.c`, resolve the conflicts around the conflict markers(`<<<<<<<`), and save.
+- Then run `git diff > patch.diff && sed -i -e "/^$/{r patch.diff" -e "q;}" patches/restorepreview/mainline.diff` to update the patch.

patches/check-patches.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+#
+# Usage: ./misc/test/check-patches.sh
+#
+# Bash script that checks for any of the patches failing to apply.
+# Read patches/README.md for more information.
+
+export PATCH_OPTS="--merge"
+patches=("O_COLEMAK" "O_GITSTATUS" "O_NAMEFIRST" "O_RESTOREPREVIEW")
+z=$(( 1 << ${#patches[@]} ))
+pid=$$
+ret=0
+trap 'ret=1' SIGUSR1
+
+for ((n=1; n < z; ++n)); do
+    for ((i=0; i < ${#patches[@]}; ++i)); do
+        printf "%s=%d " "${patches[$i]}" "$(( (n & (1 << i)) != 0 ))"
+    done | tee "/dev/stderr" | (
+        make clean -s
+        if ! xargs make 2>&1; then
+            echo "[FAILED]" >&2
+            kill -SIGUSR1 "$pid"
+        else
+            echo "[SUCCESS]" >&2
+        fi
+        git restore src
+    ) >/dev/null
+done
+exit "$ret"

patches/colemak/mainline.diff

@@ -0,0 +1,134 @@
+diff --git a/src/nnn.c b/src/nnn.c
+index d7c53166..bb7ff3e8 100644
+--- a/src/nnn.c
++++ b/src/nnn.c
+@@ -5149,12 +5149,12 @@ static void show_help(const char *path)
+ 	"2(___n))\n"
+ 	"0\n"
+ 	"1NAVIGATION\n"
+-	       "9Up k  Up%16PgUp ^U  Page up\n"
+-	       "9Dn j  Down%14PgDn ^D  Page down\n"
++	       "9Up e  Up%16PgUp ^U  Page up\n"
++	       "9Dn n  Down%14PgDn ^D  Page down\n"
+ 	       "9Lt h  Parent%12~ ` @ -  ~, /, start, prev\n"
+-	   "5Ret Rt l  Open%20'  First file/match\n"
+-	       "9g ^A  Top%21J  Jump to entry/offset\n"
+-	       "9G ^E  End%20^J  Toggle auto-advance on open\n"
++	   "5Ret Rt i  Open%20'  First file/match\n"
++	       "9g ^E  Top%21J  Jump to entry/offset\n"
++	       "9G ^N  End%20^J  Toggle auto-advance on open\n"
+ 	      "8B (,)  Book(mark)%11b ^/  Select bookmark\n"
+ 		"a1-4  Context%11(Sh)Tab  Cycle/new context\n"
+ 	    "62Esc ^Q  Quit%19^y  Next young\n"
+@@ -5162,27 +5162,27 @@ static void show_help(const char *path)
+ 		  "cq  Quit context\n"
+ 	"0\n"
+ 	"1FILTER & PROMPT\n"
+-		  "c/  Filter%17^N  Toggle type-to-nav\n"
++		  "c/  Filter%17^K  Toggle type-to-nav\n"
+ 		"aEsc  Exit prompt%12^L  Toggle last filter\n"
+ 		  "c.  Toggle hidden%05Alt+Esc  Unfilter, quit context\n"
+ 	"0\n"
+ 	"1FILES\n"
+-	       "9o ^O  Open with%15n  Create new/link\n"
++	       "9o ^O  Open with%15c  Create new/link\n"
+ 	       "9f ^F  File stats%14d  Detail mode toggle\n"
+ 		 "b^R  Rename/dup%14r  Batch rename\n"
+-		  "cz  Archive%17e  Edit file\n"
++		  "cz  Archive%17y  Edit file\n"
+ 		  "c*  Toggle exe%14>  Export list\n"
+ 	    "6Space +  (Un)select%12m-m  Select range/clear\n"
+ 	          "ca  Select all%14A  Invert sel\n"
+ 	       "9p ^P  Copy here%12w ^W  Cp/mv sel as\n"
+-	       "9v ^V  Move here%15E  Edit sel list\n"
++	       "9v ^V  Move here%15l  Edit sel list\n"
+ 	       "9x ^X  Delete or trash%09S  Listed sel size\n"
+ 		  "cX  Delete (rm -rf)%07Esc  Send to FIFO\n"
+ 	"0\n"
+ 	"1MISC\n"
+ 	      "8Alt ;  Select plugin%11=  Launch app\n"
+ 	       "9! ^]  Shell%19]  Cmd prompt\n"
+-		  "cc  Connect remote%10u  Unmount remote/archive\n"
++		  "cC  Connect remote%10u  Unmount remote/archive\n"
+ 	       "9t ^T  Sort toggles%12s  Manage session\n"
+ 		  "cT  Set time type%110  Lock\n"
+ 		 "b^L  Redraw%18?  Help, conf\n"
+diff --git a/src/nnn.h b/src/nnn.h
+index bd500244..43b7fa22 100644
+--- a/src/nnn.h
++++ b/src/nnn.h
+@@ -139,12 +139,12 @@ static struct key bindings[] = {
+ 	{ '\r',           SEL_OPEN },
+ 	/* Pure navigate inside */
+ 	{ KEY_RIGHT,      SEL_NAV_IN },
+-	{ 'l',            SEL_NAV_IN },
++	{ 'i',            SEL_NAV_IN },
+ 	/* Next */
+-	{ 'j',            SEL_NEXT },
++	{ 'n',            SEL_NEXT },
+ 	{ KEY_DOWN,       SEL_NEXT },
+ 	/* Previous */
+-	{ 'k',            SEL_PREV },
++	{ 'e',            SEL_PREV },
+ 	{ KEY_UP,         SEL_PREV },
+ 	/* Page down */
+ 	{ KEY_NPAGE,      SEL_PGDN },
+@@ -157,11 +157,11 @@ static struct key bindings[] = {
+ 	/* First entry */
+ 	{ KEY_HOME,       SEL_HOME },
+ 	{ 'g',            SEL_HOME },
+-	{ CONTROL('A'),   SEL_HOME },
++	{ CONTROL('E'),   SEL_HOME },
+ 	/* Last entry */
+ 	{ KEY_END,        SEL_END },
+ 	{ 'G',            SEL_END },
+-	{ CONTROL('E'),   SEL_END },
++	{ CONTROL('N'),   SEL_END },
+ 	/* Go to first file */
+ 	{ '\'',           SEL_FIRST },
+ 	/* Jump to an entry number/offset */
+@@ -179,7 +179,7 @@ static struct key bindings[] = {
+ 	{ 'b',            SEL_BMOPEN },
+ 	{ CONTROL('_'),   SEL_BMOPEN },
+ 	/* Connect to server over SSHFS */
+-	{ 'c',            SEL_REMOTE },
++	{ 'C',            SEL_REMOTE },
+ 	/* Cycle contexts in forward direction */
+ 	{ '\t',           SEL_CYCLE },
+ 	/* Cycle contexts in reverse direction */
+@@ -202,7 +202,7 @@ static struct key bindings[] = {
+ 	/* Filter */
+ 	{ '/',            SEL_FLTR },
+ 	/* Toggle filter mode */
+-	{ CONTROL('N'),   SEL_MFLTR },
++	{ CONTROL('K'),   SEL_MFLTR },
+ 	/* Toggle hide .dot files */
+ 	{ '.',            SEL_HIDDEN },
+ 	/* Detailed listing */
+@@ -229,7 +229,7 @@ static struct key bindings[] = {
+ 	/* Invert selection in current dir */
+ 	{ 'A',            SEL_SELINV },
+ 	/* List, edit selection */
+-	{ 'E',            SEL_SELEDIT },
++	{ 'l',            SEL_SELEDIT },
+ 	/* Copy from selection buffer */
+ 	{ 'p',            SEL_CP },
+ 	{ CONTROL('P'),   SEL_CP },
+@@ -247,7 +247,7 @@ static struct key bindings[] = {
+ 	{ 'o',            SEL_OPENWITH },
+ 	{ CONTROL('O'),   SEL_OPENWITH },
+ 	/* Create a new file */
+-	{ 'n',            SEL_NEW },
++	{ 'c',            SEL_NEW },
+ 	/* Show rename prompt */
+ 	{ CONTROL('R'),   SEL_RENAME },
+ 	/* Rename contents of current dir */
+@@ -259,7 +259,7 @@ static struct key bindings[] = {
+ 	/* Toggle auto-advance on file open */
+ 	{ CONTROL('J'),   SEL_AUTONEXT },
+ 	/* Edit in EDITOR */
+-	{ 'e',            SEL_EDIT },
++	{ 'y',            SEL_EDIT },
+ 	/* Run a plugin */
+ 	{ ';',            SEL_PLUGIN },
+ 	/* Show total size of listed selection */

patches/gitstatus/mainline.diff

@@ -0,0 +1,223 @@
+# Description: Add git status column to detail mode. Provides additional
+#              command line flag -G which will render the git status
+#              column also in normal mode. Vim plugin users may consider
+#              adding the -G flag to their command override.
+#
+# Authors: Luuk van Baal
+
+diff --git a/src/nnn.c b/src/nnn.c
+index 83ecdb90..4397944a 100644
+--- a/src/nnn.c
++++ b/src/nnn.c
+@@ -270,6 +270,25 @@
+ #define VFS_USED  1
+ #define VFS_SIZE  2
+
++/* Git icons */
++#ifdef NERD
++#define GIT_ADD ""
++#define GIT_DEL ""
++#define GIT_IGN ""
++#define GIT_MOD ""
++#define GIT_NEW ""
++#define GIT_NON "-"
++#define GIT_UPD "󰚰"
++#else
++#define GIT_ADD "A"
++#define GIT_DEL "D"
++#define GIT_IGN "!"
++#define GIT_MOD "M"
++#define GIT_NEW "?"
++#define GIT_NON "-"
++#define GIT_UPD "U"
++#endif
++
+ /* TYPE DEFINITIONS */
+ typedef unsigned int uint_t;
+ typedef unsigned char uchar_t;
+@@ -294,6 +313,7 @@ typedef struct entry {
+ 	uid_t uid; /* 4 bytes */
+ 	gid_t gid; /* 4 bytes */
+ #endif
++	char git_status[2][5];
+ } *pEntry;
+
+ /* Selection marker */
+@@ -349,6 +369,7 @@ typedef struct {
+ 	uint_t cliopener  : 1;  /* All-CLI app opener */
+ 	uint_t waitedit   : 1;  /* For ops that can't be detached, used EDITOR */
+ 	uint_t rollover   : 1;  /* Roll over at edges */
++	uint_t normalgit  : 1;  /* Show git status in normal mode */
+ } settings;
+
+ /* Non-persistent program-internal states (alphabeical order) */
+@@ -400,7 +421,17 @@ typedef struct {
+ } session_header_t;
+ #endif
+
++typedef struct {
++	char status[2];
++	char path[PATH_MAX];
++} git_status_t;
++
+ /* GLOBALS */
++struct {
++	bool show;
++	size_t len;
++	git_status_t *statuses;
++} git_statuses;
+
+ /* Configuration, contexts */
+ static settings cfg = {
+@@ -3796,6 +3827,47 @@ static int get_kv_key(kv *kvarr, char *val, uchar_t max, uchar_t id)
+ 	return -1;
+ }
+
++static size_t get_git_statuses(const char *path)
++{
++	static char gst[] = "git -c core.quotePath= status -s --no-renames --ignored=matching -unormal . 2>/dev/null";
++	FILE *fp = popen(gst, "r");
++	char status[PATH_MAX];
++	size_t pathindex, i = -1;
++	git_statuses.show = FALSE;
++
++	while (fgets(status, PATH_MAX, fp)) {
++		pathindex = (status[3] == '"') ? 4 : 3;
++		if (!cfg.showhidden && status[pathindex] == '.')
++			continue;
++		status[xstrlen(status) - pathindex + 2] = '\0';
++		git_statuses.statuses = xrealloc(git_statuses.statuses, sizeof(git_status_t) * (++i + 1));
++		git_statuses.statuses[i].status[0] = status[0];
++		git_statuses.statuses[i].status[1] = status[1];
++		mkpath(path, status + pathindex, git_statuses.statuses[i].path);
++	}
++
++	pclose(fp);
++	return (i + 1);
++}
++
++static void set_git_status(char status[][5], uint_t nr)
++{
++	for (int j = 0; j < 2; j++) {
++		if (status[j][0] == '-')
++			switch (git_statuses.statuses[nr].status[j]) {
++				case ' ': xstrsncpy(status[j], GIT_NON, 4); break;
++				case 'M': xstrsncpy(status[j], GIT_MOD, 4); break;
++				case 'A': xstrsncpy(status[j], GIT_ADD, 4); break;
++				case '?': xstrsncpy(status[j], GIT_NEW, 4); break;
++				case '!': xstrsncpy(status[j], GIT_IGN, 4); break;
++				case 'D': xstrsncpy(status[j], GIT_DEL, 4); break;
++				case 'U': xstrsncpy(status[j], GIT_UPD, 4); break;
++			}
++	}
++	if (git_statuses.statuses[nr].status[1] != '!')
++		git_statuses.show = TRUE;
++}
++
+ static void resetdircolor(int flags)
+ {
+ 	/* Directories are always shown on top, clear the color when moving to first file */
+@@ -4123,6 +4195,10 @@ static void printent(const struct entry *ent, uint_t namecols, bool sel)
+
+ 	uchar_t color_pair = get_color_pair_name_ind(ent, &ind, &attrs);
+
++	if (git_statuses.show && (cfg.showdetail || cfg.normalgit))
++		printw("%*s%s%s", (cfg.normalgit && !cfg.showdetail) ? 1 : 0, "",
++				ent->git_status[0], ent->git_status[1]);
++
+ 	addch((ent->flags & FILE_SELECTED) ? '+' | A_REVERSE | A_BOLD : ' ');
+
+ 	if (g_state.oldcolor)
+@@ -5592,6 +5668,11 @@ static int dentfill(char *path, struct entry **ppdents)
+ 		attron(COLOR_PAIR(cfg.curctx + 1));
+ 	}
+
++	char linkpath[PATH_MAX];
++	if ((git_statuses.len = get_git_statuses(path)))
++		if (!realpath(path, linkpath))
++			printwarn(NULL);
++
+ #if _POSIX_C_SOURCE >= 200112L
+ 	posix_fadvise(fd, 0, 0, POSIX_FADV_SEQUENTIAL);
+ #endif
+@@ -5792,6 +5873,29 @@ static int dentfill(char *path, struct entry **ppdents)
+ #endif
+ 		}
+
++		if (git_statuses.len) {
++			char dentpath[PATH_MAX];
++			size_t pathlen = mkpath(linkpath, dentp->name, dentpath);
++			dentp->git_status[0][0] = dentp->git_status[1][0] = '-';
++			dentp->git_status[0][1] = dentp->git_status[1][1] = '\0';
++
++			if (dentp->flags & DIR_OR_DIRLNK) {
++				char prefix[PATH_MAX];
++				memccpy(prefix, dentpath, '\0', PATH_MAX);
++				prefix[pathlen - 1] = '/';
++
++				for (size_t i = 0; i < git_statuses.len; ++i)
++					if (is_prefix(git_statuses.statuses[i].path, prefix, pathlen))
++						set_git_status(dentp->git_status, i);
++			} else {
++				for (size_t i = 0; i < git_statuses.len; ++i)
++					if (!xstrcmp(git_statuses.statuses[i].path, dentpath)) {
++						set_git_status(dentp->git_status, i);
++						break;
++					}
++			}
++		}
++
+ 		++ndents;
+ 	} while ((dp = readdir(dirp)));
+
+@@ -6361,11 +6465,12 @@ static int adjust_cols(int n)
+ #endif
+ 	if (cfg.showdetail) {
+ 		/* Fallback to light mode if less than 35 columns */
+-		if (n < 36)
++		if (n < 38)
+ 			cfg.showdetail ^= 1;
+ 		else /* 2 more accounted for below */
+-			n -= 32;
+-	}
++			n -= (git_statuses.show ? 34 : 32);
++	} else if (cfg.normalgit && git_statuses.show)
++		n -= 3;
+
+ 	/* 2 columns for preceding space and indicator */
+ 	return (n - 2);
+@@ -8143,6 +8248,7 @@ static void usage(void)
+ 		" -F val  fifo mode [0:preview 1:explore]\n"
+ #endif
+ 		" -g      regex filters\n"
++		" -G      always show git status\n"
+ 		" -H      show hidden files\n"
+ 		" -i      show current file info\n"
+ 		" -J      no auto-advance on selection\n"
+@@ -8282,6 +8388,7 @@ static void cleanup(void)
+ 		fflush(stdout);
+ 	}
+ #endif
++	free(git_statuses.statuses);
+ 	free(selpath);
+ 	free(plgpath);
+ 	free(cfgpath);
+@@ -8326,7 +8433,7 @@ int main(int argc, char *argv[])
+
+ 	while ((opt = (env_opts_id > 0
+ 		       ? env_opts[--env_opts_id]
+-		       : getopt(argc, argv, "aAb:BcCdDeEfF:gHiJKl:nNop:P:QrRs:St:T:uUVxh"))) != -1) {
++		       : getopt(argc, argv, "aAb:BcCdDeEfF:gGHiJKl:nNop:P:QrRs:St:T:uUVxh"))) != -1) {
+ 		switch (opt) {
+ #ifndef NOFIFO
+ 		case 'a':
+@@ -8380,6 +8487,9 @@ int main(int argc, char *argv[])
+ 			cfg.regex = 1;
+ 			filterfn = &visible_re;
+ 			break;
++		case 'G':
++			cfg.normalgit = 1;
++			break;
+ 		case 'H':
+ 			cfg.showhidden = 1;
+ 			break;

patches/gitstatus/namefirst.diff

@@ -0,0 +1,226 @@
+# Description: Add git status column to detail mode. Provides additional
+#              command line flag -G which will render the git status
+#              column also in normal mode. Vim plugin users may consider
+#              adding the -G flag to their command override.
+#              Compatibility patch for the namefirst patch.
+#
+# Authors: Luuk van Baal
+
+diff --git a/src/nnn.c b/src/nnn.c
+index 88538787..d4af7c43 100644
+--- a/src/nnn.c
++++ b/src/nnn.c
+@@ -270,6 +270,25 @@
+ #define VFS_USED  1
+ #define VFS_SIZE  2
+
++/* Git icons */
++#ifdef NERD
++#define GIT_ADD ""
++#define GIT_DEL ""
++#define GIT_IGN ""
++#define GIT_MOD ""
++#define GIT_NEW ""
++#define GIT_NON "-"
++#define GIT_UPD "󰚰"
++#else
++#define GIT_ADD "A"
++#define GIT_DEL "D"
++#define GIT_IGN "!"
++#define GIT_MOD "M"
++#define GIT_NEW "?"
++#define GIT_NON "-"
++#define GIT_UPD "U"
++#endif
++
+ /* TYPE DEFINITIONS */
+ typedef unsigned int uint_t;
+ typedef unsigned char uchar_t;
+@@ -294,6 +313,7 @@ typedef struct entry {
+ 	uid_t uid; /* 4 bytes */
+ 	gid_t gid; /* 4 bytes */
+ #endif
++	char git_status[2][5];
+ } *pEntry;
+
+ /* Selection marker */
+@@ -349,6 +369,7 @@ typedef struct {
+ 	uint_t cliopener  : 1;  /* All-CLI app opener */
+ 	uint_t waitedit   : 1;  /* For ops that can't be detached, used EDITOR */
+ 	uint_t rollover   : 1;  /* Roll over at edges */
++	uint_t normalgit  : 1;  /* Show git status in normal mode */
+ } settings;
+
+ /* Non-persistent program-internal states (alphabeical order) */
+@@ -404,7 +425,17 @@ static struct {
+ 	ushort_t maxnameln, maxsizeln, maxuidln, maxgidln, maxentln, uidln, gidln, printguid;
+ } dtls;
+
++typedef struct {
++	char status[2];
++	char path[PATH_MAX];
++} git_status_t;
++
+ /* GLOBALS */
++struct {
++	bool show;
++	size_t len;
++	git_status_t *statuses;
++} git_statuses;
+
+ /* Configuration, contexts */
+ static settings cfg = {
+@@ -3804,6 +3835,47 @@ static int get_kv_key(kv *kvarr, char *val, uchar_t max, uchar_t id)
+ 	return -1;
+ }
+
++static size_t get_git_statuses(const char *path)
++{
++	static char gst[] = "git -c core.quotePath= status -s --no-renames --ignored=matching -unormal . 2>/dev/null";
++	FILE *fp = popen(gst, "r");
++	char status[PATH_MAX];
++	size_t pathindex, i = -1;
++	git_statuses.show = FALSE;
++
++	while (fgets(status, PATH_MAX, fp)) {
++		pathindex = (status[3] == '"') ? 4 : 3;
++		if (!cfg.showhidden && status[pathindex] == '.')
++			continue;
++		status[xstrlen(status) - pathindex + 2] = '\0';
++		git_statuses.statuses = xrealloc(git_statuses.statuses, sizeof(git_status_t) * (++i + 1));
++		git_statuses.statuses[i].status[0] = status[0];
++		git_statuses.statuses[i].status[1] = status[1];
++		mkpath(path, status + pathindex, git_statuses.statuses[i].path);
++	}
++
++	pclose(fp);
++	return (i + 1);
++}
++
++static void set_git_status(char status[][5], uint_t nr)
++{
++	for (int j = 0; j < 2; j++) {
++		if (status[j][0] == '-')
++			switch (git_statuses.statuses[nr].status[j]) {
++				case ' ': xstrsncpy(status[j], GIT_NON, 4); break;
++				case 'M': xstrsncpy(status[j], GIT_MOD, 4); break;
++				case 'A': xstrsncpy(status[j], GIT_ADD, 4); break;
++				case '?': xstrsncpy(status[j], GIT_NEW, 4); break;
++				case '!': xstrsncpy(status[j], GIT_IGN, 4); break;
++				case 'D': xstrsncpy(status[j], GIT_DEL, 4); break;
++				case 'U': xstrsncpy(status[j], GIT_UPD, 4); break;
++			}
++	}
++	if (git_statuses.statuses[nr].status[1] != '!')
++		git_statuses.show = TRUE;
++}
++
+ static void resetdircolor(int flags)
+ {
+ 	/* Directories are always shown on top, clear the color when moving to first file */
+@@ -4104,6 +4176,9 @@ static void printent(const struct entry *ent, uint_t namecols, bool sel)
+ 	int attrs = 0, namelen;
+ 	uchar_t color_pair = get_color_pair_name_ind(ent, &ind, &attrs);
+
++	if (git_statuses.show && (cfg.showdetail || cfg.normalgit))
++		printw(" %s%s", ent->git_status[0], ent->git_status[1]);
++
+ 	addch((ent->flags & FILE_SELECTED) ? '+' | A_REVERSE | A_BOLD : ' ');
+
+ 	if (g_state.oldcolor)
+@@ -5598,6 +5673,11 @@ static int dentfill(char *path, struct entry **ppdents)
+ 		attron(COLOR_PAIR(cfg.curctx + 1));
+ 	}
+
++	char linkpath[PATH_MAX];
++	if ((git_statuses.len = get_git_statuses(path)))
++		if (!realpath(path, linkpath))
++			printwarn(NULL);
++
+ #if _POSIX_C_SOURCE >= 200112L
+ 	posix_fadvise(fd, 0, 0, POSIX_FADV_SEQUENTIAL);
+ #endif
+@@ -5798,6 +5878,29 @@ static int dentfill(char *path, struct entry **ppdents)
+ #endif
+ 		}
+
++		if (git_statuses.len) {
++			char dentpath[PATH_MAX];
++			size_t pathlen = mkpath(linkpath, dentp->name, dentpath);
++			dentp->git_status[0][0] = dentp->git_status[1][0] = '-';
++			dentp->git_status[0][1] = dentp->git_status[1][1] = '\0';
++
++			if (dentp->flags & DIR_OR_DIRLNK) {
++				char prefix[PATH_MAX];
++				memccpy(prefix, dentpath, '\0', PATH_MAX);
++				prefix[pathlen - 1] = '/';
++
++				for (size_t i = 0; i < git_statuses.len; ++i)
++					if (is_prefix(git_statuses.statuses[i].path, prefix, pathlen))
++						set_git_status(dentp->git_status, i);
++			} else {
++				for (size_t i = 0; i < git_statuses.len; ++i)
++					if (!xstrcmp(git_statuses.statuses[i].path, dentpath)) {
++						set_git_status(dentp->git_status, i);
++						break;
++					}
++			}
++		}
++
+ 		++ndents;
+ 	} while ((dp = readdir(dirp)));
+
+@@ -6362,7 +6465,8 @@ static int adjust_cols(int n)
+ 			cfg.showdetail ^= 1;
+ 		else /* 2 more accounted for below */
+ 			n -= (dtls.maxentln - 2 - dtls.maxnameln);
+-	}
++	} else if (cfg.normalgit && git_statuses.show)
++		n -= 3;
+
+ 	/* 2 columns for preceding space and indicator */
+ 	return (n - 2);
+@@ -6517,7 +6621,7 @@ static void redraw(char *path)
+ 			}
+ #endif
+ 		}
+-		dtls.maxentln = dtls.maxnameln + dtls.maxsizeln + (dtls.printguid ? (dtls.maxuidln + dtls.maxgidln + 29) : 26);
++		dtls.maxentln = dtls.maxnameln + dtls.maxsizeln + (dtls.printguid ? (dtls.maxuidln + dtls.maxgidln + 3) : 0) + (git_statuses.show ? 29 : 26);
+ 	}
+
+ 	ncols = adjust_cols(ncols);
+@@ -8153,6 +8257,7 @@ static void usage(void)
+ 		" -F val  fifo mode [0:preview 1:explore]\n"
+ #endif
+ 		" -g      regex filters\n"
++		" -G      always show git status\n"
+ 		" -H      show hidden files\n"
+ 		" -i      show current file info\n"
+ 		" -J      no auto-advance on selection\n"
+@@ -8292,6 +8397,7 @@ static void cleanup(void)
+ 		fflush(stdout);
+ 	}
+ #endif
++	free(git_statuses.statuses);
+ 	free(selpath);
+ 	free(plgpath);
+ 	free(cfgpath);
+@@ -8336,7 +8442,7 @@ int main(int argc, char *argv[])
+
+ 	while ((opt = (env_opts_id > 0
+ 		       ? env_opts[--env_opts_id]
+-		       : getopt(argc, argv, "aAb:BcCdDeEfF:gHiJKl:nNop:P:QrRs:St:T:uUVxh"))) != -1) {
++		       : getopt(argc, argv, "aAb:BcCdDeEfF:gGHiJKl:nNop:P:QrRs:St:T:uUVxh"))) != -1) {
+ 		switch (opt) {
+ #ifndef NOFIFO
+ 		case 'a':
+@@ -8390,6 +8496,9 @@ int main(int argc, char *argv[])
+ 			cfg.regex = 1;
+ 			filterfn = &visible_re;
+ 			break;
++		case 'G':
++			cfg.normalgit = 1;
++			break;
+ 		case 'H':
+ 			cfg.showhidden = 1;
+ 			break;

patches/namefirst/mainline.diff

@@ -0,0 +1,227 @@
+# Description: Prints filenames first in the detail view.  Prints user/group
+#              columns when a directory contains different users/groups.
+#
+# Author: Luuk van Baal
+
+diff --git a/src/nnn.c b/src/nnn.c
+index f8a2c58..9802a1f 100644
+--- a/src/nnn.c
++++ b/src/nnn.c
+@@ -394,6 +394,10 @@ typedef struct {
+ } session_header_t;
+ #endif
+ 
++static struct {
++	ushort_t maxnameln, maxsizeln, maxuidln, maxgidln, maxentln, uidln, gidln, printguid;
++} dtls;
++
+ /* GLOBALS */
+ 
+ /* Configuration, contexts */
+@@ -1070,10 +1074,12 @@ static char *getpwname(uid_t uid)
+ 	static char *namecache;
+ 
+ 	if (uidcache != uid) {
++		if (dtls.maxuidln && !dtls.printguid) dtls.printguid = 1;
+ 		struct passwd *pw = getpwuid(uid);
+ 
+ 		uidcache = uid;
+ 		namecache = pw ? pw->pw_name : NULL;
++		dtls.uidln = xstrlen(namecache ? namecache : xitoa(uid));
+ 	}
+ 
+ 	return namecache ? namecache : xitoa(uid);
+@@ -1085,10 +1091,12 @@ static char *getgrname(gid_t gid)
+ 	static char *grpcache;
+ 
+ 	if (gidcache != gid) {
++		if (dtls.maxgidln && !dtls.printguid) dtls.printguid = 1;
+ 		struct group *gr = getgrgid(gid);
+ 
+ 		gidcache = gid;
+ 		grpcache = gr ? gr->gr_name : NULL;
++		dtls.gidln = xstrlen(grpcache ? grpcache : xitoa(gid));
+ 	}
+ 
+ 	return grpcache ? grpcache : xitoa(gid);
+@@ -3834,14 +3842,13 @@ static void resetdircolor(int flags)
+  * Max supported str length: NAME_MAX;
+  */
+ #ifdef NOLC
+-static char *unescape(const char *str, uint_t maxcols)
++static size_t unescape(const char *str, uint_t maxcols)
+ {
+ 	char * const wbuf = g_buf;
+ 	char *buf = wbuf;
+-
+-	xstrsncpy(wbuf, str, maxcols);
++	size_t len = xstrsncpy(wbuf, str, maxcols);
+ #else
+-static wchar_t *unescape(const char *str, uint_t maxcols)
++static size_t unescape(const char *str, uint_t maxcols)
+ {
+ 	wchar_t * const wbuf = (wchar_t *)g_buf;
+ 	wchar_t *buf = wbuf;
+@@ -3866,7 +3873,7 @@ static wchar_t *unescape(const char *str, uint_t maxcols)
+ 		++buf;
+ 	}
+ 
+-	return wbuf;
++	return len;
+ }
+ 
+ static off_t get_size(off_t size, off_t *pval, int comp)
+@@ -4228,38 +4235,13 @@ static void printent(int pdents_index, uint_t namecols, bool sel)
+ {
+ 	const struct entry *ent = &pdents[pdents_index];
+ 	char ind = '\0';
+-	int attrs;
+-
+-	if (cfg.showdetail) {
+-		int type = ent->mode & S_IFMT;
+-		char perms[6] = {' ', ' ', (char)('0' + ((ent->mode >> 6) & 7)),
+-				(char)('0' + ((ent->mode >> 3) & 7)),
+-				(char)('0' + (ent->mode & 7)), '\0'};
+-
+-		addch(' ');
+-		attrs = g_state.oldcolor ? (resetdircolor(ent->flags), A_DIM)
+-					 : (fcolors[C_MIS] ? COLOR_PAIR(C_MIS) : 0);
+-		if (attrs)
+-			attron(attrs);
+-
+-		/* Print details */
+-		print_time(&ent->sec, ent->flags);
+-
+-		printw("%s%9s ", perms, (type == S_IFREG || type == S_IFDIR)
+-			? coolsize(cfg.blkorder ? (blkcnt_t)ent->blocks << blk_shift : ent->size)
+-			: (type = (uchar_t)get_detail_ind(ent->mode), (char *)&type));
+-
+-		if (attrs)
+-			attroff(attrs);
+-	}
++	int attrs = 0, namelen;
+ 
+ 	if (g_state.showlines) {
+ 		ptrdiff_t rel_num = pdents_index - cur;
+ 		printw(rel_num == 0 ? "%4td" : "%+4td", rel_num);
+ 	}
+ 
+-	attrs = 0;
+-
+ 	uchar_t color_pair = get_color_pair_name_ind(ent, &ind, &attrs);
+ 
+ 	addch((ent->flags & FILE_SELECTED) ? '+' | A_REVERSE | A_BOLD : ' ');
+@@ -4284,15 +4266,40 @@ static void printent(int pdents_index, uint_t namecols, bool sel)
+ 		++namecols;
+ 
+ #ifndef NOLC
+-	addwstr(unescape(ent->name, namecols));
++	addwstr((namelen = unescape(ent->name, namecols), (wchar_t *)g_buf));
+ #else
+-	addstr(unescape(ent->name, MIN(namecols, ent->nlen) + 1));
++	addstr((namelen = unescape(ent->name, MIN(namecols, ent->nlen) + 1), (char *)g_buf));
+ #endif
+ 
+-	if (attrs)
++	if (!sel && attrs)
+ 		attroff(attrs);
+ 	if (ind)
+ 		addch(ind);
++	if (cfg.showdetail) {
++		int type = ent->mode & S_IFMT;
++		char perms[6] = {(char)('0' + ((ent->mode >> 6) & 7)),
++				(char)('0' + ((ent->mode >> 3) & 7)),
++				(char)('0' + (ent->mode & 7)), ' ', ' ', '\0'}, *size = NULL;
++
++		if (attrs)
++			attron(attrs);
++		if (!g_state.oldcolor && (type == S_IFDIR || (type == S_IFLNK && ent->flags & DIR_OR_DIRLNK)))
++			attroff(A_BOLD);
++		int sizelen = (type == S_IFREG || type == S_IFDIR) ? xstrlen(size = coolsize(cfg.blkorder ? ent->blocks << blk_shift : ent->size)) : 1;
++		printw("%*c%*s%s%s", 1 + MIN(namecols, dtls.maxnameln + (uint_t)(ind ? 0 : 1)) - namelen, ' ',
++				dtls.maxsizeln - sizelen, "", size ? size : (type = (uchar_t)get_detail_ind(ent->mode), (char *)&type), "  ");
++#ifndef NOUG
++		if (g_state.uidgid && dtls.printguid) {
++			addstr(getpwname(ent->uid));
++			printw("%*c%s", dtls.maxuidln + 1 - dtls.uidln, ' ', getgrname(ent->gid));
++			printw("%*c", dtls.maxgidln + 2 - dtls.gidln, ' ');
++		}
++#endif
++		addstr(perms);
++		print_time(&ent->sec, ent->flags);
++	}
++	if (attrs)
++		attroff(attrs);
+ }
+ 
+ /**
+@@ -6527,26 +6534,19 @@ static void statusbar(char *path)
+ 	tocursor();
+ }
+ 
+-static inline void markhovered(void)
+-{
+-	if (cfg.showdetail && ndents) { /* Bold forward arrowhead */
+-		tocursor();
+-		addch('>' | A_BOLD);
+-	}
+-}
+-
+ static int adjust_cols(int n)
+ {
+ 	/* Calculate the number of cols available to print entry name */
+ #ifdef ICONS_ENABLED
+ 	n -= (g_state.oldcolor ? 0 : ICON_SIZE + ICON_PADDING_LEFT_LEN + ICON_PADDING_RIGHT_LEN);
+ #endif
++
+ 	if (cfg.showdetail) {
+ 		/* Fallback to light mode if less than 35 columns */
+-		if (n < 36)
++		if (n < (dtls.maxentln + 1 - dtls.maxnameln))
+ 			cfg.showdetail ^= 1;
+ 		else /* 2 more accounted for below */
+-			n -= 32;
++			n -= (dtls.maxentln - 2 - dtls.maxnameln);
+ 	}
+ 
+ 	/* 2 columns for preceding space and indicator */
+@@ -6412,8 +6411,6 @@ static void draw_line(int ncols)
+ 	/* Must reset e.g. no files in dir */
+ 	if (dir)
+ 		attroff(COLOR_PAIR(cfg.curctx + 1) | A_BOLD);
+-
+-	markhovered();
+ }
+ 
+ static void redraw(char *path)
+@@ -6521,6 +6518,21 @@ static void redraw(char *path)
+ 
+ 	onscreen = MIN(onscreen + curscroll, ndents);
+ 
++	if (cfg.showdetail) {
++		ushort_t lenbuf = dtls.maxnameln = dtls.maxsizeln = dtls.maxuidln = dtls.maxgidln = dtls.printguid = 0;
++		for (i = curscroll; i < onscreen; ++i) {
++			if ((lenbuf = pdents[i].nlen - 1) > dtls.maxnameln) dtls.maxnameln = lenbuf;
++			if ((lenbuf = xstrlen(coolsize(cfg.blkorder ? pdents[i].blocks << blk_shift : pdents[i].size))) > dtls.maxsizeln) dtls.maxsizeln = lenbuf;
++#ifndef NOUG
++			if (g_state.uidgid) {
++				if ((getpwname(pdents[i].uid), dtls.uidln) > dtls.maxuidln) dtls.maxuidln = dtls.uidln;
++				if ((getgrname(pdents[i].gid), dtls.gidln) > dtls.maxgidln) dtls.maxgidln = dtls.gidln;
++			}
++#endif
++		}
++		dtls.maxentln = dtls.maxnameln + dtls.maxsizeln + (dtls.printguid ? (dtls.maxuidln + dtls.maxgidln + 29) : 26);
++	}
++
+ 	ncols = adjust_cols(ncols);
+ 
+ 	int len = scanselforpath(path, FALSE);
+@@ -6551,7 +6563,7 @@ static void redraw(char *path)
+ #endif
+ 	}
+ 
+-	markhovered();
++	statusbar(path);
+ }
+ 
+ static bool cdprep(char *lastdir, char *lastname, char *path, char *newpath)

patches/restorepreview/mainline.diff

@@ -0,0 +1,269 @@
+# Description: Adds preview pipe to enable closing and re-opening the preview
+#              pane when running an undetached editor. If you are using vim
+#              you might experience incorrectly resized window. Consider adding
+#              the following to your vimrc:
+#              autocmd VimEnter * :silent exec "!kill -s WINCH $PPID"
+#
+# Authors: Luuk van Baal
+
+diff --git a/src/nnn.c b/src/nnn.c
+index 0388b23c..66d3316a 100644
+--- a/src/nnn.c
++++ b/src/nnn.c
+@@ -391,7 +391,8 @@ typedef struct {
+ 	uint_t usebsdtar  : 1;  /* Use bsdtar as default archive utility */
+ 	uint_t xprompt    : 1;  /* Use native prompt instead of readline prompt */
+ 	uint_t showlines  : 1;  /* Show line numbers */
+-	uint_t reserved   : 3;  /* Adjust when adding/removing a field */
++	uint_t previewer  : 1;  /* Run state of previewer */
++	uint_t reserved   : 2;  /* Adjust when adding/removing a field */
+ } runstate;
+ 
+ /* Contexts or workspaces */
+@@ -516,6 +517,9 @@ alignas(max_align_t) static char g_tmpfpath[TMP_LEN_MAX];
+ /* Buffer to store plugins control pipe location */
+ alignas(max_align_t) static char g_pipepath[TMP_LEN_MAX];
+ 
++/* Buffer to store preview plugins control pipe location */
++static char g_ppipepath[TMP_LEN_MAX] __attribute__ ((aligned));
++
+ /* Non-persistent runtime states */
+ static runstate g_state;
+ 
+@@ -696,12 +700,13 @@ static const char * const messages[] = {
+ #define NNN_FCOLORS 5
+ #define NNNLVL      6
+ #define NNN_PIPE    7
+-#define NNN_MCLICK  8
+-#define NNN_SEL     9
+-#define NNN_ARCHIVE 10
+-#define NNN_ORDER   11
+-#define NNN_HELP    12 /* strings end here */
+-#define NNN_TRASH   13 /* flags begin here */
++#define NNN_PPIPE   8
++#define NNN_MCLICK  9
++#define NNN_SEL     10
++#define NNN_ARCHIVE 11
++#define NNN_ORDER   12
++#define NNN_HELP    13 /* strings end here */
++#define NNN_TRASH   14 /* flags begin here */
+ 
+ static const char * const env_cfg[] = {
+ 	"NNN_OPTS",
+@@ -712,6 +717,7 @@ static const char * const env_cfg[] = {
+ 	"NNN_FCOLORS",
+ 	"NNNLVL",
+ 	"NNN_PIPE",
++	"NNN_PPIPE",
+ 	"NNN_MCLICK",
+ 	"NNN_SEL",
+ 	"NNN_ARCHIVE",
+@@ -850,7 +856,7 @@ static int set_sort_flags(int r);
+ static void statusbar(char *path);
+ static bool get_output(char *file, char *arg1, char *arg2, int fdout, bool page);
+ #ifndef NOFIFO
+-static void notify_fifo(bool force);
++static void notify_fifo(bool force, bool closepreview);
+ #endif
+ 
+ /* Functions */
+@@ -3140,7 +3146,7 @@ try_quit:
+ 			} else {
+ #ifndef NOFIFO
+ 				if (!g_state.fifomode)
+-					notify_fifo(TRUE); /* Send hovered path to NNN_FIFO */
++					notify_fifo(TRUE, FALSE); /* Send hovered path to NNN_FIFO */
+ #endif
+ 				escaped = TRUE;
+ 				settimeout();
+@@ -5258,15 +5264,20 @@ static void run_cmd_as_plugin(const char *file, uchar_t flags)
+ 
+ static bool plctrl_init(void)
+ {
+-	size_t len;
++	size_t len, lenbuf;
++	pid_t pid = getpid();
+ 
+ 	/* g_tmpfpath is used to generate tmp file names */
+ 	g_tmpfpath[tmpfplen - 1] = '\0';
+-	len = xstrsncpy(g_pipepath, g_tmpfpath, TMP_LEN_MAX);
++	len = lenbuf = xstrsncpy(g_pipepath, g_tmpfpath, TMP_LEN_MAX);
+ 	g_pipepath[len - 1] = '/';
+-	len = xstrsncpy(g_pipepath + len, "nnn-pipe.", TMP_LEN_MAX - len) + len;
+-	xstrsncpy(g_pipepath + len - 1, xitoa(getpid()), TMP_LEN_MAX - len);
++	xstrsncpy(g_ppipepath, g_pipepath, TMP_LEN_MAX);
++	len += xstrsncpy(g_pipepath + len, "nnn-pipe.", TMP_LEN_MAX - len);
++	xstrsncpy(g_pipepath + len - 1, xitoa(pid), TMP_LEN_MAX - len);
++	len = xstrsncpy(g_ppipepath + lenbuf, "nnn-ppipe.", TMP_LEN_MAX - lenbuf) + lenbuf;
++	xstrsncpy(g_ppipepath + len - 1, xitoa(pid), TMP_LEN_MAX - len);
+ 	setenv(env_cfg[NNN_PIPE], g_pipepath, TRUE);
++	setenv(env_cfg[NNN_PPIPE], g_ppipepath, TRUE);
+ 
+ 	return EXIT_SUCCESS;
+ }
+@@ -5295,6 +5306,21 @@ static ssize_t read_nointr(int fd, void *buf, size_t count)
+ 	return len;
+ }
+ 
++void *previewpipe(void *arg __attribute__ ((unused)))
++{
++	int fd, buf;
++
++	mkfifo(g_ppipepath, 0600);
++	fd = open(g_ppipepath, O_RDONLY);
++
++	if (read(fd, &buf, 1) == 1)
++		g_state.previewer = buf;
++
++	close(fd);
++	unlink(g_ppipepath);
++	return NULL;
++}
++
+ static char *readpipe(int fd, char *ctxnum, char **path)
+ {
+ 	char ctx, *nextpath = NULL;
+@@ -5979,7 +6005,7 @@ static void populate(char *path, char *lastname)
+ }
+ 
+ #ifndef NOFIFO
+-static void notify_fifo(bool force)
++static void notify_fifo(bool force, bool closepreview)
+ {
+ 	if (!fifopath)
+ 		return;
+@@ -5995,6 +6021,12 @@ static void notify_fifo(bool force)
+ 		}
+ 	}
+ 
++	if (closepreview) {
++		if (write(fifofd, "close\n", 6) != 6)
++			xerror();
++		return;
++	}
++
+ 	static struct entry lastentry;
+ 
+ 	if (!force && !memcmp(&lastentry, &pdents[cur], sizeof(struct entry))) // NOLINT
+@@ -6027,7 +6059,7 @@ static void send_to_explorer(int *presel)
+ 		if (fd > 1)
+ 			close(fd);
+ 	} else
+-		notify_fifo(TRUE); /* Send opened path to NNN_FIFO */
++		notify_fifo(TRUE, FALSE); /* Send opened path to NNN_FIFO */
+ }
+ #endif
+ 
+@@ -6060,7 +6092,7 @@ static void move_cursor(int target, int ignore_scrolloff)
+ 
+ #ifndef NOFIFO
+ 	if (!g_state.fifomode)
+-		notify_fifo(FALSE); /* Send hovered path to NNN_FIFO */
++		notify_fifo(FALSE, FALSE); /* Send hovered path to NNN_FIFO */
+ #endif
+ }
+ 
+@@ -6733,7 +6765,7 @@ static bool browse(char *ipath, const char *session, int pkey)
+ 	pEntry pent;
+ 	enum action sel;
+ 	struct stat sb;
+-	int r = -1, presel, selstartid = 0, selendid = 0;
++	int r = -1, presel, selstartid = 0, selendid = 0, previewkey = 0;
+ 	const uchar_t opener_flags = (cfg.cliopener ? F_CLI : (F_NOTRACE | F_NOSTDIN | F_NOWAIT));
+ 	bool watch = FALSE, cd = TRUE;
+ 	ino_t inode = 0;
+@@ -6991,7 +7023,7 @@ nochange:
+ 					move_cursor(r, 1);
+ #ifndef NOFIFO
+ 				else if ((event.bstate == BUTTON1_PRESSED) && !g_state.fifomode)
+-					notify_fifo(TRUE); /* Send clicked path to NNN_FIFO */
++					notify_fifo(TRUE, FALSE); /* Send clicked path to NNN_FIFO */
+ #endif
+ 				/* Handle right click selection */
+ 				if (event.bstate == BUTTON3_PRESSED) {
+@@ -7153,7 +7185,14 @@ nochange:
+ 			    && strstr(g_buf, "text")
+ #endif
+ 			) {
++				if (g_state.previewer)
++					notify_fifo(FALSE, TRUE);
+ 				spawn(editor, newpath, NULL, NULL, F_CLI);
++				if (g_state.previewer) {
++					pkey = previewkey;
++					goto run_plugin;
++				}
++
+ 				if (cfg.filtermode) {
+ 					presel = FILTER;
+ 					clearfilter();
+@@ -7471,8 +7510,14 @@ nochange:
+ 				copycurname();
+ 				goto nochange;
+ 			case SEL_EDIT:
++				if (g_state.previewer)
++					notify_fifo(FALSE, TRUE);
+ 				if (!(g_state.picker || g_state.fifomode))
+ 					spawn(editor, newpath, NULL, NULL, F_CLI);
++				if (g_state.previewer) {
++					pkey = previewkey;
++					goto run_plugin;
++				}
+ 				continue;
+ 			default: /* SEL_LOCK */
+ 				lock_terminal();
+@@ -7860,6 +7905,7 @@ nochange:
+ 			cd = FALSE;
+ 			goto begin;
+ 		}
++run_plugin:
+ 		case SEL_PLUGIN:
+ 			/* Check if directory is accessible */
+ 			if (!xdiraccess(plgpath)) {
+@@ -7885,6 +7931,12 @@ nochange:
+ 					goto nochange;
+ 				}
+ 
++				if (xstrcmp(tmp, "preview-tui") == 0) {
++					previewkey = r;
++					pthread_t tid;
++					pthread_create(&tid, NULL, previewpipe, NULL);
++				}
++
+ 				if (tmp[0] == '-' && tmp[1]) {
+ 					++tmp;
+ 					r = FALSE; /* Do not refresh dir after completion */
+@@ -7943,7 +7995,13 @@ nochange:
+ 		case SEL_SHELL: // fallthrough
+ 		case SEL_LAUNCH: // fallthrough
+ 		case SEL_PROMPT:
++			if (g_state.previewer)
++				notify_fifo(FALSE, TRUE);
+ 			r = handle_cmd(sel, path, newpath);
++			if (g_state.previewer) {
++				pkey = previewkey;
++				goto run_plugin;
++			}
+ 
+ 			/* Continue in type-to-nav mode, if enabled */
+ 			if (cfg.filtermode)
+@@ -8492,8 +8550,10 @@ static void cleanup(void)
+ 	if (g_state.autofifo)
+ 		unlink(fifopath);
+ #endif
+-	if (g_state.pluginit)
++	if (g_state.pluginit){
+ 		unlink(g_pipepath);
++		unlink(g_ppipepath);
++	}
+ #ifdef DEBUG
+ 	disabledbg();
+ #endif
+@@ -9020,7 +9080,7 @@ int main(int argc, char *argv[])
+ 
+ #ifndef NOFIFO
+ 	if (!g_state.fifomode)
+-		notify_fifo(FALSE);
++		notify_fifo(FALSE, TRUE);
+ 	if (fifofd != -1)
+ 		close(fifofd);
+ #endif

plugins/.cbcp

@@ -0,0 +1,51 @@
+#!/usr/bin/env sh
+
+# Description: Copy selection to system clipboard as newline-separated entries
+# Dependencies:
+# - tr
+# - xclip/xsel (Linux)
+# - pbcopy (macOS)
+# - termux-clipboard-set (Termux)
+# - clip.exe (WSL)
+# - clip (Cygwin)
+# - wl-copy (Wayland)
+# - clipboard (Haiku)
+#
+# Limitation: breaks if a filename has newline in it
+#
+# Note: For a space-separated list:
+#       xargs -0 < "$SELECTION"
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+IFS="$(printf '%b_' '\n')"; IFS="${IFS%_}" # protect trailing \n
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+[ -s "$selection" ] || { echo "plugin .cbcp error: empty selection" >&2 ; exit 1; }
+
+if [ "$XDG_SESSION_TYPE" = "wayland" ]; then
+    # Wayland
+    tr '\0' '\n' < "$selection" | wl-copy
+elif type xsel >/dev/null 2>&1; then
+    # Linux
+    tr '\0' '\n' < "$selection" | xsel -bi
+elif type xclip >/dev/null 2>&1; then
+    # Linux
+    tr '\0' '\n' < "$selection" | xclip -sel clip
+elif type pbcopy >/dev/null 2>&1; then
+    # macOS
+    tr '\0' '\n' < "$selection" | pbcopy
+elif type termux-clipboard-set >/dev/null 2>&1; then
+    # Termux
+    tr '\0' '\n' < "$selection" | termux-clipboard-set
+elif type clip.exe >/dev/null 2>&1; then
+    # WSL
+    tr '\0' '\n' < "$selection" | clip.exe
+elif type clip >/dev/null 2>&1; then
+    # Cygwin
+    tr '\0' '\n' < "$selection" | clip
+elif type clipboard >/dev/null 2>&1; then
+    # Haiku
+    tr '\0' '\n' < "$selection" | clipboard --stdin
+fi

plugins/.iconlookup

@@ -0,0 +1,441 @@
+#!/usr/bin/env sh
+
+# Description: Print icons in front of list of directories/files
+
+# Dependencies: awk
+
+# Usage
+#    1. Set colors and/or icons to your liking
+#    2. Pipe any directory listing to iconlookup and it will output prepended icons
+#    3. preview-tui uses the script to prepend icon to directory listings
+#    4. Aditionally you can consider adding it to your PATH and/or FZF_DEFAULT_COMMAND to
+#       make it work with various fzf plugins (make sure you also add --ansi to your FZF_DEFAULT_OPTS)
+
+# Shell: POSIX compliant
+
+# Author: Luuk van Baal (https://github.com/luukvbaal/iconlookup)
+
+icon_lookup() {
+awk 'BEGIN {
+# Set your ANSI colorscheme below (https://en.wikipedia.org/wiki/ANSI_escape_code#Colors).
+# Default uses standard nnn icon colors, 8 and 24-bit nord themes are commented out.
+    colordepth=8      #colordepth=8        #colordepth=24
+    color_dirtxt=39   #color_dirtxt=111    #color_dirtxt="129;161;193"
+    color_filetxt=15  #color_filetxt=111   #color_filetxt="129;161;193"
+    color_default=39  #color_default=111   #color_default="129;161;193"
+    color_video=93    #color_video=110     #color_video="136;192;208"
+    color_audio=220   #color_audio=150     #color_audio="163;190;140"
+    color_image=82    #color_image=150     #color_image="163;190;140"
+    color_docs=202    #color_docs=173      #color_docs="208;135;112"
+    color_archive=209 #color_archive=179   #color_archive="235;203;139"
+    color_c=81        #color_c=150         #color_c="163;190;140"
+    color_elixir=104  #color_elixir=109    #color_elixir="143;188;187"
+    color_java=32     #color_java=139      #color_java="180;142;173"
+    color_js=47       #color_js=109        #color_js="143;188;187"
+    color_react=39    #color_react=111     #color_react="129;161;193"
+    color_css=199     #color_css=110       #color_css="136;192;208"
+    color_python=227  #color_python=68     #color_python="94;129;172"
+    color_lua=19      #color_lua=167       #color_lua="191;97;106"
+    color_document=15 #color_document=173  #color_document="208;135;112"
+    color_fsharp=31   #color_fsharp=179    #color_fsharp="180;142;173"
+    color_ruby=160    #color_ruby=150      #color_ruby="163;190;140"
+    color_scala=196   #color_scala=139     #color_scala="143;188;187"
+    color_shell=47    #color_shell=109     #color_shell="143;188;187"
+    color_vim=28      #color_vim=109       #color_vim="143;188;187"
+
+# icons[][1] contains icon and icons[][2] contains color
+    icons["directory"][1] = ""; icons["directory"][2] = color_default
+    icons["file"][1] = "󰈔"; icons["file"][2] = color_default
+    icons["exec"][1] = ""; icons["exec"][2] = color_default
+    icons["manual"][1] = "󱓷"; icons["manual"][2] = color_docs
+    icons["pipe"][1] = "󰟥"; icons["pipe"][2] = color_default
+    icons["socket"][1] = "󰟩"; icons["socket"][2] = color_default
+    icons["door"][1] = "➡"; icons["door"][2] = color_default
+
+# top level and common icons
+    icons[".git"][1] = ""; icons[".git"][2] = color_default
+    icons["desktop"][1] = "󰟀"; icons["desktop"][2] = color_default
+    icons["briefcase"][1] = "󰃖"; icons["briefcase"][2] = color_default
+    icons["document"][1] = "󰃖"; icons["document"][2] = color_default
+    icons["downloads"][1] = "󰃘"; icons["downloads"][2] = color_default
+    icons["music"][1] = "󱍙"; icons["music"][2] = color_default
+    icons["musicfile"][1] = "󰎈"; icons["musicfile"][2] = color_audio
+    icons["pictures"][1] = "󰉔"; icons["pictures"][2] = color_default
+    icons["picturefile"][1] = "󰈟"; icons["picturefile"][2] = color_image
+    icons["public"][1] = ""; icons["public"][2] = color_default
+    icons["templates"][1] = "󰗇"; icons["templates"][2] = color_default
+    icons["videos"][1] = "󰈰"; icons["videos"][2] = color_default
+    icons["videofile"][1] = "󰈫"; icons["videofile"][2] = color_video
+    icons["changelog"][1] = "󰋚"; icons["changelog"][2] = color_docs
+    icons["configure"][1] = ""; icons["configure"][2] = color_default
+    icons["license"][1] = "󰈙"; icons["license"][2] = color_docs
+    icons["makefile"][1] = "󰆍"; icons["makefile"][2] = color_default
+    icons["archive"][1] = "󰀼"; icons["archive"][2] = color_archive
+    icons["rust"][1] = ""; icons["rust"][2] = color_default
+    icons["script"][1] = ""; icons["script"][2] = color_shell
+    icons["subtitle"][1] = "󰅺"; icons["subtitle"][2] = color_default
+    icons["cplusplus"][1] = ""; icons["cplusplus"][2] = color_c
+    icons["java"][1] = ""; icons["java"][2] = color_java
+    icons["clojure"][1] = ""; icons["clojure"][2] = color_default
+    icons["js"][1] = "󰌞"; icons["js"][2] = color_js
+    icons["linux"][1] = "󰌽"; icons["linux"][2] = color_default
+    icons["elixir"][1] = ""; icons["elixir"][2] = color_fsharp
+    icons["fsharp"][1] = ""; icons["fsharp"][2] = color_fsharp
+    icons["ruby"][1] = ""; icons["ruby"][2] = color_ruby
+    icons["c"][1] = ""; icons["c"][2] = color_c
+    icons["chess"][1] = "󰄺"; icons["chess"][2] = color_default
+    icons["haskell"][1] = ""; icons["haskell"][2] = color_vim
+    icons["font"][1] = ""; icons["font"][2] = color_default
+    icons["html"][1] = "󰌝"; icons["html"][2] = color_default
+    icons["react"][1] = ""; icons["react"][2] = color_react
+    icons["python"][1] = ""; icons["python"][2] = color_python
+    icons["database"][1] = "󰆼"; icons["database"][2] = color_default
+    icons["worddoc"][1] = "󰈬"; icons["worddoc"][2] = color_document
+    icons["playlist"][1] = "󱍙"; icons["playlist"][2] = color_audio
+    icons["opticaldisk"][1] = ""; icons["opticaldisk"][2] = color_archive
+
+# numbers
+    icons["1"][1] = icons["manual"][1]; icons["1"][2] = icons["manual"][2]
+    icons["7z"][1] = icons["archive"][1]; icons["7z"][2] = icons["archive"][2]
+
+# a
+    icons["a"][1] = icons["manual"][1]; icons["a"][2] = icons["manual"][2]
+    icons["apk"][1] = icons["archive"][1]; icons["apk"][2] = icons["archive"][2]
+    icons["asm"][1] = icons["file"][1]; icons["asm"][2] = icons["file"][2]
+    icons["aup"][1] = icons["musicfile"][1]; icons["aup"][2] = icons["musicfile"][2]
+    icons["avi"][1] = icons["videofile"][1]; icons["avi"][2] = icons["videofile"][2]
+
+# b
+    icons["bat"][1] = icons["script"][1]; icons["bat"][2] = icons["script"][2]
+    icons["bin"][1] = ""; icons["bin"][2] = color_default
+    icons["bmp"][1] = icons["picturefile"][1]; icons["bmp"][2] = icons["picturefile"][2]
+    icons["bz2"][1] = icons["archive"][1]; icons["bz2"][2] = icons["archive"][2]
+
+# c
+    icons["cplusplus"][1] = icons["cplusplus"][1]; icons["cplusplus"][2] = icons["cplusplus"][2]
+    icons["cabal"][1] = icons["haskell"][1]; icons["cab"][2] = icons["haskell"][2]
+    icons["cab"][1] = icons["archive"][1]; icons["cab"][2] = icons["archive"][2]
+    icons["cbr"][1] = icons["archive"][1]; icons["cbr"][2] = icons["archive"][2]
+    icons["cbz"][1] = icons["archive"][1]; icons["cbz"][2] = icons["archive"][2]
+    icons["cc"][1] = icons["cplusplus"][1]; icons["cc"][2] = icons["cplusplus"][2]
+    icons["class"][1] = icons["java"][1]; icons["class"][2] = icons["java"][2]
+    icons["clj"][1] = icons["clojure"][1]; icons["clj"][2] = icons["clojure"][2]
+    icons["cljc"][1] = icons["clojure"][1]; icons["cljc"][2] = icons["clojure"][2]
+    icons["cljs"][1] = icons["clojure"][1]; icons["cljs"][2] = icons["clojure"][2]
+    icons["cmake"][1] = icons["makefile"][1]; icons["cmake"][2] = icons["makefile"][2]
+    icons["coffee"][1] = ""; icons["coffee"][2] = color_default
+    icons["conf"][1] = icons["configure"][1]; icons["conf"][2] = icons["configure"][2]
+    icons["cpio"][1] = icons["archive"][1]; icons["cpio"][2] = icons["archive"][2]
+    icons["cpp"][1] = icons["cplusplus"][1]; icons["cpp"][2] = icons["cplusplus"][2]
+    icons["css"][1] = ""; icons["css"][2] = color_css
+    icons["cue"][1] = icons["playlist"][1]; icons["cue"][2] = icons["playlist"][2]
+    icons["cvs"][1] = icons["configure"][1]; icons["cvs"][2] = icons["configure"][2]
+    icons["cxx"][1] = icons["cplusplus"][1]; icons["cxx"][2] = icons["cplusplus"][2]
+
+# d
+    icons["db"][1] = icons["database"][1]; icons["db"][2] = icons["database"][2]
+    icons["deb"][1] = ""; icons["deb"][2] = color_archive
+    icons["diff"][1] = ""; icons["diff"][2] = color_default
+    icons["dll"][1] = icons["script"][1]; icons["dll"][2] = icons["script"][2]
+    icons["doc"][1] = icons["worddoc"][1]; icons["doc"][2] = icons["worddoc"][2]
+    icons["docx"][1] = icons["worddoc"][1]; icons["docx"][2] = icons["worddoc"][2]
+
+# e
+    icons["ejs"][1] = icons["js"][1]; icons["ejs"][2] = icons["js"][2]
+    icons["elf"][1] = icons["linux"][1]; icons["elf"][2] = icons["linux"][2]
+    icons["epub"][1] = icons["manual"][1]; icons["epub"][2] = icons["manual"][2]
+    icons["exe"][1] = icons["exec"][1]; icons["exe"][2] = icons["exec"][2]
+    icons["ex"][1] = icons["elixir"][1]; icons["ex"][2] = icons["elixir"][2]
+    icons["eex"][1] = icons["elixir"][1]; icons["eex"][2] = icons["elixir"][2]
+    icons["exs"][1] = icons["elixir"][1]; icons["exs"][2] = icons["elixir"][2]
+
+# f
+    icons["fsharp"][1] = icons["fsharp"][1]; icons["fsharp"][2] = icons["fsharp"][2]
+    icons["flac"][1] = icons["musicfile"][1]; icons["flac"][2] = icons["musicfile"][2]
+    icons["fen"][1] = icons["chess"][1]; icons["fen"][2] = icons["chess"][2]
+    icons["flv"][1] = icons["videofile"][1]; icons["flv"][2] = icons["videofile"][2]
+    icons["fs"][1] = icons["fsharp"][1]; icons["fs"][2] = icons["fsharp"][2]
+    icons["fsi"][1] = icons["fsharp"][1]; icons["fsi"][2] = icons["fsharp"][2]
+    icons["fsscript"][1] = icons["fsharp"][1]; icons["fsscript"][2] = icons["fsharp"][2]
+    icons["fsx"][1] = icons["fsharp"][1]; icons["fsx"][2] = icons["fsharp"][2]
+
+# g
+    icons["gem"][1] = icons["ruby"][1]; icons["gem"][2] = icons["ruby"][2]
+    icons["gif"][1] = icons["picturefile"][1]; icons["gif"][2] = icons["picturefile"][2]
+    icons["go"][1] = "󰟓"; icons["go"][2] = color_default
+    icons["gz"][1] = icons["archive"][1]; icons["gz"][2] = icons["archive"][2]
+    icons["gzip"][1] = icons["archive"][1]; icons["gzip"][2] = icons["archive"][2]
+
+# h
+    icons["h"][1] = icons["c"][1]; icons["h"][2] = icons["c"][2]
+    icons["hh"][1] = icons["cplusplus"][1]; icons["hh"][2] = icons["cplusplus"][2]
+    icons["hpp"][1] = icons["cplusplus"][1]; icons["hpp"][2] = icons["cplusplus"][2]
+    icons["hs"][1] = icons["haskell"][1]; icons["hs"][2] = icons["haskell"][2]
+    icons["htaccess"][1] = icons["configure"][1]; icons["htaccess"][2] = icons["configure"][2]
+    icons["htpasswd"][1] = icons["configure"][1]; icons["htpasswd"][2] = icons["configure"][2]
+    icons["htm"][1] = icons["html"][1]; icons["htm"][2] = icons["html"][2]
+    icons["hxx"][1] = icons["cplusplus"][1]; icons["hxx"][2] = icons["cplusplus"][2]
+    icons["heex"][1] = icons["elixir"][1]; icons["heex"][2] = icons["elixir"][2]
+
+# i
+    icons["ico"][1] = icons["picturefile"][1]; icons["ico"][2] = icons["picturefile"][2]
+    icons["img"][1] = icons["opticaldisk"][1]; icons["img"][2] = icons["opticaldisk"][2]
+    icons["ini"][1] = icons["configure"][1]; icons["ini"][2] = icons["configure"][2]
+    icons["iso"][1] = icons["opticaldisk"][1]; icons["iso"][2] = icons["opticaldisk"][2]
+    icons["isub"][1] = icons["subtitle"][1]; icons["isub"][2] = icons["subtitle"][2]
+
+# j
+    icons["jar"][1] = icons["java"][1]; icons["jar"][2] = icons["java"][2]
+    icons["java"][1] = icons["java"][1]; icons["java"][2] = icons["java"][2]
+    icons["jl"][1] = icons["configure"][1]; icons["jl"][2] = icons["configure"][2]
+    icons["jpeg"][1] = icons["picturefile"][1]; icons["jpeg"][2] = icons["picturefile"][2]
+    icons["jpg"][1] = icons["picturefile"][1]; icons["jpg"][2] = icons["picturefile"][2]
+    icons["json"][1] = ""; icons["json"][2] = color_js
+    icons["jsx"][1] = icons["react"][1]; icons["jsx"][2] = icons["react"][2]
+    icons["jxl"][1] = icons["picturefile"][1]; icons["jxl"][2] = icons["picturefile"][2]
+
+# k
+    icons["ksh"][1] = icons["font"][1]; icons["ksf"][2] = icons["font"][2]
+
+# l
+    icons["lha"][1] = icons["archive"][1]; icons["lha"][2] = icons["archive"][2]
+    icons["lhs"][1] = icons["haskell"][1]; icons["lhs"][2] = icons["haskell"][2]
+    icons["ilog"][1] = icons["document"][1]; icons["ilog"][2] = icons["document"][2]
+    icons["lua"][1] = ""; icons["lua"][2] = color_lua
+    icons["lzh"][1] = icons["archive"][1]; icons["lzh"][2] = icons["archive"][2]
+    icons["lzma"][1] = icons["archive"][1]; icons["lzma"][2] = icons["archive"][2]
+
+# m
+    icons["m"][1] = "󰠞"; icons["mat"][2] = color_c
+    icons["m4a"][1] = icons["musicfile"][1]; icons["m4a"][2] = icons["musicfile"][2]
+    icons["m4v"][1] = icons["videofile"][1]; icons["m4v"][2] = icons["videofile"][2]
+    icons["mat"][1] = ""; icons["mat"][2] = color_c
+    icons["markdown"][1] = ""; icons["markdown"][2] = color_docs
+    icons["md"][1] = ""; icons["md"][2] = color_docs
+    icons["mk"][1] = icons["makefile"][1]; icons["mk"][2] = icons["makefile"][2]
+    icons["mkv"][1] = icons["videofile"][1]; icons["mkv"][2] = icons["videofile"][2]
+    icons["mov"][1] = icons["videofile"][1]; icons["mov"][2] = icons["videofile"][2]
+    icons["mp3"][1] = icons["musicfile"][1]; icons["mp3"][2] = icons["musicfile"][2]
+    icons["mp4"][1] = icons["videofile"][1]; icons["mp4"][2] = icons["videofile"][2]
+    icons["mpeg"][1] = icons["videofile"][1]; icons["mpeg"][2] = icons["videofile"][2]
+    icons["mpg"][1] = icons["videofile"][1]; icons["mpg"][2] = icons["videofile"][2]
+    icons["msi"][1] = "󰍲"; icons["msi"][2] = color_default
+
+# n
+    icons["nix"][1] = ""; icons["nix"][2] = color_fsharp
+
+# o
+    icons["o"][1] = icons["manual"][1]; icons["o"][2] = icons["manual"][2]
+    icons["ogg"][1] = icons["musicfile"][1]; icons["ogg"][2] = icons["musicfile"][2]
+    icons["odownload"][1] = icons["download"][1]; icons["odownload"][2] = icons["download"][2]
+    icons["otf"][1] = icons["font"][1]; icons["otf"][2] = icons["font"][2]
+    icons["out"][1] = icons["linux"][1]; icons["out"][2] = icons["linux"][2]
+
+# p
+    icons["part"][1] = icons["download"][1]; icons["part"][2] = icons["download"][2]
+    icons["patch"][1] = icons["diff"][1]; icons["patch"][2] = icons["diff"][2]
+    icons["pdf"][1] = "󰈦"; icons["pdf"][2] = color_docs
+    icons["pgn"][1] = icons["chess"][1]; icons["pgn"][2] = icons["chess"][2]
+    icons["php"][1] = ""; icons["php"][2] = color_default
+    icons["png"][1] = icons["picturefile"][1]; icons["png"][2] = icons["picturefile"][2]
+    icons["ppt"][1] = "󰈧"; icons["ppt"][2] = color_default
+    icons["pptx"][1] = "󰈧"; icons["pptx"][2] = color_default
+    icons["psb"][1] = ""; icons["psb"][2] = color_default
+    icons["psd"][1] = ""; icons["psd"][2] = color_default
+    icons["py"][1] = icons["python"][1]; icons["py"][2] = icons["python"][2]
+    icons["pyc"][1] = icons["python"][1]; icons["pyc"][2] = icons["python"][2]
+    icons["pyd"][1] = icons["python"][1]; icons["pyd"][2] = icons["python"][2]
+    icons["pyo"][1] = icons["python"][1]; icons["pyo"][2] = icons["python"][2]
+
+# q
+
+# r
+    icons["rar"][1] = icons["archive"][1]; icons["rar"][2] = icons["archive"][2]
+    icons["rc"][1] = icons["configure"][1]; icons["rc"][2] = icons["configure"][2]
+    icons["rom"][1] = "󰊖"; icons["rom"][2] = color_default
+    icons["rpm"][1] = icons["archive"][1]; icons["rpm"][2] = icons["archive"][2]
+    icons["rss"][1] = ""; icons["rss"][2] = color_default
+    icons["rtf"][1] = "󰈦"; icons["rtf"][2] = color_default
+
+# s
+    icons["sass"][1] = ""; icons["sass"][2] = color_css
+    icons["scss"][1] = ""; icons["scss"][2] = color_css
+    icons["so"][1] = icons["manual"][1]; icons["so"][2] = icons["manual"][2]
+    icons["scala"][1] = ""; icons["scala"][2] = color_scala
+    icons["sh"][1] = icons["script"][1]; icons["sh"][2] = icons["script"][2]
+    icons["slim"][1] = icons["script"][1]; icons["slim"][2] = icons["script"][2]
+    icons["sln"][1] = ""; icons["sln"][2] = color_default
+    icons["sql"][1] = icons["database"][1]; icons["sql"][2] = icons["database"][2]
+    icons["srt"][1] = icons["subtitle"][1]; icons["srt"][2] = icons["subtitle"][2]
+    icons["svg"][1] = icons["picturefile"][1]; icons["svg"][2] = icons["picturefile"][2]
+
+# t
+    icons["tar"][1] = icons["archive"][1]; icons["tar"][2] = icons["archive"][2]
+    icons["tex"][1] = "󰙩"; icons["tex"][2] = color_default
+    icons["tgz"][1] = icons["archive"][1]; icons["tgz"][2] = icons["archive"][2]
+    icons["ts"][1] = ""; icons["ts"][2] = color_js
+    icons["tsx"][1] = icons["react"][1]; icons["tsx"][2] = icons["react"][2]
+    icons["txt"][1] = icons["document"][1]; icons["txt"][2] = icons["document"][2]
+    icons["txz"][1] = icons["archive"][1]; icons["txz"][2] = icons["archive"][2]
+    icons["ttf"][1] = icons["font"][1]; icons["ttf"][2] = icons["font"][2]
+
+# u
+
+# v
+    icons["vid"][1] = icons["videofile"][1]; icons["vid"][2] = icons["videofile"][2]
+    icons["vim"][1] = ""; icons["vim"][2] = color_vim
+    icons["vimrc"][1] = ""; icons["vimrc"][2] = color_vim
+    icons["vtt"][1] = icons["subtitle"][1]; icons["vtt"][2] = icons["subtitle"][2]
+# w
+    icons["wav"][1] = icons["musicfile"][1]; icons["wav"][2] = icons["musicfile"][2]
+    icons["webm"][1] = icons["videofile"][1]; icons["webm"][2] = icons["videofile"][2]
+    icons["wma"][1] = icons["videofile"][1]; icons["wma"][2] = icons["videofile"][2]
+    icons["wmv"][1] = icons["videofile"][1]; icons["wmv"][2] = icons["videofile"][2]
+
+# x
+    icons["xbps"][1] = icons["archive"][1]; icons["xbps"][2] = color_archive
+    icons["xcf"][1] = icons["picturefile"][1]; icons["xcf"][2] = color_image
+    icons["xhtml"][1] = icons["html"][1]; icons["xhtml"][2] = icons["html"][2]
+    icons["xls"][1] = "󰈛"; icons["xls"][2] = color_default
+    icons["xlsx"][1] = "󰈛"; icons["xlsx"][2] = color_default
+    icons["xml"][1] = icons["html"][1]; icons["xml"][2] = icons["html"][2]
+    icons["xz"][1] = icons["archive"][1]; icons["xz"][2] = icons["archive"][2]
+
+# y
+    icons["yaml"][1] = icons["configure"][1]; icons["yaml"][2] = icons["configure"][2]
+    icons["yml"][1] = icons["configure"][1]; icons["yml"][2] = icons["configure"][2]
+# z
+    icons["zip"][1] = icons["archive"][1]; icons["zip"][2] = icons["archive"][2]
+    icons["zsh"][1] = icons["script"][1]; icons["zsh"][2] = icons["script"][2]
+    icons["zst"][1] = icons["archive"][1]; icons["zst"][2] = icons["archive"][2]
+
+    FS = "."
+    limit = ENVIRON["limit"]
+    switch (colordepth) {
+        case "4":
+            escape="\033["
+            break;
+        case "8":
+            escape="\033[38;5;"
+            break;
+        case "24":
+            escape="\033[38;2;"
+            break;
+    }
+    bstr = ENVIRON["beforestr"]
+}
+{
+    # dont print cwd . and leading ./ from tree -f
+    if ($0 ~/^\.$/)
+        next
+    ent = ($0 ~/^\.\//) ? substr($0, 3, length($0) - 2) : $0
+    ext = $NF
+
+    # Print icons, set color and bold directories by using ansi escape codes
+    if (ext in icons)
+        printcolor(icons[ext][1], icons[ext][2], color_filetxt, ent, "10")
+    else
+        switch (substr(ent, length(ent), 1)) {
+            case "/":
+                printcolor(icons["directory"][1], color_default, color_dirtxt, ent, "1")
+                break;
+            case "*":
+                printcolor(icons["exe"][1], color_default, color_filetxt, ent, "10")
+                break;
+            case "|":
+                printcolor(icons["pipe"][1], color_default, color_filetxt, ent, "10")
+                break;
+            case "=":
+                printcolor(icons["socket"][1], color_default, color_filetxt, ent, "10")
+                break;
+            case ">":
+                printcolor(icons["door"][1], color_default, color_filetxt, ent, "10")
+                break;
+            default:
+                printcolor(icons["file"][1], color_default, color_filetxt, ent, "10")
+        }
+}
+function printcolor(i, c, d, n, b) {
+    if (limit != "" && length(n) + 2 > limit)
+        n = substr(n, 1, limit - 2)
+    printf "\033[0m"
+    printf "%s%s%s;%sm%s %s%sm%s\n", bstr, escape, c, b, i, escape, d, n
+}'
+printf '\033[0m'
+}
+
+print_begin() {
+    printf '%s\n' "$1" | sed 's/\\n/\n/g'
+}
+
+print_end() {
+    printf '%s\n' "$1" | sed 's/\\n/\n/g'
+}
+
+print_help() {
+    printf 'Icon Lookup\n
+Usage:
+    iconlookup [options]
+    iconlookup [-bBe] [string]
+    iconlookup -l [number]
+    iconlookup (-h | --help)
+
+    Prepend icons to list of files based on extension or appended indicator by ls/tree "-F" flag ("/" for directory, "*" for executable etc.)
+
+Options:
+    -h --help -?         Show this screen.
+    -b --before          Prepend str before icon.
+    -B --begin           Prepend str before output.
+    -e --end             Append str after output.
+    -l --limit           Limit line length to [number] characters.'
+}
+
+while :; do
+    case $1 in
+        -h|-\?|--help)
+            print_help
+            exit ;;
+        -B|--begin)
+            if [ -n "$2" ]; then
+                print_begin "$2"
+            fi
+            shift ;;
+        -e|--end)
+            if [ -n "$2" ]; then
+                end=1
+                endstr="$2"
+            fi
+            shift ;;
+        -b|--before)
+            if [ -n "$2" ]; then
+                export beforestr="$2"
+            fi
+            shift ;;
+        -l|--limit)
+            if [ -n "$2" ]; then
+                export limit="$2"
+                shift
+            else
+                printf 'ERROR: "--limit" requires a non-empty option argument.\n'
+                exit
+            fi ;;
+        --)
+            shift
+            break ;;
+        -?*)
+            printf 'WARNING: Unknown option ignored: %s\n' "$1" ;;
+        *) break ;;
+    esac
+    shift
+done
+
+if [ ! -t 0 ]; then
+    [ -n "$beforestr" ] && limit="$((limit - ${#beforestr}))"
+    icon_lookup
+else
+    printf 'ERROR: no data provided...\nExpecting a directory listing in stdin\n'
+fi
+
+if [ -n "$end" ]; then
+    print_end "$endstr"
+fi

plugins/.nmv

@@ -0,0 +1,174 @@
+#!/usr/bin/env bash
+
+# Description: An almost fully POSIX compliant batch file renamer
+#
+# Note: nnn auto-detects and invokes this plugin if available
+#       Whitespace is used as delimiter for read.
+#       The plugin doesn't support filenames with leading or trailing whitespace
+#       To use NNN_LIST your shell must support readlink(1)
+#
+# Capabilities:
+#    1. Basic file rename
+#    2. Detects order change
+#    3. Can move files
+#    4. Can remove files
+#    5. Switch number pairs to swap filenames
+#
+# Shell: bash
+# Author: KlzXS
+
+# shellcheck disable=SC1090,SC1091
+. "$(dirname "$0")"/.nnn-plugin-helper
+
+EDITOR="${EDITOR:-vi}"
+TMPDIR="${TMPDIR:-/tmp}"
+NNN_INCLUDE_HIDDEN="${NNN_INCLUDE_HIDDEN:-0}"
+VERBOSE="${VERBOSE:-0}"
+RECURSIVE="${RECURSIVE:-0}"
+
+case "$NNN_TRASH" in
+	1)
+		RM_UTIL="trash-put" ;;
+	2)
+		RM_UTIL="gio trash" ;;
+	*)
+		RM_UTIL="rm -ri --" ;;
+esac
+
+exit_status=0
+
+if nnn_use_selection "Rename"; then
+	# shellcheck disable=SC2154
+	arr=$(tr '\0' '\n' < "$selection")
+else
+	findcmd="find . ! -name ."
+
+	if [ "$RECURSIVE" -eq 0 ]; then
+		findcmd="$findcmd -prune"
+	fi
+
+	if [ "$NNN_INCLUDE_HIDDEN" -eq 0 ]; then
+		findcmd="$findcmd ! -name \".*\""
+	fi
+
+	if [ -z "$NNN_LIST" ]; then
+		findcmd="$findcmd -print"
+	else
+		findcmd="$findcmd -printf "'"'"$NNN_LIST/%P\n"'"'
+	fi
+
+	arr=$(eval "$findcmd" | sort)
+fi
+
+lines=$(printf "%s\n" "$arr" | wc -l)
+width=${#lines}
+
+dst_file=$(mktemp "$TMPDIR/.nnnXXXXXX")
+trap 'rm -f -- "$dst_file"' EXIT
+
+printf "%s" "$arr" | awk '{printf("%'"${width}"'d %s\n", NR, $0)}' > "$dst_file"
+
+items=("~")
+while IFS='' read -r line; do
+	if [ -n "$NNN_LIST" ]; then
+		line=$(readlink "$line" || printf "%s" "$line")
+	fi
+
+	items+=("$line");
+done < <(printf "%s\n" "$arr")
+
+$EDITOR "$dst_file"
+
+while read -r num name; do
+	if [ -z "$name" ]; then
+		if [ -z "$num" ]; then
+			continue
+		fi
+
+		printf "%s: unable to parse line, aborting\n" "$0"
+		exit 1
+	fi
+
+	# check if $num is an integer
+	if [ ! "$num" -eq "$num" ] 2> /dev/null; then
+		printf "%s: unable to parse line, aborting\n" "$0"
+		exit 1
+	fi
+
+	src=${items[$num]}
+
+	if [ -z "$src" ]; then
+		printf "%s: unknown item number %s\n" "$0" "$num" > /dev/stderr
+		continue
+	elif [ "$name" != "$src" ]; then
+		if [ -z "$name" ]; then
+			continue
+		fi
+
+		if [ ! -e "$src" ] && [ ! -L "$src" ]; then
+			printf "%s: %s does not exit\n" "$0" "$src" > /dev/stderr
+
+			unset "items[$num]"
+			continue
+		fi
+
+		# handle swaps
+		if [ -e "$name" ] || [ -L "$name" ]; then
+			tmp="$name~"
+			c=0
+
+			while [ -e "$tmp" ] || [ -L "$tmp" ]; do
+				c=$((c+1))
+				tmp="$tmp~$c"
+			done
+
+			if mv -- "$name" "$tmp"; then
+				if [ "$VERBOSE" -ne 0 ]; then
+					printf "'%s' -> '%s'\n" "$name" "$tmp"
+				fi
+			else
+				printf "%s: failed to rename %s to %s: %s\n" "$0" "$name" "$tmp" "$!" > /dev/stderr
+				exit_status=1
+			fi
+
+			for key in "${!items[@]}"; do
+				if [ "${items[$key]}" = "$name" ]; then
+					items[$key]="$tmp"
+				fi
+			done
+		fi
+
+		dir=$(dirname "$name")
+		if [ ! -d "$dir" ] && ! mkdir -p "$dir"; then
+			printf "%s: failed to create directory tree %s\n" "$0" "$dir" > /dev/stderr
+			exit_status=1
+		elif ! mv -i -- "$src" "$name"; then
+			printf "%s: failed to rename %s to %s: %s\n" "$0" "$name" "$tmp" "$!" > /dev/stderr
+			exit_status=1
+		else
+			if [ -d "$name" ]; then
+				for key in "${!items[@]}"; do
+					items[$key]=$(printf "%s" "${items[$key]}" | sed "s|^$src\(\$\|\/\)|$name\1|")
+				done
+
+				if [ "$VERBOSE" -ne 0 ]; then
+					printf "'%s' => '%s'\n" "$src" "$name"
+				fi
+			else
+				true
+				if [ "$VERBOSE" -ne 0 ]; then
+					printf "'%s' -> '%s'\n" "$src" "$name"
+				fi
+			fi
+		fi
+	fi
+
+	unset "items[$num]"
+done <"$dst_file"
+
+unset "items[0]"
+for item in "${items[@]}"; do
+	$RM_UTIL "$item"
+done
+
+exit $exit_status

plugins/.nnn-plugin-helper

@@ -0,0 +1,61 @@
+#!/usr/bin/env sh
+
+# Description: Helper script for plugins
+#
+# Shell: POSIX compliant
+# Author: Anna Arad
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+export selection
+
+## Set CUR_CTX to 1 to open directory in current context
+CUR_CTX=0
+export CUR_CTX
+
+NNN_PREFER_SELECTION="${NNN_PREFER_SELECTION:-0}"
+export NNN_PREFER_SELECTION
+
+## Ask nnn to switch to directory $1 in context $2.
+## If $2 is not provided, the function asks explicitly.
+nnn_cd () {
+    dir="$1"
+
+    if [ -z "$NNN_PIPE" ]; then
+        echo "No pipe file found" 1>&2
+        return
+    fi
+
+    if [ -n "$2" ]; then
+        context=$2
+    elif [ $CUR_CTX -ne 1 ]; then
+        printf "Choose context 1-4 (blank for current): "
+        read -r context
+    fi
+
+    printf "%s" "${context:-0}c$dir" > "$NNN_PIPE"
+}
+
+cmd_exists () {
+    type "$1" > /dev/null 2>&1
+    echo $?
+}
+
+nnn_use_selection() {
+    if ! [ -s "$selection" ]; then
+        return 1
+    fi
+
+    if [ "$NNN_PREFER_SELECTION" -eq 1 ]; then
+        return 0
+    else
+        [ -n "$1" ] && printf "%s " "$1"
+        printf "(s)election/(c)urrent? [default=c] "
+        read -r resp__
+
+        if [ "$resp__" = "s" ]; then
+            return 0
+        else
+            return 1
+        fi
+    fi
+}

plugins/.ntfy

@@ -0,0 +1,22 @@
+#!/usr/bin/env sh
+
+# Description: Show a notification
+#
+# Details: nnn invokes this plugin to show notification when a cp/mv/rm operation is complete.
+#
+# Dependencies: notify-send (Ubuntu)/ntfy (https://github.com/dschep/ntfy)/osascript (macOS)/notify (Haiku)
+#
+# Shell: POSIX compliant
+# Author: Anna Arad
+
+OS="$(uname)"
+
+if type notify-send >/dev/null 2>&1; then
+    notify-send nnn "Done!"
+elif [ "$OS" = "Darwin" ]; then
+    osascript -e 'display notification "Done!" with title "nnn"'
+elif type ntfy >/dev/null 2>&1; then
+    ntfy -t nnn send "Done!"
+elif [ "$OS" = "Haiku" ]; then
+    notify --title "nnn" "Done!"
+fi

plugins/README.md

@@ -0,0 +1,383 @@
+<h1 align="center">nnn plugins</h1>
+
+<p align="center"><img src="https://i.imgur.com/SpT0L2W.png" /></p>
+<p align="center"><i>read ebooks with plugin gutenread (Android)</i></p>
+
+## Introduction
+
+Plugins extend the capabilities of `nnn`. They are _executable_ scripts (or binaries) `nnn` can communicate with and trigger. This mechanism fits perfectly with the fundamental design to keep the core file manager lean and fast, by delegating repetitive (but not necessarily file manager-specific) tasks to the plugins which can be run with custom hotkeys.
+
+`nnn` is _**language-agnostic**_ when it comes to plugins. You can write a plugin in any (scripting) language you are comfortable in!
+
+## List of plugins
+
+| Plugin (a-z) | Description [Clears selection<sup>1</sup>] | Lang | Dependencies |
+| --- | --- | --- | --- |
+| [autojump](autojump) | Navigate to dir/path | sh | [jump](https://github.com/gsamokovarov/jump)/autojump/<br>zoxide/z/[z.lua](https://github.com/skywind3000/z.lua) |
+| [boom](boom) | Play random music from dir | sh | [moc](http://moc.daper.net/) |
+| [bulknew](bulknew) | Create multiple files/dirs at once | bash | sed, xargs, mktemp |
+| [cbcopy-mac](cbcopy-mac) | Copy the hovered file to MacOS clipboard | applescript | macos |
+| [cbpaste-mac](cbpaste-mac) | Pastes files from MacOS clipboard into currect directory | macos |
+| [cdpath](cdpath) | `cd` to the directory from `CDPATH` | sh | fzf |
+| [chksum](chksum) | Create and verify checksums [✓] | sh | md5sum,<br>sha256sum |
+| [cmusq](cmusq) | Queue/play files/dirs in cmus player [✓] | sh | cmus, pgrep |
+| [diffs](diffs) | Diff for selection (limited to 2 for directories) [✓] | sh | vimdiff, mktemp |
+| [dragdrop](dragdrop) | Drag/drop files from/into nnn | sh | [dragon](https://github.com/mwh/dragon) |
+| [dups](dups) | List non-empty duplicate files in current dir | bash | find, md5sum,<br>sort uniq xargs |
+| [finder](finder) | Run custom find command (**stored in histfile**) and list | sh | - |
+| [fixname](fixname) | Clean filename to be more shell-friendly [✓] | bash | sed |
+| [fzcd](fzcd) | Fuzzy search multiple dirs (or `$PWD`) and visit file | sh | fzf, (find) |
+| [fzhist](fzhist) | Fuzzy-select a cmd from history, edit in `$EDITOR` and run | sh | fzf, mktemp |
+| [fzopen](fzopen) | Fuzzy find file(s) in subtree to edit/open/pick | sh | fzf, xdg-open/open |
+| [fzplug](fzplug) | Fuzzy find, preview and run other plugins | sh | fzf |
+| [getplugs](getplugs) | Update plugins to installed `nnn` version | sh | curl |
+| [gitroot](gitroot) | Cd to the root of current git repo | sh | git |
+| [gpge](gpge) | Encrypt/decrypt files using GPG [✓] | sh | gpg |
+| [gutenread](gutenread) | Browse, download, read from Project Gutenberg | sh | curl, unzip, w3m<br>[epr](https://github.com/wustho/epr) (optional) |
+| [gsconnect](gsconnect) | GNOME's implementation of kdeconnect [✓] | sh | gsconnect |
+| [imgresize](imgresize) | Batch resize images in dir to screen resolution | sh | [imgp](https://github.com/jarun/imgp) |
+| [imgur](imgur) | Upload an image to imgur (from [imgur-screenshot](https://github.com/jomo/imgur-screenshot)) | bash | - |
+| [imgview](imgview) | View (thumbnail)images, set wallpaper, [rename](https://github.com/jarun/nnn/wiki/Basic-use-cases#browse-rename-images) and [more](https://wiki.archlinux.org/index.php/Sxiv#Assigning_keyboard_shortcuts)| sh | _see in-file docs_ |
+| [ipinfo](ipinfo) | Fetch external IP address and whois information | sh | curl, whois |
+| [kdeconnect](kdeconnect) | Send selected files to an Android device [✓] | sh | kdeconnect-cli |
+| [launch](launch) | GUI application launcher | sh | fzf |
+| [mimelist](mimelist) | List files by mime in subtree | sh | file/mimetype |
+| [moclyrics](moclyrics) | Show lyrics of the track playing in moc | sh | [ddgr](https://github.com/jarun/ddgr), [moc](http://moc.daper.net/) |
+| [mocq](mocq) | Queue/play selection/dir/file in moc [✓] | sh | [moc](http://moc.daper.net/) |
+| [mp3conv](mp3conv) | Extract audio from multimedia as mp3 | sh | ffmpeg |
+| [mtpmount](mtpmount) | Toggle mount of MTP device (eg. Android) | sh | gvfs-mtp |
+| [nbak](nbak) | Backs up `nnn` config | sh | tar, awk, mktemp |
+| [nmount](nmount) | Toggle mount status of a device as normal user | sh | pmount (optional), udisks2 |
+| [nuke](nuke) | Sample file opener (CLI-only by default) | sh | _see in-file docs_ |
+| [oldbigfile](oldbigfile) | List large files by access time | sh | find, sort |
+| [openall](openall) | Open selected files together or one by one [✓] | bash | - |
+| [organize](organize) | Auto-organize files in directories by file type [✓] | sh | file |
+| [pdfread](pdfread) | Read a PDF or text file aloud | sh | pdftotext, mpv,<br>pico2wave |
+| [preview-tabbed](preview-tabbed) | Preview files with Tabbed/xembed | bash | _see in-file docs_ |
+| [preview-tui](preview-tui) | Preview with Tmux/kitty/[QuickLook](https://github.com/QL-Win/QuickLook)/xterm/`$TERMINAL` | sh | _see in-file docs_ |
+| [pskill](pskill) | Fuzzy list by name and kill process or zombie | sh | fzf, ps, sudo/doas |
+| [renamer](renamer) | Batch rename selection or files in dir [✓] | sh | [qmv](https://www.nongnu.org/renameutils/)/[vidir](https://joeyh.name/code/moreutils/) |
+| [ringtone](ringtone) | Create a variable bitrate mp3 ringtone from file | sh | date, ffmpeg |
+| [rsynccp](rsynccp) | Gives copy-paste verbose progress percentage [✓] | sh | rsync |
+| [splitjoin](splitjoin) | Split file or join selection [✓] | sh | split, cat |
+| [suedit](suedit) | Edit file using superuser permissions | sh | sudoedit/sudo/doas |
+| [togglex](togglex) | Toggle executable mode for selection [✓] | sh | chmod |
+| [umounttree](umounttree) | Unmount a remote mountpoint from within | sh | fusermount |
+| [upload](upload) | Upload to Firefox Send or ix.io (text) or file.io (bin) | sh | [ffsend](https://github.com/timvisee/ffsend), curl, jq, tr |
+| [wallpaper](wallpaper) | Set wallpaper or change colorscheme | sh | nitrogen/pywal |
+| [x2sel](x2sel) | Copy file list from system clipboard to selection | sh | _see in-file docs_ |
+| [xdgdefault](xdgdefault) | Set the default app for the hovered file type | sh | xdg-utils, fzf/dmenu |
+
+Notes:
+
+1. A plugin has to explicitly request `nnn` to clear the selection e.g. after operating on the selected files.
+2. Files starting with a dot in the `plugins` directory are internal files and should not be used as plugins.
+
+### Table of contents
+
+- [Installation](#installation)
+- [Configuration](#configuration)
+  - [Skip directory refresh after running a plugin](#skip-directory-refresh-after-running-a-plugin--)
+- [Running commands as plugin](#running-commands-as-plugin-)
+  - [Skip user confirmation after command execution](#skip-user-confirmation-after-command-execution-)
+  - [Run a GUI app as plugin](#run-a-gui-app-as-plugin-)
+  - [Page non-interactive command output](#page-non-interactive-command-output-)
+  - [Some useful key-command examples](#some-useful-key-command-examples)
+- [Access level of plugins](#access-level-of-plugins)
+- [Create your own plugins](#create-your-own-plugins)
+  - [Send data to `nnn`](#send-data-to-nnn)
+  - [Get notified on file hover](#get-notified-on-file-hover)
+- [Examples](#examples)
+- [Contributing plugins](#contributing-plugins)
+
+## Installation
+
+The following command installs or updates (after backup) all plugins:
+
+```sh
+sh -c "$(curl -Ls https://raw.githubusercontent.com/jarun/nnn/master/plugins/getplugs)"
+```
+
+Plugins are installed to `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins`.
+
+## Configuration
+
+Set environment variable `NNN_PLUG` to assign keybinds and invoke plugins directly using the plugin shortcut (<kbd>;</kbd>) followed by the assigned key character. E.g., with the below config:
+
+```sh
+export NNN_PLUG='f:finder;o:fzopen;p:mocq;d:diffs;t:nmount;v:imgview'
+```
+
+plugin `finder` can be invoked with the keybind <kbd>;f</kbd>, `fzopen` can be run with <kbd>;o</kbd> and so on... The key vs. plugin pairs are shown in the help and config screen.
+
+Alternatively, combine with <kbd>Alt</kbd> (i.e. <kbd>Alt+key</kbd>).
+
+To pick and run an unassigned plugin, press <kbd>Enter</kbd> (to _enter_ the plugin dir) at the plugin prompt.
+
+To run a plugin at startup, use the option `-P` followed by the plugin key.
+
+If the plugins list gets too long, try breaking them up into sections:
+
+```
+NNN_PLUG_PERSONAL='g:personal/convert2zoom;p:personal/echo'
+NNN_PLUG_WORK='j:work/prettyjson;d:work/foobar'
+NNN_PLUG_INLINE='e:!go run "$nnn"*'
+NNN_PLUG_DEFAULT='1:ipinfo;p:preview-tui;o:fzz;b:nbak'
+NNN_PLUG="$NNN_PLUG_PERSONAL;$NNN_PLUG_WORK;$NNN_PLUG_DEFAULT;$NNN_PLUG_INLINE"
+export NNN_PLUG
+```
+
+Note:
+- `'g:personal/convert2zoom'` will look in the personal sub-folder inside the plugin folder.
+- `'b:boom;b:bulknew` will result in only the first definition of *b* (`b:boom`) being used.
+- A keybinding definition of more than 1 character will prevent nnn from starting.
+
+
+#### Skip directory refresh after running a plugin [`-`]
+
+`nnn` refreshes the directory after running a plugin to reflect any changes by the plugin. To disable this add a `-` before the plugin name:
+
+```sh
+export NNN_PLUG='p:-plugin'
+```
+
+## Running commands as plugin [`!`]
+
+To assign keys to arbitrary non-background cli commands and invoke like plugins, add `!` before the command.
+
+```sh
+export NNN_PLUG='x:!chmod +x "$nnn";g:!git log;s:!smplayer "$nnn"'
+```
+
+Now <kbd>;x</kbd> can be used to make a file executable, <kbd>;g</kbd> can be used to the git log of a git project directory, <kbd>;s</kbd> can be used to preview a partially downloaded media file.
+
+#### Skip user confirmation after command execution [`*`]
+
+`nnn` waits for user confirmation (the prompt `Press Enter to continue`) after it executes a command as plugin (unlike plugins which can add a `read` to wait). To skip this, add a `*` after the command.
+
+```sh
+export NNN_PLUG='s:!smplayer "$nnn"*;n:-!vim /home/vaio/Dropbox/Public/synced_note*'
+```
+
+Now there will be no prompt after <kbd>;s</kbd> and <kbd>;n</kbd>.
+
+Note: Do not use `*` with programs that run and exit e.g. cat.
+
+#### Run a GUI app as plugin [`&`]
+
+To run a GUI app as plugin, add a `&` after `!`.
+
+```sh
+export NNN_PLUG='m:-!&mousepad "$nnn"'
+```
+
+#### Page non-interactive command output [`|`]
+
+To show the output of run-and-exit commands which do not need user input, add `|` (pipe) after `!`.
+
+```sh
+export NNN_PLUG='m:-!|mediainfo "$nnn";t:-!|tree -ps;l:-!|ls -lah --group-directories-first'
+```
+
+This option is incompatible with `&` (terminal output is masked for GUI programs) and ignores `*` (output is already paged for user).
+
+Notes:
+1. Place `$nnn` (or exported variables) in double quotes (**`"$nnn"`**)
+2. Use single quotes for `$NNN_PLUG` so `"$nnn"` is not interpreted
+3. (_Again_) add `!` before the command
+4. To disable directory refresh after running a _command as plugin_, prefix with `-!`
+
+#### Some useful key-command examples
+
+| Key:Command | Description |
+|---|---|
+| `c:!convert "$nnn" png:- \| xclip -sel clipboard -t image/png*` | Copy image to clipboard |
+| `C:!cp -rv "$nnn" "$nnn".cp` | Create a copy of the hovered file |
+| `e:-!sudo -E vim "$nnn"*` | Edit file as root in vim |
+| `g:-!git diff` | Show git diff |
+| `h:-!hx "$nnn"*` | Open hovered file in [hx](https://github.com/krpors/hx) hex editor |
+| `k:-!fuser -kiv "$nnn"*` | Interactively kill process(es) using hovered file |
+| `l:-!git log` | Show git log |
+| `n:-!vi /home/user/Dropbox/dir/note*` | Take quick notes in a synced file/dir of notes |
+| `p:-!less -iR "$nnn"*` | Page through hovered file in less |
+| `s:-!&smplayer -minigui "$nnn"` | Play hovered media file, even unfinished download |
+| `x:!chmod +x "$nnn"` | Make the hovered file executable |
+| `y:-!sync*` | Flush cached writes |
+
+## Access level of plugins
+
+When `nnn` executes a plugin, it does the following:
+- Changes to the directory where the plugin is to be run (`$PWD` pointing to the active directory)
+- Passes three arguments to the script:
+    1. `$1`: The hovered file's name.
+    2. `$2`: The working directory (might differ from `$PWD` in case of symlinked paths; non-canonical).
+    3. `$3`: The picker mode output file (`-` for stdout) if `nnn` is executed as a file picker.
+- Sets the environment variable `NNN_PIPE` used to control `nnn` active directory.
+- Sets the environment variable `NNN_INCLUDE_HIDDEN` to `1` if hidden files are active, `0` otherwise.
+- Sets the environment variable `NNN_PREFER_SELECTION` to `1` if user prefers to use selection (see nnn's `-u` flag), `0` otherwise.
+- Exports the [special variables](https://github.com/jarun/nnn/wiki/Concepts#special-variables).
+
+Plugins can also read the `.selection` file in the config directory.
+
+## Create your own plugins
+
+Plugins can be written in any scripting language. However, POSIX-compliant shell scripts runnable in `sh` are preferred.
+
+**Make the file executable**. Drop it in the plugin directory. Optionally add a hotkey in `$NNN_PLUG` for frequent usage.
+
+#### Send data to `nnn`
+`nnn` provides a mechanism for plugins to send data to `nnn` to control its active directory or invoke the list mode.
+The way to do so is by writing to the pipe pointed by the environment variable `NNN_PIPE`.
+The plugin should write a single string in the format `(<->)<ctxcode><opcode><data>` without a newline at the end. For example, `1c/etc`.
+
+The optional `-` at the **beginning of the stream** instructs `nnn` to clear the selection.
+In cases where the data transfer to `nnn` has to happen while the selection file is being read (e.g. in a loop), the plugin should
+create a tmp copy of the selection file, inform `nnn` to clear the selection and then do the subsequent processing with the tmp file.
+A paged [`|`] or GUI [`&`] cmd run as plugin cannot clear selection.
+
+The `ctxcode` indicates the context to change the active directory of.
+
+| Context code | Meaning |
+|:---:| --- |
+| `+` | smart context (next inactive else current) |
+| `0` | current context |
+| `1`-`4` | context number |
+
+The `opcode` indicates the operation type.
+
+| Opcode | Operation |
+|:---:| --- |
+| `c` | change directory |
+| `l` | list files in list mode |
+| `p` | picker file overwritten |
+
+For convenience, we provided a helper script named `.nnn-plugin-helper` and a function named `nnn_cd` to ease this process. `nnn_cd` receives the path to change to as the first argument, and the context as an optional second argument.
+If a context is not provided, it is asked for explicitly. To skip this and choose the current context, set the `CUR_CTX` variable in `.nnn-plugin-helper` (or in the specific plugin after sourcing `.nnn-plugin-helper`) to 1.
+Usage examples can be found in the Examples section below.
+
+#### Get notified on file hover
+
+If `NNN_FIFO` is set, `nnn` will open it and write every hovered files. This can be used in plugins and external scripts, e.g. to implement file previews.
+
+Don't forget to fork in the background to avoid blocking `nnn`.
+
+For more details on configuration and usage of the preview plugins, visit [Live Previews](https://github.com/jarun/nnn/wiki/Live-previews).
+
+## Examples
+
+There are many plugins provided by `nnn` which can be used as examples. Here are a few simple selected examples.
+
+#### Show the git log of changes to the particular file along with the code for a quick and easy review.
+
+```sh
+#!/usr/bin/env sh
+
+git log -p -- "$1"
+```
+
+#### Change to directory in clipboard using helper script
+
+```sh
+#!/usr/bin/env sh
+
+. $(dirname $0)/.nnn-plugin-helper
+
+nnn_cd "$(xsel -ob)"
+```
+
+#### Change directory to the location of a link using helper script with specific context (current)
+
+```sh
+#!/usr/bin/env sh
+
+. $(dirname $0)/.nnn-plugin-helper
+
+nnn_cd "$(dirname $(readlink -fn $1))" 0
+```
+
+#### Change to arbitrary directory without helper script
+
+```sh
+#!/usr/bin/env sh
+
+printf "cd to: "
+read -r dir
+
+printf "%s" "0c$dir" > "$NNN_PIPE"
+```
+
+#### Send every hovered file to X selection
+
+```sh
+#!/usr/bin/env sh
+
+if [ -z "$NNN_FIFO" ] ; then
+    exit 1
+fi
+
+while read FILE ; do
+    printf "%s" "$FILE" | xsel
+done < "$NNN_FIFO" &
+disown
+```
+
+#### Quick `find` the first match in subtree and open in `nuke`
+
+```sh
+#!/usr/bin/env sh
+
+NUKE="${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins/nuke"
+
+printf "file name: "
+read -r pattern
+
+entry=$(find . -type f -iname "$pattern" -print -quit 2>/dev/null)
+
+if [ -n "$entry" ]; then
+    "$NUKE" "$entry"
+fi
+```
+
+#### Quick find (using `fd`)
+
+```sh
+#!/usr/bin/env sh
+
+. "$(dirname "$0")"/.nnn-plugin-helper
+
+printf "pattern: "
+read -r pattern
+
+if [ -n "$pattern" ]; then
+    printf "%s" "+l" > "$NNN_PIPE"
+    eval "fd -HI $pattern -0" > "$NNN_PIPE"
+fi
+```
+
+#### Quick grep (using `rg`)
+
+```sh
+#!/usr/bin/env sh
+
+. "$(dirname "$0")"/.nnn-plugin-helper
+
+printf "pattern: "
+read -r pattern
+
+if [ -n "$pattern" ]; then
+    printf "%s" "+l" > "$NNN_PIPE"
+    eval "rg -l0 --hidden -S $pattern" > "$NNN_PIPE"
+fi
+```
+
+#### Change directory
+
+    NNN_PLUG='c:!read -r to && [ -n "$to" ] && printf "0c%s" "${to}" > "$NNN_PIPE"*'
+
+## Contributing plugins
+
+1. Add informative sections like _Description_, _Notes_, _Dependencies_, _Shell_, _Author_ etc. in the plugin.
+2. Add an entry in the table above. Note that the list is alphabetically ordered by plugin name.
+3. Keep non-portable commands (like `notify-send`) commented so users from any other OS/DE aren't surprised.
+4. The plugin file should be executable.
+5. If your plugin stores data, use `${XDG_CACHE_HOME:-$HOME/.cache}/nnn`. Document it _in-file_.

plugins/autojump

@@ -0,0 +1,74 @@
+#!/usr/bin/env sh
+
+# Description: Navigate to directory using jump/autojump/zoxide/z
+#
+# Dependencies:
+#   - jump - https://github.com/gsamokovarov/jump
+#   - OR autojump - https://github.com/wting/autojump
+#   - OR zoxide - https://github.com/ajeetdsouza/zoxide
+#   - OR z - https://github.com/rupa/z (z requires fzf)
+#   - OR z (fish) - https://github.com/jethrokuan/z (z requires fzf)
+#   - OR z.lua - https://github.com/skywind3000/z.lua (z.lua can enhanced with fzf)
+#
+# Note: The dependencies STORE NAVIGATION PATTERNS
+#
+# to make z.lua work, you need to set $NNN_ZLUA to the path of script z.lua
+#
+# Shell: POSIX compliant
+# Authors: Marty Buchaus, Dave Snider, Tim Adler, Nick Waywood
+
+if [ ! -p "$NNN_PIPE" ]; then
+    printf 'ERROR: NNN_PIPE is not set!'
+    read -r _
+    exit 2
+fi
+
+if type jump >/dev/null 2>&1; then
+    printf "jump to : "
+    IFS= read -r line
+    # shellcheck disable=SC2086
+    odir="$(jump cd ${line})"
+    printf "%s" "0c$odir" > "$NNN_PIPE"
+elif type autojump >/dev/null 2>&1; then
+    printf "jump to : "
+    read -r dir
+    odir="$(autojump "$dir")"
+    printf "%s" "0c$odir" > "$NNN_PIPE"
+elif type zoxide >/dev/null 2>&1; then
+    if type fzf >/dev/null 2>&1; then
+    	odir="$(zoxide query -i --)"
+    	printf "%s" "0c$odir" > "$NNN_PIPE"
+    else
+	printf "jump to : "
+    	read -r dir
+    	odir="$(zoxide query -- "$dir")"
+    	printf "%s" "0c$odir" > "$NNN_PIPE"
+    fi
+elif type lua >/dev/null 2>&1 && [ -n "$NNN_ZLUA" ]; then
+    printf "jump to : "
+    read -r line
+    if type fzf >/dev/null 2>&1; then
+        odir="$(lua "$NNN_ZLUA" -l "$line" | fzf --nth 2.. --reverse --inline-info --tac +s -e --height 35%)"
+        printf "%s" "0c$(echo "$odir" | awk '{print $2}')" > "$NNN_PIPE"
+    else
+        odir="$(lua "$NNN_ZLUA" -e "$line")"
+        printf "%s" "0c$odir" > "$NNN_PIPE"
+    fi
+else
+    # rupa/z uses $_Z_DATA, jethrokuan/z (=port of z for fish) uses $Z_DATA
+    datafile="${_Z_DATA:-${Z_DATA:-$HOME/.z}}"
+    if type fzf >/dev/null 2>&1 && [ -f "$datafile" ]; then
+        # Read the data from z's file instead of calling
+        # z so the data doesn't need to be processed twice
+        sel=$(awk -F "|" '{print $1}' "$datafile" | fzf | awk '{$1=$1};1')
+
+        # NOTE: Uncomment this line and comment out the line above if
+        # you want to see the weightings of the dir's in the fzf pane
+        # sel=$(awk -F "|" '{printf "%s %s\n", $2, $1}' "$datafile" | fzf | sed 's/^[0-9,.]* *//' | awk '{$1=$1};1')
+
+        printf "%s" "0c$sel" > "$NNN_PIPE"
+    else
+        printf "No supported autojump script [jump/autojump/zoxide/z (needs fzf)] found"
+        read -r _
+    fi
+fi

plugins/boom

@@ -0,0 +1,50 @@
+#!/usr/bin/env sh
+
+# Description: Play random music (MP3, FLAC, M4A, WEBM, WMA) from current dir.
+#
+# Dependencies: mocp (or custom)
+#
+# Note: You may want to set GUIPLAYER.
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+GUIPLAYER="${GUIPLAYER:-""}"
+NUMTRACKS="${NUMTRACKS:-100}"
+
+if [ -n "$GUIPLAYER" ]; then
+    find . -type f \( -iname "*.mp3" -o -iname "*.flac" -o -iname "*.m4a" -o -iname "*.webm" -o -iname "*.wma" \) | shuf -n "$NUMTRACKS" | xargs -d "\n" "$GUIPLAYER" > /dev/null 2>&1 &
+
+    # detach the player
+    sleep 1
+elif type mocp >/dev/null 2>&1; then
+    cmd=$(pgrep -x mocp 2>/dev/null)
+    ret=$cmd
+
+    if [ -z "$ret" ]; then
+        # start MOC server
+        mocp -S
+        mocp -o shuffle
+    else
+        # mocp running, check if it's playing
+        state=$(mocp -i | grep "State:" | cut -d' ' -f2)
+        if [ "$state" = 'PLAY' ]; then
+            # add up to 100 random audio files
+            find . -type f \( -iname "*.mp3" -o -iname "*.flac" -o -iname "*.m4a" -o -iname "*.webm" -o -iname "*.wma" \) | head -n "$NUMTRACKS" | xargs -d "\n" mocp -a
+            exit
+        fi
+    fi
+
+    # clear MOC playlist
+    mocp -c
+    mocp -o shuffle
+
+    # add up to 100 random audio files
+    find . -type f \( -iname "*.mp3" -o -iname "*.flac" -o -iname "*.m4a" -o -iname "*.webm" -o -iname "*.wma" \) | head -n "$NUMTRACKS" | xargs -d "\n" mocp -a
+
+    # start playing
+    mocp -p
+else
+    printf "moc missing"
+    read -r _
+fi

plugins/bulknew

@@ -0,0 +1,32 @@
+#!/usr/bin/env sh
+
+# Description: Allows for creation of multiple files/dirs simultaneously
+#              Creates a tmp file to write each entry in a separate line
+#
+# Note: Only relative paths are supported. Absolute paths are ignored
+#       Leading and trailing whitespace in path names is also ignored
+#
+# Shell: POSIX compliant
+# Author: KlzXS
+
+EDITOR="${EDITOR:-vi}"
+TMPDIR="${TMPDIR:-/tmp}"
+
+printf "'f'ile / 'd'ir? "
+read -r resp
+
+if [ "$resp" = "f" ]; then
+	#shellcheck disable=SC2016
+	cmd='mkdir -p "$(dirname "{}")" && touch "{}"'
+elif [ "$resp" = "d" ]; then
+	cmd='mkdir -p {}'
+else
+	exit 1
+fi
+
+tmpfile=$(mktemp "$TMPDIR/.nnnXXXXXX")
+$EDITOR "$tmpfile"
+
+sed "/^\//d" "$tmpfile" | xargs -n1 -I{} sh -c "$cmd"
+
+rm -- "$tmpfile"

plugins/cbcopy-mac

@@ -0,0 +1,16 @@
+#!/usr/bin/osascript
+
+# Description: Copy the hovered file to MacOS clipboard.
+#
+# Note: Supports only MacOS
+#
+# Shell: POSIX compliant
+# Author: Syed Umar Anis
+
+
+on run args
+  set filePath to (second item of args & "/" & first item of args)
+  tell application "Finder" 
+    set the clipboard to (filePath as POSIX file)
+  end tell
+end

plugins/cbpaste-mac

@@ -0,0 +1,24 @@
+#!/usr/bin/env sh
+# shellcheck disable=all
+
+# Description: Paste the clipboard files into the current directory.
+#              Only works if clipboard contents are files.
+#
+# Note: Supports only MacOS
+#
+# Shell: POSIX compliant
+# Author: Syed Umar Anis
+
+
+fs=($( osascript -e "use framework \"Foundation\"
+    property this : a reference to the current application
+    property NSPasteboard : a reference to NSPasteboard of this
+    property NSURL : a reference to NSURL of this
+    property pb : a reference to NSPasteboard's generalPasteboard
+
+    property text item delimiters : linefeed
+
+    pb's readObjectsForClasses:[NSURL] options:[]
+    (result's valueForKey:\"path\") as list as text" ))
+
+cp -R -- "${fs[@]}" "$2/"

plugins/cdpath

@@ -0,0 +1,56 @@
+#!/usr/bin/env sh
+
+# Description: 'cd' to the directory from CDPATH
+#
+# Details: If the CDPATH environment variable is not set, the default value of
+#          ${XDG_CONFIG_HOME:-$HOME/.config}/nnn/bookmarks will be used.
+#          You can create this directory and fill it with symbolic links to your
+#          favorite directories. It's a good idea to add it to CDPATH so that it
+#          could also be used from the command line outside of nnn.
+#          The fzf search is done on the directory basename (the first column).
+#
+#          This plugin is an extended version of the bookmarks plugin.
+#          If you set your CDPATH to ${XDG_CACHE_HOME:-$HOME/.cache}/nnn/bookmarks
+#          or to the value of BOOKMARKS_DIR, you can use it as a bookmarks replacement.
+#
+# Shell: POSIX compliant
+# Author: Yuri Kloubakov
+
+# shellcheck disable=SC1090,SC1091
+. "$(dirname "$0")"/.nnn-plugin-helper
+
+# Get a list of (symbolic links to) directories for every element of CDPATH
+get_dirs() {
+    IFS=':'
+    for path in $CDPATH; do
+        for entry in "$path"/*; do
+            if [ -d "$entry" ]; then
+                name=$(basename "$entry" | grep -o '^.\{1,24\}')
+                if [ -h "$entry" ]; then
+                    slink=$(ls -dl -- "$entry")
+                    entry=${slink#*" $entry -> "}
+                fi
+                printf "%-24s :%s\n" "${name}" "$entry"
+            fi
+        done
+    done
+}
+
+abort() {
+    echo "$1"
+    read -r _
+    exit 1
+}
+
+if [ -z "$CDPATH" ]; then
+    CDPATH="${XDG_CONFIG_HOME:-$HOME/.config}/nnn/bookmarks"
+    [ -d "$CDPATH" ] || abort "CDPATH is not set and there is no \"$CDPATH\" directory"
+fi
+
+dir_list=$(get_dirs)
+[ -n "$dir_list" ] || abort "There are no directories to choose from. Check your \"$CDPATH\"."
+
+dir=$(echo "$dir_list" | fzf --nth=1 --delimiter=':' | awk -F: 'END { print $2 }')
+if [ -n "$dir" ]; then
+    nnn_cd "$dir" 0
+fi

plugins/chksum

@@ -0,0 +1,75 @@
+#!/usr/bin/env sh
+
+# Description: Create and verify checksums
+#
+# Note:  On macOS, install the relevant checksum packages from Homebrew with:
+#            brew install coreutils
+#
+# Details:
+#   - selection: it will generate one file with the checksums and filenames
+#                (and with paths if they are in another directory)
+#                output checksum filename format: checksum_timestamp.checksum_type
+#   - file: if the file is a checksum, the plugin does the verification
+#           if the file is not a checksum, checksum will be generated for it
+#           the output checksum filename will be filename.checksum_type
+#   - directory: recursively calculates checksum for all the files in the dir
+#                the output checksum filename will be directory.checksum_type
+#
+# Shell: POSIX compliant
+# Authors: ath3, Arun Prakash Jana
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+resp=f
+chsum=md5
+
+checksum_type()
+{
+    echo "possible checksums: md5, sha1, sha224, sha256, sha384, sha512"
+    printf "create md5 (m), sha256 (s), sha512 (S) (or type one of the above checksums) [default=m]: "
+    read -r chsum_resp
+    for chks in md5 sha1 sha224 sha256 sha384 sha512
+    do
+        if [ "$chsum_resp" = "$chks" ]; then
+            chsum=$chsum_resp
+            return
+        fi
+    done
+    if [ "$chsum_resp" = "s" ]; then
+        chsum=sha256
+    elif [ "$chsum_resp" = "S" ]; then
+        chsum=sha512
+    fi
+}
+
+if [ -s "$selection" ]; then
+    printf "work with selection (s) or current file (f) [default=f]: "
+    read -r resp
+fi
+
+if [ "$resp" = "s" ]; then
+    checksum_type
+    sed 's|'"$PWD/"'||g' < "$selection" | xargs -0 -I{} ${chsum}sum {} > "checksum_$(date '+%Y%m%d%H%M').$chsum"
+
+    # Clear selection
+    if [ -p "$NNN_PIPE" ]; then
+        printf "-" > "$NNN_PIPE"
+    fi
+elif [ -n "$1" ]; then
+    if [ -f "$1" ]; then
+        for chks in md5 sha1 sha224 sha256 sha384 sha512
+        do
+            if echo "$1" | grep -q \.${chks}$; then
+                ${chks}sum -c < "$1"
+                read -r _
+                exit
+            fi
+        done
+        checksum_type
+        file=$(basename "$1").$chsum
+        ${chsum}sum "$1" > "$file"
+    elif [ -d "$1" ]; then
+        checksum_type
+        file=$(basename "$1").$chsum
+        find "$1" -type f -exec ${chsum}sum "{}" + > "$file"
+    fi
+fi

plugins/cmusq

@@ -0,0 +1,80 @@
+#!/usr/bin/env sh
+
+# Description: Add selection or hovered file/directory to cmus queue
+#
+# Dependencies: cmus, pgrep, xdotool (optional)
+#
+# Notes:
+#   1. If adding selection, files/dirs are added in the same order they were selected in nnn
+#   2. A new window will be opened if cmus is not running already, playback will start immediately
+#   3. If cmus is already running, files will be appended to the queue with no forced playback
+#
+# TODO:
+#   1. Add cava and cmus-lyrics as optional dependencies
+#   2. Start cava and/or cmus-lyrics in tmux or kitty panes next to cmus
+#
+# Shell: POSIX compliant
+# Author: Kabouik
+
+# (Optional) Set preferred terminal emulator for cmus if not set in your env,
+# or leave commented out to use OS default
+#TERMINAL="kitty"
+
+if ! type cmus >/dev/null; then
+    printf "cmus missing"
+    read -r _
+    exit 1
+fi
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+
+start_cmus() {
+    type xdotool >/dev/null && nnnwindow="$(xdotool getactivewindow)"
+    case "$TERMINAL" in
+        kitty | gnome-terminal | st)
+            nohup "$TERMINAL" -- cmus & ;;
+        havoc)
+            nohup "$TERMINAL" cmus & ;;
+        "")
+            nohup x-terminal-emulator -e cmus & ;;
+        *)
+            nohup "$TERMINAL" -e cmus & ;;
+    esac
+    # Give the new terminal some time to open
+    until cmus-remote -C; do sleep 0.1; done
+    [ -n "$nnnwindow" ] && xdotool windowactivate "$nnnwindow"
+} >/dev/null 2>&1
+
+fill_queue() {
+  if [ "$REPLY" = "s" ]; then
+      xargs < "$selection" -0 cmus-remote -q
+  elif [ -n "$1" ]; then
+      cmus-remote -q "$1"
+  fi
+}
+
+# If active selection,then ask what to do
+if [ -s "$selection" ]; then
+    printf "Queue [s]election or [c]urrently hovered? [default=c]: "
+    read -r REPLY
+fi
+
+# If cmus is not running, start and play queue
+if ! pgrep cmus >/dev/null; then
+    printf "cmus is not running, starting it in a new %s window.\n" "$TERMINAL"
+    start_cmus
+    fill_queue "$1"
+    cmus-remote -p
+    printf "Files added to cmus queue.\n"
+else # Append to existing queue if cmus is already running
+    fill_queue "$1"
+    printf "Files appended to current cmus queue.\n"
+fi
+
+# Change view
+cmus-remote -C "view 4"
+
+# Clear selection
+if [ -p "$NNN_PIPE" ]; then
+    printf "-" > "$NNN_PIPE"
+fi

plugins/diffs

@@ -0,0 +1,62 @@
+#!/usr/bin/env sh
+
+# Description: Show diff of 2 directories or multiple files in vimdiff
+#
+# Notes:
+#   1. vim may show the warning: 'Vim: Warning: Input is not from a terminal'
+#      press 'Enter' to ignore and proceed.
+#   2. if only one file is in selection, the hovered file is considered as the
+#      second file to diff with
+#
+# Shell: POSIX compliant
+# Authors: Arun Prakash Jana, ath3
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+
+if type nvim >/dev/null 2>&1; then
+    diffcmd="nvim -d"
+else
+    diffcmd="vimdiff +0"
+fi
+
+dirdiff() {
+    dir1=$(mktemp "${TMPDIR:-/tmp}"/nnn-"$(basename "$1")".XXXXXXXX)
+    dir2=$(mktemp "${TMPDIR:-/tmp}"/nnn-"$(basename "$2")".XXXXXXXX)
+    ls -A1 "$1" > "$dir1"
+    ls -A1 "$2" > "$dir2"
+    $diffcmd "$dir1" "$dir2"
+    rm -- "$dir1" "$dir2"
+}
+
+if [ -s "$selection" ]; then
+    arr=$(tr '\0' '\n' < "$selection")
+    if [ "$(echo "$arr" | wc -l)" -gt 1 ]; then
+        f1="$(echo "$arr" | sed -n '1p')"
+        f2="$(echo "$arr" | sed -n '2p')"
+        if [ -d "$f1" ] && [ -d "$f2" ]; then
+            dirdiff "$f1" "$f2"
+        else
+            # If xargs supports the -o option, use it to get rid of:
+            #     Vim: Warning: Input is not from a terminal
+            # xargs -0 -o vimdiff < $selection
+
+            eval xargs -0 "$diffcmd" < "$selection"
+        fi
+    elif [ -n "$1" ]; then
+        f1="$(echo "$arr" | sed -n '1p')"
+        if [ -d "$f1" ] && [ -d "$1" ]; then
+            dirdiff "$f1" "$1"
+        elif [ -f "$f1" ] && [ -f "$1" ]; then
+            $diffcmd "$f1" "$1"
+        else
+            echo "cannot compare file with directory"
+        fi
+    else
+        echo "needs at least 2 files or directories selected for comparison"
+    fi
+fi
+
+# Clear selection
+if [ -p "$NNN_PIPE" ]; then
+    printf "-" > "$NNN_PIPE"
+fi

plugins/dragdrop

@@ -0,0 +1,77 @@
+#!/usr/bin/env sh
+
+# Description: Open a Drag and drop window, to drop files onto other programs.
+#              Also provides drag and drop window for files.
+#
+# Dependencies: dragon - https://github.com/mwh/dragon
+#
+# Notes:
+#   1. Files that are dropped will be added to nnn's selection
+#      Some web-based files will be downloaded to current dir
+#      with curl and it may overwrite some existing files
+#   2. The user has to mm to clear nnn's selection first
+#
+# Shell: POSIX compliant
+# Author: 0xACE
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+resp=f
+all=
+if type dragon-drag-and-drop >/dev/null 2>&1; then
+    dnd="dragon-drag-and-drop"
+elif type dragon-drop >/dev/null 2>&1; then
+    dnd="dragon-drop"
+else
+    dnd="dragon"
+fi
+
+add_file ()
+{
+    printf '%s\0' "$@" >> "$selection"
+}
+
+use_all ()
+{
+    printf "mark --all (a) [default=none]: "
+    read -r resp
+    if [ "$resp" = "a" ]; then
+        all="--all"
+    else
+        all=""
+    fi
+}
+
+if [ -s "$selection" ]; then
+    printf "Drop file (r). Drag selection (s), Drag current directory (d) or drag current file (f) [default=f]: "
+    read -r resp
+else
+    printf "Drop file (r). Drag current directory (d) or drag current file (f) [default=f]: "
+    read -r resp
+    if [ "$resp" = "s" ]; then
+        resp=f
+    fi
+fi
+
+if [ "$resp" = "s" ]; then
+    use_all
+    sed -z 's|'"$PWD/"'||g' < "$selection" | xargs -0 "$dnd" "$all" &
+elif [ "$resp" = "d" ]; then
+    use_all
+    "$dnd" "$all" "$PWD/"* &
+elif [ "$resp" = "r" ]; then
+    true > "$selection"
+    "$dnd" --print-path --target | while read -r f
+    do
+            if printf "%s" "$f" | grep '^\(https\?\|ftps\?\|s\?ftp\):\/\/' ; then
+                    curl -LJO "$f"
+                    add_file "$PWD/$(basename "$f")"
+            elif [ -e "$f" ]; then
+                    add_file "$f"
+            fi
+    done &
+else
+    if [ -n "$1" ] && [ -e "$1" ]; then
+        "$dnd" "$1" &
+    fi
+fi
+

plugins/dups

@@ -0,0 +1,70 @@
+#!/usr/bin/env sh
+
+# Description: List non-empty duplicates in the current dir (based on size followed by MD5)
+#
+# Source: https://www.commandlinefu.com/commands/view/3555/find-duplicate-files-based-on-size-first-then-md5-hash
+#
+# Dependencies: find md5sum sort uniq xargs gsed
+#
+# Notes:
+#   1. If the file size exceeds $size_digits digits the file will be misplaced
+#      12 digits fit files up to 931GiB
+#   2. Bash compatible required for mktemp
+#
+# Shell: Bash
+# Authors: syssyphus, KlzXS
+
+EDITOR="${EDITOR:-vi}"
+TMPDIR="${TMPDIR:-/tmp}"
+
+size_digits=12
+tmpfile=$(mktemp "$TMPDIR/.nnnXXXXXX")
+
+printf "\
+## This is an overview of all duplicate files found.
+## Comment out the files you wish to remove. You will be given an option to cancel.
+## Lines with double comments (##) are ignored.
+## You will have the option to remove the files with force or interactively.\n
+" > "$tmpfile"
+
+# shellcheck disable=SC2016
+find . -size +0 -type f -printf "%${size_digits}s %p\n" | sort -rn | uniq -w"${size_digits}" -D | sed -e '
+s/^ \{0,12\}\([0-9]\{0,12\}\) \(.*\)$/printf "%s %s\\n" "$(md5sum "\2")" "d\1"/
+' | tr '\n' '\0' | xargs -0 -n1 sh -c | sort | { uniq -w32 --all-repeated=separate; echo; } | sed -ne '
+h
+s/^\(.\{32\}\).* d\([0-9]*\)$/## md5sum: \1 size: \2 bytes/p
+g
+
+:loop
+N
+/.*\n$/!b loop
+p' | sed -e 's/^.\{32\}  \(.*\) d[0-9]*$/\1/' >> "$tmpfile"
+
+"$EDITOR" "$tmpfile"
+
+printf "Remove commented files? (yes/no) [default=n]: "
+read -r commented
+
+if [ "$commented" = "y" ]; then
+	sedcmd="/^##.*/d; /^[^#].*/d; /^$/d; s/^# *\(.*\)$/\1/"
+else
+	printf "Press any key to exit"
+	read -r _
+	exit
+fi
+
+printf "Remove with force or interactive? (f/i) [default=i]: "
+read -r force
+
+if [ "$force" = "f" ]; then
+	#shellcheck disable=SC2016
+	sed -e "$sedcmd" "$tmpfile" | tr '\n' '\0' | xargs -0 -r sh -c 'rm -f -- "$0" "$@" </dev/tty'
+else
+	#shellcheck disable=SC2016
+	sed -e "$sedcmd" "$tmpfile" | tr '\n' '\0' | xargs -0 -r sh -c 'rm -i -- "$0" "$@" </dev/tty'
+fi
+
+rm -- "$tmpfile"
+
+printf "Press any key to exit"
+read -r _

plugins/finder

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+
+# Description: Run custom search and list results in smart context
+#
+# Note: This plugin retains search history
+#
+# Usage:
+#   Run plugin and enter e.g. "-size +10M" to list files in current
+#   directory larger than 10M. By default entered expressions are
+#   interpreted as arguments to find. Results have to be NUL
+#   terminated which is done by default for find. Alternatively one
+#   can prepend a '$' to run a custom search program such as fd or
+#   ripgrep. Entered expressions will be saved in history file to
+#   be listed as bookmarks and and can be entered by index and edited.
+#
+# Shell: Bash
+# Author: Arun Prakash Jana, Luuk van Baal
+TMPDIR="${TMPDIR:-/tmp}"
+NNN_FINDHIST="${NNN_FINDHIST:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/finderbms}"
+NNN_FINDHISTLEN="${NNN_FINDHISTLEN:-10000}"
+
+printexamples() {
+    printf -- "-maxdepth 1 -name pattern
+-maxdepth 1 -size +100M
+\$fd -0 pattern
+\$fd -0 -d 2 -S +100M
+\$grep -rlZ pattern
+\$rg -l0 pattern
+\$fzf -m | tr '\\\n' '\\\0'\n"
+}
+
+printexprs() {
+    for ((i = "$1"; i < ${#fexprs[@]}; i++)); do
+        printf '%s\t%s\n' "$((i + 1))" "${fexprs[$i]}"
+    done
+}
+
+mapexpr() {
+    if [ "$fexpr" -eq "$fexpr" ] 2>/dev/null; then
+        fexpr=${fexprs[$((fexpr - 1))]}
+        read -r -e -p "Search expression: " -i "$fexpr" fexpr
+    else
+        return 1
+    fi
+}
+
+readexpr() {
+    case "$fexpr" in
+        h)   clear
+             printf "Examples:\n"
+             mapfile -t fexprs < <(printexamples)
+             printexprs 0
+             read -r -p "Search expression or index: " fexpr
+             mapexpr
+             [ -n "$fexpr" ] && readexpr ;;
+        \$*) cmd="${fexpr:1}" ;;
+        *)   mapexpr && readexpr
+             cmd="find . $fexpr -print0" ;;
+    esac
+}
+
+clear
+[ -f "$NNN_FINDHIST" ] || printexamples > "$NNN_FINDHIST"
+
+mapfile -t fexprs < <(sort "$NNN_FINDHIST" | uniq -c | sort -nr | head -n5 |\
+  awk '{for (i=2; i<NF; i++) printf $i " "; print $NF}')
+printf "Most used search expressions:\n"
+printexprs 0
+
+mapfile -t -O"$i" fexprs < <(tac "$NNN_FINDHIST" | awk '!a[$0]++' | head -n5)
+printf "Most recently used search expressions:\n"
+printexprs "$i"
+read -r -p "Search expression or index (h for help): " fexpr
+
+mapexpr
+
+if [ -n "$fexpr" ]; then
+    printf "+l" > "$NNN_PIPE"
+    while :; do
+        readexpr
+        eval "$cmd" > "$NNN_PIPE" && break
+        read -r -e -p "Search expression: " -i "$fexpr" fexpr
+    done
+    if [ -n "$fexpr" ]; then
+        tail -n"$NNN_FINDHISTLEN" "$NNN_FINDHIST" > "$TMPDIR/finderbms"
+        printf "%s\n" "$fexpr" >> "$TMPDIR/finderbms"
+        mv -- "$TMPDIR/finderbms" "$NNN_FINDHIST"
+    fi
+fi

plugins/fixname

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+
+# Description: Clean filename or dirname (either hovered or selections)
+#              to be more shell-friendly. This script cleans
+#              non A-Za-z0-9._- characters.
+#              and replaces it with underscore (_).
+#
+#              It supports cleaning single/double quote, newline,
+#              leading, trailing spaces.
+#
+#              eg.
+#              to be continued (つづく).mp4  -> to_be_continued______.mp4
+#              [work] stuff.txt              -> _work__stuff.txt
+#              home's server                 -> home_s_server
+#                qwe\trty                    -> __qwe_rty
+#
+#              And if there are two almost similar filenames
+#              like: 'asd]f' and 'asd f' both will be renamed to 'asd_f',
+#              to avoid overwriting, the last file will be prepended by _.
+#              So they will be: 'asd_f' and '_asd_f'
+#
+# Dependencies: sed
+#
+# Shell: Bash
+# Author: Benawi Adha
+
+prompt=true
+sel=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+
+cleanup() {
+    # printf "%s" "$1" | sed -e 's/[^A-Za-z0-9._-]/_/g'
+    printf "%s" "$1" | sed 's/[^A-Za-z0-9._-]/_/g' | sed ':a;N;$!ba;s/\n/_/g'
+}
+
+if [ -s "$sel" ]; then
+    targets=()
+    while IFS= read -r -d '' i || [ -n "$i" ]; do
+        targets+=( "$(basename "$i")" )
+    done < "$sel"
+else
+    targets=("$1")
+fi
+
+for i in "${targets[@]}"; do
+    printf "%s -> %s\n" "$i" "$(cleanup "$i")";
+done
+
+if $prompt; then
+    echo
+    printf "Proceed [Yn]? "
+    read -r input
+    case "$input" in
+        y|Y|'')
+            ;;
+        *)
+            echo "Canceled"
+            exit
+            ;;
+    esac
+fi
+
+for i in "${targets[@]}"; do
+    if [ "$i" != "$(cleanup "$i")" ]; then
+        tmp=''
+        if [ -e "$(cleanup "$i")" ]; then
+            tmp='_'
+        fi
+        mv -- "$i" "$tmp$(cleanup "$i")";
+    fi
+done
+
+# Clear selection
+if [ -s "$sel" ] && [ -p "$NNN_PIPE" ]; then
+    printf "-" > "$NNN_PIPE"
+fi

plugins/fzcd

@@ -0,0 +1,89 @@
+#!/usr/bin/env sh
+
+# Description: Fuzzy search multiple locations read-in from a path-list file
+#              (or $PWD) and open the selected file's dir in a smart context.
+# Dependencies: fzf, find (only for multi-location search)
+#
+# Details: Paths in list file should be newline-separated absolute paths.
+#          Paths can be file paths; the script will scan the parent dirs.
+#
+#          The path-list file precedence is:
+#          - "$1" (the hovered file) if it exists, is plain-text and the
+#                 first line points to an existing file
+#          - "$LIST" if set below
+#          - "$2" (the current directory) [mimics plugin fzcd behaviour]
+#
+#          The path-list file can be generated easily:
+#          - pick the (file)paths in picker mode to path-list file
+#          - OR, edit selection in nnn and save as path-list file
+#
+# Shell: POSIX compliant
+# Author: Anna Arad, Arun Prakash Jana, KlzXS
+
+IFS="$(printf '\n\r')"
+
+# shellcheck disable=SC1090,SC1091
+. "$(dirname "$0")"/.nnn-plugin-helper
+
+CTX=+
+LIST="${LIST:-""}"
+
+if ! type fzf >/dev/null 2>&1; then
+    printf "fzf missing"
+    read -r _
+    exit 1
+fi
+
+if [ -n "$1" ] && [ "$(file -b --mime-type "$1")" = 'text/plain' ] && [ -e "$(head -1 "$1")" ]; then
+    LIST="$1"
+elif ! [ -s "$LIST" ]; then
+    sel=$(fzf)
+    # Show only the file and parent dir
+    # sel=$(fzf --delimiter / --with-nth=-2,-1 --tiebreak=begin --info=hidden)
+
+    LIST=''
+fi
+
+if [ -n "$LIST" ]; then
+    if type find >/dev/null 2>&1; then
+        tmpfile=$(mktemp /tmp/abc-script.XXXXXX)
+
+        while IFS= read -r path; do
+            if [ -d "$path" ]; then
+                printf "%s\n" "$path" >> "$tmpfile"
+            elif [ -f "$path" ]; then
+                printf "%s\n" "$(dirname "$path")" >> "$tmpfile"
+            fi
+        done < "$LIST"
+
+        sel=$(xargs -d '\n' < "$tmpfile" -I{} find {} -type f -printf "%H//%P\n" | sed '/.*\/\/\(\..*\|.*\/\..*\)/d; s:/\+:/:g' | fzf --delimiter / --tiebreak=begin --info=hidden)
+        # Alternative for 'fd'
+        # sel=$(xargs -d '\n' < "$tmpfile" fd . | fzf --delimiter / --tiebreak=begin --info=hidden)
+
+        rm -- "$tmpfile"
+    else
+        printf "find missing"
+        read -r _
+            exit 1
+    fi
+fi
+
+if [ -n "$sel" ]; then
+    if [ "$sel" = "." ] || { ! [ -d "$sel" ] && ! [ -f "$sel" ]; }; then
+        exit 0
+    fi
+
+    # Check if the selected path returned by fzf command is absolute
+    case $sel in
+    /*) nnn_cd "$sel" "$CTX" ;;
+    *)
+        # Remove "./" prefix if it exists
+        sel="${sel#./}"
+
+        if [ "$PWD" = "/" ]; then
+            nnn_cd "/$sel" "$CTX"
+        else
+            nnn_cd "$PWD/$sel" "$CTX"
+        fi;;
+    esac
+fi

plugins/fzhist

@@ -0,0 +1,53 @@
+#!/usr/bin/env sh
+
+# Description: Fuzzy find a command from history,
+#              edit in $EDITOR and run as a command
+#
+# Note: Supports only bash, zsh and fish history
+#
+# TODO: For zsh there's also $ZDOTDIR which might need to be checked as well for the -z $HISTFILE && -n $ZDOTDIR case.
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+if type fzf >/dev/null 2>&1; then
+    fuzzy=fzf
+else
+    exit 1
+fi
+
+shellname="$(basename "$SHELL")"
+
+if [ "$shellname" = "bash" ]; then
+    if [ -f "$HISTFILE" ]; then
+        hist_file="$HISTFILE"
+    else
+        hist_file="$HOME/.bash_history"
+    fi
+    entry="$("$fuzzy" < "$hist_file")"
+elif [ "$shellname" = "zsh" ]; then
+    if [ -f "$HISTFILE" ]; then
+        hist_file="$HISTFILE"
+    else
+        hist_file="$HOME/.zsh_history"
+    fi
+    entry="$("$fuzzy" < "$hist_file")"
+elif [ "$shellname" = "fish" ]; then
+    hist_file="$HOME/.local/share/fish/fish_history"
+    entry="$(grep "\- cmd: " "$hist_file" | cut -c 8- | "$fuzzy")"
+fi
+
+if [ -n "$entry" ]; then
+    tmpfile=$(mktemp)
+    echo "$entry" >> "$tmpfile"
+    $EDITOR "$tmpfile"
+
+    if [ -s "$tmpfile" ]; then
+        $SHELL -c "$(cat "$tmpfile")"
+    fi
+
+    rm -- "$tmpfile"
+
+    printf "Press any key to exit"
+    read -r _
+fi

plugins/fzopen

@@ -0,0 +1,85 @@
+#!/usr/bin/env sh
+
+# Description: Regular mode:
+#                Fuzzy find a file in directory subtree.
+#                Opens in $VISUAL or $EDITOR if text.
+#                Opens other type of files with xdg-open.
+#                Work only with a single file selected.
+#
+#              Picker mode:
+#                If picker mode output file is passed, it
+#                will be overwritten with any picked files.
+#                Leaves untouched if no file is picked.
+#                Works with single/multiple files selected.
+#
+# Dependencies: fd/find, fzf/skim, xdg-open/open (on macOS)
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+NUKE="${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins/nuke"
+USE_NUKE=0
+
+# shellcheck disable=SC1090,SC1091
+. "$(dirname "$0")"/.nnn-plugin-helper
+
+if type fzf >/dev/null 2>&1; then
+    cmd="$FZF_DEFAULT_COMMAND"
+    if type fd >/dev/null 2>&1; then
+        [ -z "$cmd" ] && cmd="fd -t f 2>/dev/null"
+    else
+        [ -z "$cmd" ] && cmd="find . -type f 2>/dev/null"
+    fi
+    entry="$(eval "$cmd" | fzf -m)"
+    # To show only the file name
+    # entry=$(find . -type f 2>/dev/null | fzf --delimiter / --with-nth=-1 --tiebreak=begin --info=hidden)
+elif type sk >/dev/null 2>&1; then
+	entry=$(find . -type f 2>/dev/null | sk)
+else
+    exit 1
+fi
+
+# Check for picker mode
+if [ "$3" ]; then
+    if [ "$entry" ]; then
+        case "$entry" in
+            /*) fullpath="$entry" ;;
+            *)  fullpath="$PWD/$entry" ;;
+        esac
+        if [ "-" = "$3" ]; then
+            printf "%s\n" "$fullpath"
+        else
+            printf "%s\n" "$fullpath" > "$3"
+        fi
+
+        # Tell `nnn` to clear its internal selection
+        printf "%s" "0p" > "$NNN_PIPE"
+    fi
+
+    exit 0
+fi
+
+if [ "$entry" ]; then
+    if [ "$USE_NUKE" -ne 0 ]; then
+        "$NUKE" "$entry"
+        exit 0
+    fi
+
+    # Open the file (works for a single file only)
+    cmd_file=""
+    cmd_open=""
+    if uname | grep -q "Darwin"; then
+        cmd_file="file -bIL"
+        cmd_open="open"
+    else
+        cmd_file="file -biL"
+        cmd_open="xdg-open"
+    fi
+
+    case "$($cmd_file "$entry")" in
+        *text*)
+            "${VISUAL:-$EDITOR}" "$entry" ;;
+        *)
+            $cmd_open "$entry" >/dev/null 2>&1 ;;
+    esac
+fi

plugins/fzplug

@@ -0,0 +1,59 @@
+#!/usr/bin/env sh
+
+# Description: Fuzzy find and execute nnn plugins (and optionally,
+#              custom scripts located elsewhere).
+#              Description and details of plugins can be previewed
+#              from the fzf interface. Use `?` to toggle preview
+#              pane on and off, ^Up/^Dn to scroll.
+#
+# Dependencies: find, fzf, cat (or bat, if installed)
+#
+# Note: For better compatibility with as many nnn plugins as possible,
+#       fzplug will first execute the chosen script on the file hovered
+#       in nnn, and upon failure, try to run it with no target (i.e on
+#       an active selection, if present).
+#
+# Shell: POSIX compliant
+# Author: Kabouik
+
+# Optional scripts sources
+
+# Leave blank or fill with the absolute path of a folder containing executable
+# scripts other than nnn plugins (e.g., "$HOME/.local/share/nautilus/scripts",
+# since there are numerous Nautilus script git repositories).
+# Add extra variables if needed, make sure you call them in the find command.
+
+#CUSTOMDIR1="$HOME/.local/share/nautilus/scripts"
+CUSTOMDIR1=""
+CUSTOMDIR2=""
+
+nnnpluginsdir="$HOME/.config/nnn/plugins"
+
+# Preview with bat if installed
+if type bat >/dev/null; then
+    BAT="bat --terminal-width='$(tput cols)' --decorations=always --color=always --style='${BAT_STYLE:-header,numbers}'"
+fi
+
+plugin=$(find "$nnnpluginsdir" "$CUSTOMDIR1" "$CUSTOMDIR2" \
+-maxdepth 3 -perm -111 -type f 2>/dev/null | fzf --ansi --preview \
+    "${BAT:-cat} {}" --preview-window="right:66%:wrap" --delimiter / \
+    --with-nth -1 --bind="?:toggle-preview")
+
+# Try running the script on the hovered file, and abort
+# abort if no plugin was selected (ESC or ^C pressed).
+err=0
+if ! [ "$plugin" = "" ]; then
+    "$plugin" "$1" || err=1
+fi
+
+# If attempt with hovered file fails, try without any target
+# (nnn selections should still be passed to the script in that case)
+if [ "$err" -eq "1" ]; then
+    clear && "$plugin" || err=2
+fi
+
+# Abort and show error if both fail
+if [ "$err" -eq "2" ]; then
+    sep="\n---\n"
+    printf "$sep""Failed to execute '%s'. See error above or try without fzfplug. Press return to continue. " "$plugin" && read -r _ && clear
+fi

plugins/getplugs

@@ -0,0 +1,70 @@
+#!/usr/bin/env sh
+
+# Description: Update nnn plugins to installed nnn version
+#
+# Shell: POSIX compliant
+# Authors: Arun Prakash Jana, KlzXS
+
+CONFIG_DIR=${XDG_CONFIG_HOME:-$HOME/.config}/nnn/
+PLUGIN_DIR=${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins
+
+merge () {
+	if type nvim >/dev/null 2>&1; then
+		nvim -d "$1" "$2"
+	else
+		vimdiff +0 "$1" "$2"
+	fi
+}
+
+prompt () {
+	printf "%s\n" "Plugin $1 already exists and is different."
+	printf "Keep (k), merge (m), overwrite (o) [default: k]? "
+	read -r operation
+
+	if [ "$operation" = "m" ]; then
+		op="merge"
+	elif [ "$operation" = "o" ]; then
+		op="cp -vRf --"
+	else
+		op="true"
+	fi
+}
+
+if [ "$1" = "master" ] ; then
+    VER="master"
+    ARCHIVE_URL=https://github.com/jarun/nnn/archive/master.tar.gz
+elif type nnn >/dev/null 2>&1; then
+    VER=$(nnn -V)
+    ARCHIVE_URL=https://github.com/jarun/nnn/releases/download/v"$VER"/nnn-v"$VER".tar.gz
+else
+    echo "nnn is not installed"
+    exit 1
+fi
+
+# backup any earlier plugins
+if [ -d "$PLUGIN_DIR" ]; then
+    tar -C "$CONFIG_DIR" -czf "$CONFIG_DIR""plugins-$(date '+%Y%m%d%H%M').tar.gz" plugins/
+fi
+
+mkdir -p "$PLUGIN_DIR"
+cd "$CONFIG_DIR" || exit 1
+curl -Ls "$ARCHIVE_URL" -o nnn-"$VER".tar.gz
+tar -zxf nnn-"$VER".tar.gz
+
+cd nnn-"$VER"/plugins || exit 1
+
+# shellcheck disable=SC2044
+# We do not use obnoxious names for plugins
+for f in $(find . -maxdepth 1 \( ! -iname "." ! -iname "*.md" \)); do
+	if [ -f ../../plugins/"$f" ]; then
+		if [ "$(diff --brief "$f" ../../plugins/"$f")" ]; then
+			prompt "$f"
+			$op "$f" ../../plugins/
+		fi
+	else
+		cp -vRf -- "$f" ../../plugins/
+	fi
+done
+cd ../.. || exit 1
+
+rm -rf nnn-"$VER"/ nnn-"$VER".tar.gz

plugins/gitroot

@@ -0,0 +1,15 @@
+#!/usr/bin/env sh
+
+# Description: cd to the top level of the current git repository in the current context
+# Dependencies: git
+# Shell: sh
+# Author: https://github.com/PatrickF1
+
+root="$(git rev-parse --show-toplevel 2>/dev/null)"
+if [ -n "$root" ]; then
+    printf "%s" "0c$root" > "$NNN_PIPE"
+else
+    printf "Not in a git repository"
+    read -r _
+    exit 1
+fi

plugins/gpgd

@@ -0,0 +1,28 @@
+#!/usr/bin/env sh
+
+# Description: Decrypts selected files using gpg. The contents of the
+#              decrypted file are stored in a file with extension .dec
+#
+# Note: If an appropriate private key cannot be found gpg silently
+#       prints a message in the background and no files are written.
+#
+# Shell: POSIX compliant
+# Author: KlzXS
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+
+printf "(s)election/(c)urrent? [default=c] "
+read -r resp
+
+if [ "$resp" = "s" ]; then
+	files=$(tr '\0' '\n' < "$selection")
+else
+	files=$1
+fi
+
+printf "%s" "$files" | xargs -n1 -I{} gpg --decrypt --output "{}.dec" {}
+
+# Clear selection
+if [ "$resp" = "s" ] && [ -p "$NNN_PIPE" ]; then
+    printf "-" > "$NNN_PIPE"
+fi

plugins/gpge

@@ -0,0 +1,45 @@
+#!/usr/bin/env sh
+
+# Description: Encrypts selected files using gpg. Can encrypt
+#              asymmetrically (key) or symmetrically (passphrase).
+#              If asymmetric encryption is chosen a key can be
+#              chosen from the list of capable public keys using fzf.
+#
+# Note: Symmetric encryption only works for a single (current) file as per gpg limitations
+#
+# Shell: POSIX compliant
+# Author: KlzXS
+
+# shellcheck disable=SC1090,SC1091
+. "$(dirname "$0")"/.nnn-plugin-helper
+
+printf "(s)ymmetric, (a)symmetric? [default=a] "
+read -r symmetry
+
+if [ "$symmetry" = "s" ]; then
+	gpg --symmetric "$1"
+else
+	if nnn_use_selection; then
+		clear_sel=1
+		# shellcheck disable=SC2154
+		files=$(tr '\0' '\n' < "$selection")
+	else
+		clear_sel=0
+		files=$1
+	fi
+
+	keyids=$(gpg --list-public-keys --with-colons | grep -E "pub:(.*:){10}.*[eE].*:" | awk -F ":" '{print $5}')
+
+	#awk needs literal $10
+	#shellcheck disable=SC2016
+	keyuids=$(printf "%s" "$keyids" | xargs -n1 -I{} sh -c 'gpg --list-key --with-colons "{}" | grep "uid" | awk -F ":" '\''{printf "%s %s\n", "{}", $10}'\''')
+
+	recipient=$(printf "%s" "$keyuids" | fzf | awk '{print $1}')
+
+	printf "%s" "$files" | xargs -n1 gpg --encrypt --recipient "$recipient"
+
+	# Clear selection
+	if [ "$clear_sel" -eq 1 ] && [ -p "$NNN_PIPE" ]; then
+		printf "-" > "$NNN_PIPE"
+	fi
+fi

plugins/gsconnect

@@ -0,0 +1,21 @@
+#!/usr/bin/env sh
+
+#set -x
+# Description: Send the selected (or hovered) files to your Android device using gsconnect daemon.js.
+#              GSConnect must be configured on the Android device and the PC.
+#
+# Shell: POSIX compliant
+# Author: Darukutsu 
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+gsconnect=$HOME/.local/share/gnome-shell/extensions/gsconnect@andyholmes.github.io/service/daemon.js
+ids=$($gsconnect -l)
+
+for id in $ids; do
+	if [ -s "$selection" ]; then
+		xargs -0 < "$selection" -I{} "$gsconnect" -d "$id" --share-file="{}"
+		# Clear selection
+		printf "-" > "$NNN_PIPE"
+	else
+		"$gsconnect" -d "$id" --share-file="$2/$1"
+	fi
+done

plugins/gutenread

@@ -0,0 +1,49 @@
+#!/usr/bin/env sh
+
+# Description: Browse Project Gutenberg catalogue by popularity, then download
+#              and read a book of your choice.
+#
+# Details: Set the variable EBOOK_ID to download in html format and read in w3m.
+#          Clear EBOOK_ID to browse available ebooks by popularity and set it to
+#          the ID once you find an interesting one.
+#          To download and read in epub format set READER to an epub reader like
+#          epr: https://github.com/wustho/epr
+#
+#          More on EBOOK_ID:
+#          Wuthering Heights by Emily Brontë is at https://www.gutenberg.org/ebooks/768
+#          So EBOOK_ID would be 768
+#
+#          Downloaded ebooks are at ${XDG_CACHE_HOME:-$HOME/.cache}/nnn/gutenbooks/
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+EBOOK_ID="${EBOOK_ID:-""}"
+DIR="${XDG_CACHE_HOME:-$HOME/.cache}/nnn/gutenbooks/$EBOOK_ID"
+BROWSE_LINK="https://www.gutenberg.org/ebooks/search/?sort_order=downloads"
+BROWSER="${BROWSER:-w3m}"
+READER="${READER:-""}"
+
+if [ -n "$EBOOK_ID" ]; then
+    if [ ! -e "$DIR" ]; then
+        mkdir -p "$DIR"
+        cd "$DIR" || exit 1
+
+        if [ -z "$READER" ]; then
+            curl -L -O "https://www.gutenberg.org/files/$EBOOK_ID/$EBOOK_ID-h.zip"
+            unzip "$EBOOK_ID"-h.zip
+        else
+            curl -L -o "$EBOOK_ID".epub "https://www.gutenberg.org/ebooks/$EBOOK_ID.epub.noimages"
+        fi
+    fi
+
+    if [ -d "$DIR" ]; then
+        if [ -z "$READER" ]; then
+            "$BROWSER" "$DIR/$EBOOK_ID-h/$EBOOK_ID-h.htm"
+        else
+            "$READER" "$DIR/$EBOOK_ID.epub"
+        fi
+    fi
+else
+    "$BROWSER" "$BROWSE_LINK"
+fi

plugins/imgresize

@@ -0,0 +1,31 @@
+#!/usr/bin/env sh
+
+# Description: Resize images in a directory to screen resolution with imgp
+#
+# Dependencipes: imgp - https://github.com/jarun/imgp
+#
+# Notes:
+#   1. Set res to avoid the desktop resolution prompt each time
+#   2. MINSIZE is set to 1MB by default, adjust it if you want
+#   3. imgp options used:
+#      a - adaptive mode
+#      c - convert PNG to JPG
+#      k - skip images matching specified hres/vres
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+# set resolution (e.g. 1920x1080)
+res="${RESOLUTION}"
+
+# set minimum image size (in bytes) to resize (default: 1MB)
+MINSIZE="${MINSIZE:-1048576}"
+
+if [ -z "$res" ]; then
+    printf "desktop resolution (hxv): "
+    read -r res
+fi
+
+if [ -n "$res" ] && [ -n "$MINSIZE" ]; then
+    imgp -ackx "$res" -s "$MINSIZE"
+fi

plugins/imgur

@@ -0,0 +1,597 @@
+#!/usr/bin/env bash
+
+##########################################################################
+# The MIT License
+#
+# Copyright (c) jomo
+#
+# Permission is hereby granted, free of charge,
+# to any person obtaining a copy of this software and
+# associated documentation files (the "Software"), to
+# deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify,
+# merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom
+# the Software is furnished to do so,
+# subject to the following conditions:
+#
+# The above copyright notice and this permission notice
+# shall be included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
+# ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+##########################################################################
+
+# https://github.com/jomo/imgur-screenshot
+# https://help.imgur.com/hc/en-us/articles/209592766-Tools-for-Imgur
+#
+# Slightly modified for `nnn` integration
+#
+# Shell: Bash
+# Description: Upload an image file to imgur
+
+if [ "${1}" = "--debug" ]; then
+  echo "########################################"
+  echo "Enabling debug mode"
+  echo "Please remove credentials before pasting"
+  echo "########################################"
+  echo ""
+  uname -a
+  for arg in ${0} "${@}"; do
+    echo -n "'${arg}' "
+  done
+  echo -e "\n"
+  shift
+  set -x
+fi
+
+current_version="v1.7.4"
+
+function is_mac() {
+  uname | grep -q "Darwin"
+}
+
+### IMGUR-SCREENSHOT DEFAULT CONFIG ####
+
+# You can override the config in ~/.config/imgur-screenshot/settings.conf
+
+imgur_anon_id="ea6c0ef2987808e"
+imgur_icon_path="${HOME}/Pictures/imgur.png"
+
+imgur_acct_key=""
+imgur_secret=""
+login="false"
+album_title=""
+album_id=""
+credentials_file="${HOME}/.config/imgur-screenshot/credentials.conf"
+
+file_name_format="imgur-%Y_%m_%d-%H:%M:%S.png" # when using scrot, must end with .png!
+file_dir="${HOME}/Pictures"
+
+upload_connect_timeout="5"
+upload_timeout="120"
+upload_retries="1"
+
+# shellcheck disable=SC2034
+if is_mac; then
+  screenshot_select_command="screencapture -i %img"
+  screenshot_window_command="screencapture -iWa %img"
+  screenshot_full_command="screencapture %img"
+  open_command="open %url"
+else
+  screenshot_select_command="scrot -s %img"
+  screenshot_window_command="scrot %img"
+  screenshot_full_command="scrot %img"
+  open_command="xdg-open %url"
+fi
+open="true"
+
+mode="select"
+edit_command="gimp %img"
+edit="false"
+exit_on_album_creation_fail="true"
+
+log_file="${HOME}/.imgur-screenshot.log"
+
+auto_delete=""
+copy_url="true"
+keep_file="true"
+check_update="true"
+
+# NOTICE: if you make changes here, also edit the docs at
+# https://github.com/jomo/imgur-screenshot/wiki/Config
+
+# You can override the config in ~/.config/imgur-screenshot/settings.conf
+
+############## END CONFIG ##############
+
+settings_path="${HOME}/.config/imgur-screenshot/settings.conf"
+if [ -f "${settings_path}" ]; then
+  # shellcheck disable=SC1090
+  source "${settings_path}"
+fi
+
+# dependency check
+if [ "${1}" = "--check" ]; then
+  (type grep &>/dev/null && echo "OK: found grep") || echo "ERROR: grep not found"
+  if is_mac; then
+    if type growlnotify &>/dev/null; then
+      echo "OK: found growlnotify"
+    elif type terminal-notifier &>/dev/null; then
+      echo "OK: found terminal-notifier"
+    else
+      echo "ERROR: growlnotify nor terminal-notifier found"
+    fi
+    (type screencapture &>/dev/null && echo "OK: found screencapture") || echo "ERROR: screencapture not found"
+    (type pbcopy &>/dev/null && echo "OK: found pbcopy") || echo "ERROR: pbcopy not found"
+  else
+    (type notify-send &>/dev/null && echo "OK: found notify-send") || echo "ERROR: notify-send (from libnotify-bin) not found"
+    (type scrot &>/dev/null && echo "OK: found scrot") || echo "ERROR: scrot not found"
+    (type xclip &>/dev/null && echo "OK: found xclip") || echo "ERROR: xclip not found"
+  fi
+  (type curl &>/dev/null && echo "OK: found curl") || echo "ERROR: curl not found"
+  exit 0
+fi
+
+
+# notify <'ok'|'error'> <title> <text>
+function notify() {
+  if is_mac; then
+    if type growlnotify &>/dev/null; then
+      growlnotify  --icon "${imgur_icon_path}" --iconpath "${imgur_icon_path}" --title "${2}" --message "${3}"
+    else
+      terminal-notifier -appIcon "${imgur_icon_path}" -contentImage "${imgur_icon_path}" -title "imgur: ${2}" -message "${3}"
+    fi
+  else
+    if [ "${1}" = "error" ]; then
+      notify-send -a ImgurScreenshot -u critical -c "im.error" -i "${imgur_icon_path}" -t 500 "imgur: ${2}" "${3}"
+    else
+      notify-send -a ImgurScreenshot -u low -c "transfer.complete" -i "${imgur_icon_path}" -t 500 "imgur: ${2}" "${3}"
+    fi
+  fi
+}
+
+function take_screenshot() {
+  echo "Please select area"
+  is_mac || sleep 0.1 # https://bbs.archlinux.org/viewtopic.php?pid=1246173#p1246173
+
+  cmd="screenshot_${mode}_command"
+  cmd=${!cmd//\%img/${1}}
+
+  if ! shot_err="$(${cmd} &>/dev/null)"; then  #takes a screenshot with selection
+    echo "Failed to take screenshot '${1}': '${shot_err}'. For more information visit https://github.com/jomo/imgur-screenshot/wiki/Troubleshooting" | tee -a "${log_file}"
+    notify error "Something went wrong :(" "Information has been logged"
+    exit 1
+  fi
+}
+
+function check_for_update() {
+  # exit non-zero on HTTP error, output only the body (no stats) but output errors, follow redirects, output everything to stdout
+  remote_version="$(curl --compressed -fsSL --stderr - "https://api.github.com/repos/jomo/imgur-screenshot/releases" | grep -Em 1 --color 'tag_name":\s*".*"' | cut -d '"' -f 4)"
+  if [ -n "$remote_version" ]; then
+    if [ ! "${current_version}" = "${remote_version}" ] && [ -n "${current_version}" ] && [ -n "${remote_version}" ]; then
+      echo "Update found!"
+      echo "Version ${remote_version} is available (You have ${current_version})"
+      notify ok "Update found" "Version ${remote_version} is available (You have ${current_version}). https://github.com/jomo/imgur-screenshot"
+      echo "Check https://github.com/jomo/imgur-screenshot/releases/${remote_version} for more info."
+    elif [ -z "${current_version}" ] || [ -z "${remote_version}" ]; then
+      echo "Invalid empty version string"
+      echo "Current (local) version: '${current_version}'"
+      echo "Latest (remote) version: '${remote_version}'"
+    else
+      echo "Version ${current_version} is up to date."
+    fi
+  else
+    echo "Failed to check for latest version: ${remote_version}"
+  fi
+}
+
+function check_oauth2_client_secrets() {
+  if [ -z "${imgur_acct_key}" ] || [ -z "${imgur_secret}" ]; then
+    echo "In order to upload to your account, register a new application at:"
+    echo "https://api.imgur.com/oauth2/addclient"
+    echo "Select 'OAuth 2 authorization without a callback URL'"
+    echo "Then, set the imgur_acct_key (Client ID) and imgur_secret in your config."
+    exit 1
+  fi
+}
+
+function load_access_token() {
+  token_expire_time=0
+  # check for saved access_token and its expiration date
+  if [ -f "${credentials_file}" ]; then
+    # shellcheck disable=SC1090
+    source "${credentials_file}"
+  fi
+  current_time="$(date +%s)"
+  preemptive_refresh_time="$((10*60))"
+  expired="$((current_time > (token_expire_time - preemptive_refresh_time)))"
+  if [ -n "${refresh_token}" ]; then
+    # token already set
+    if [ "${expired}" -eq "0" ]; then
+      # token expired
+      refresh_access_token "${credentials_file}"
+    fi
+  else
+    acquire_access_token "${credentials_file}"
+  fi
+}
+
+function acquire_access_token() {
+  check_oauth2_client_secrets
+  # prompt for a PIN
+  authorize_url="https://api.imgur.com/oauth2/authorize?client_id=${imgur_acct_key}&response_type=pin"
+  echo "Go to"
+  echo "${authorize_url}"
+  echo "and grant access to this application."
+  read -rp "Enter the PIN: " imgur_pin
+
+  if [ -z "${imgur_pin}" ]; then
+    echo "PIN not entered, exiting"
+    exit 1
+  fi
+
+  # exchange the PIN for access token and refresh token
+  response="$(curl --compressed -fsSL --stderr - \
+    -F "client_id=${imgur_acct_key}" \
+    -F "client_secret=${imgur_secret}" \
+    -F "grant_type=pin" \
+    -F "pin=${imgur_pin}" \
+    https://api.imgur.com/oauth2/token)"
+  save_access_token "${response}" "${1}"
+}
+
+function refresh_access_token() {
+  check_oauth2_client_secrets
+  token_url="https://api.imgur.com/oauth2/token"
+  # exchange the refresh token for access_token and refresh_token
+  if ! response="$(curl --compressed -fsSL --stderr - \
+                    -F "client_id=${imgur_acct_key}" \
+                    -F "client_secret=${imgur_secret}" \
+                    -F "grant_type=refresh_token" \
+                    -F "refresh_token=${refresh_token}" \
+                    "${token_url}"
+                    )"; then
+    # curl failed
+    handle_upload_error "${response}" "${token_url}"
+    exit 1
+  fi
+  save_access_token "${response}" "${1}"
+}
+
+function save_access_token() {
+  if ! grep -q "access_token" <<<"${1}"; then
+    # server did not send access_token
+    echo "Error: Something is wrong with your credentials:"
+    echo "${1}"
+    exit 1
+  fi
+
+  access_token="$(grep -Eo 'access_token":".*"' <<<"${1}" | cut -d '"' -f 3)"
+  refresh_token="$(grep -Eo 'refresh_token":".*"' <<<"${1}" | cut -d '"' -f 3)"
+  expires_in="$(grep -Eo 'expires_in":[0-9]*' <<<"${1}" | cut -d ':' -f 2)"
+  token_expire_time="$(( $(date +%s) + expires_in ))"
+
+  # create dir if not exist
+  mkdir -p "$(dirname "${2}")" 2>/dev/null
+  touch "${2}" && chmod 600 "${2}"
+  cat <<EOF > "${2}"
+access_token="${access_token}"
+refresh_token="${refresh_token}"
+token_expire_time="${token_expire_time}"
+EOF
+}
+
+function fetch_account_info() {
+  response="$(curl --compressed --connect-timeout "${upload_connect_timeout}" -m "${upload_timeout}" --retry "${upload_retries}" -fsSL --stderr - -H "Authorization: Bearer ${access_token}" https://api.imgur.com/3/account/me)"
+  if grep -Eq '"success":\s*true' <<<"${response}"; then
+    username="$(grep -Eo '"url":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+    echo "Logged in as ${username}."
+    echo "https://${username}.imgur.com"
+  else
+    echo "Failed to fetch info: ${response}"
+  fi
+}
+
+function delete_image() {
+  response="$(curl --compressed -X DELETE  -fsSL --stderr - -H "Authorization: Client-ID ${1}" "https://api.imgur.com/3/image/${2}")"
+  if grep -Eq '"success":\s*true' <<<"${response}"; then
+    echo "Image successfully deleted (delete hash: ${2})." >> "${3}"
+  else
+    echo "The Image could not be deleted: ${response}." >> "${3}"
+  fi
+}
+
+function upload_authenticated_image() {
+  echo "Uploading '${1}'..."
+  title="$(echo "${1}" | rev | cut -d "/" -f 1 | cut -d "." -f 2- | rev)"
+  if [ -n "${album_id}" ]; then
+    response="$(curl --compressed --connect-timeout "${upload_connect_timeout}" -m "${upload_timeout}" --retry "${upload_retries}" -fsSL --stderr - -F "title=${title}" -F "image=@\"${1}\"" -F "album=${album_id}" -H "Authorization: Bearer ${access_token}" https://api.imgur.com/3/image)"
+  else
+    response="$(curl --compressed --connect-timeout "${upload_connect_timeout}" -m "${upload_timeout}" --retry "${upload_retries}" -fsSL --stderr - -F "title=${title}" -F "image=@\"${1}\"" -H "Authorization: Bearer ${access_token}" https://api.imgur.com/3/image)"
+  fi
+
+  # JSON parser premium edition (not really)
+  if grep -Eq '"success":\s*true' <<<"${response}"; then
+    img_id="$(grep -Eo '"id":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+    img_ext="$(grep -Eo '"link":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4 | rev | cut -d "." -f 1 | rev)" # "link" itself has ugly '\/' escaping and no https!
+    del_id="$(grep -Eo '"deletehash":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+
+    if [ -n "${auto_delete}" ]; then
+      export -f delete_image
+      echo "Deleting image in ${auto_delete} seconds."
+      nohup /bin/bash -c "sleep ${auto_delete} && delete_image ${imgur_anon_id} ${del_id} ${log_file}" &
+    fi
+
+    handle_upload_success "https://i.imgur.com/${img_id}.${img_ext}" "https://imgur.com/delete/${del_id}" "${1}"
+  else # upload failed
+    err_msg="$(grep -Eo '"error":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+    test -z "${err_msg}" && err_msg="${response}"
+    handle_upload_error "${err_msg}" "${1}"
+  fi
+}
+
+function upload_anonymous_image() {
+  echo "Uploading '${1}'..."
+  title="$(echo "${1}" | rev | cut -d "/" -f 1 | cut -d "." -f 2- | rev)"
+  if [ -n "${album_id}" ]; then
+    response="$(curl --compressed --connect-timeout "${upload_connect_timeout}" -m "${upload_timeout}" --retry "${upload_retries}" -fsSL --stderr - -H "Authorization: Client-ID ${imgur_anon_id}" -F "title=${title}" -F "image=@\"${1}\"" -F "album=${album_id}" https://api.imgur.com/3/image)"
+  else
+    response="$(curl --compressed --connect-timeout "${upload_connect_timeout}" -m "${upload_timeout}" --retry "${upload_retries}" -fsSL --stderr - -H "Authorization: Client-ID ${imgur_anon_id}" -F "title=${title}" -F "image=@\"${1}\"" https://api.imgur.com/3/image)"
+  fi
+  # JSON parser premium edition (not really)
+  if grep -Eq '"success":\s*true' <<<"${response}"; then
+    img_id="$(grep -Eo '"id":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+    img_ext="$(grep -Eo '"link":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4 | rev | cut -d "." -f 1 | rev)" # "link" itself has ugly '\/' escaping and no https!
+    del_id="$(grep -Eo '"deletehash":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+
+    if [ -n "${auto_delete}" ]; then
+      export -f delete_image
+      echo "Deleting image in ${auto_delete} seconds."
+      nohup /bin/bash -c "sleep ${auto_delete} && delete_image ${imgur_anon_id} ${del_id} ${log_file}" &
+    fi
+
+    handle_upload_success "https://i.imgur.com/${img_id}.${img_ext}" "https://imgur.com/delete/${del_id}" "${1}"
+  else # upload failed
+    err_msg="$(grep -Eo '"error":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+    test -z "${err_msg}" && err_msg="${response}"
+    handle_upload_error "${err_msg}" "${1}"
+  fi
+}
+
+function handle_upload_success() {
+  echo ""
+  echo "image  link: ${1}"
+  echo "delete link: ${2}"
+
+  if [ "${copy_url}" = "true" ] && [ -z "${album_title}" ]; then
+    if is_mac; then
+      echo -n "${1}" | pbcopy
+    else
+      echo -n "${1}" | xclip -selection clipboard
+    fi
+    echo "URL copied to clipboard"
+  fi
+
+  # print to log file: image link, image location, delete link
+  echo -e "${1}\t${3}\t${2}" >> "${log_file}"
+
+  notify ok "Upload done!" "${1}"
+
+#  if [ ! -z "${open_command}" ] && [ "${open}" = "true" ]; then
+#    open_cmd=${open_command//\%url/${1}}
+#    open_cmd=${open_cmd//\%img/${2}}
+#    echo "Opening '${open_cmd}'"
+#    eval "${open_cmd}"
+#  fi
+}
+
+function handle_upload_error() {
+  error="Upload failed: \"${1}\""
+  echo "${error}"
+  echo -e "Error\t${2}\t${error}" >> "${log_file}"
+  notify error "Upload failed :(" "${1}"
+}
+
+function handle_album_creation_success() {
+  echo ""
+  echo "Album  link: ${1}"
+  echo "Delete hash: ${2}"
+  echo ""
+
+  notify ok "Album created!" "${1}"
+
+  if [ "${copy_url}" = "true" ]; then
+    if is_mac; then
+      echo -n "${1}" | pbcopy
+    else
+      echo -n "${1}" | xclip -selection clipboard
+    fi
+    echo "URL copied to clipboard"
+  fi
+
+  # print to log file: album link, album title, delete hash
+  echo -e "${1}\t\"${3}\"\t${2}" >> "${log_file}"
+}
+
+function handle_album_creation_error() {
+  error="Album creation failed: \"${1}\""
+  echo -e "Error\t${2}\t${error}" >> "${log_file}"
+  notify error "Album creation failed :(" "${1}"
+  if [ ${exit_on_album_creation_fail} ]; then
+    exit 1
+  fi
+}
+
+while [ ${#} != 0 ]; do
+  case "${1}" in
+  -h | --help)
+    echo "usage: ${0} [--debug] [-c | --check | -v | -h | -u]"
+    echo "       ${0} [--debug] [option]... [file]..."
+    echo ""
+    echo "      --debug                  Enable debugging, must be first option"
+    echo "  -h, --help                   Show this help, exit"
+    echo "  -v, --version                Show current version, exit"
+    echo "      --check                  Check if all dependencies are installed, exit"
+    echo "  -c, --connect                Show connected imgur account, exit"
+    echo "  -o, --open <true|false>      Override 'open' config"
+    echo "  -e, --edit <true|false>      Override 'edit' config"
+    echo "  -i, --edit-command <command> Override 'edit_command' config (include '%img'), sets --edit 'true'"
+    echo "  -l, --login <true|false>     Override 'login' config"
+    echo "  -a, --album <album_title>    Create new album and upload there"
+    echo "  -A, --album-id <album_id>    Override 'album_id' config"
+    echo "  -k, --keep-file <true|false> Override 'keep_file' config"
+    echo "  -d, --auto-delete <s>        Automatically delete image after <s> seconds"
+    echo "  -u, --update                 Check for updates, exit"
+    echo "  file                         Upload file instead of taking a screenshot"
+    exit 0;;
+  -v | --version)
+    echo "${current_version}"
+    exit 0;;
+  -s | --select)
+    mode="select"
+    shift;;
+  -w | --window)
+    mode="window"
+    shift;;
+  -f | --full)
+    mode="full"
+    shift;;
+  -o | --open)
+    # shellcheck disable=SC2034
+    open="${2}"
+    shift 2;;
+  -e | --edit)
+    edit="${2}"
+    shift 2;;
+  -i | --edit-command)
+    edit_command="${2}"
+    edit="true"
+    shift 2;;
+  -l | --login)
+    login="${2}"
+    shift 2;;
+  -c | --connect)
+    load_access_token
+    fetch_account_info
+    exit 0;;
+  -a | --album)
+    album_title="${2}"
+    shift 2;;
+  -A | --album-id)
+    album_id="${2}"
+    shift 2;;
+  -k | --keep-file)
+    keep_file="${2}"
+    shift 2;;
+  -d | --auto-delete)
+    auto_delete="${2}"
+    shift 2;;
+  -u | --update)
+    check_for_update
+    exit 0;;
+  *)
+    upload_files=("${@}")
+    break;;
+  esac
+done
+
+if [ "${login}" = "true" ]; then
+  # load before changing directory
+  load_access_token
+fi
+
+
+if [ -n "${album_title}" ]; then
+  if [ "${login}" = "true" ]; then
+    response="$(curl -fsSL --stderr - \
+      -F "title=${album_title}" \
+      -H "Authorization: Bearer ${access_token}" \
+      https://api.imgur.com/3/album)"
+  else
+    response="$(curl -fsSL --stderr - \
+      -F "title=${album_title}" \
+      -H "Authorization: Client-ID ${imgur_anon_id}" \
+      https://api.imgur.com/3/album)"
+  fi
+  if grep -Eq '"success":\s*true' <<<"${response}"; then # Album creation successful
+    echo "Album '${album_title}' successfully created"
+    album_id="$(grep -Eo '"id":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+    del_id="$(grep -Eo '"deletehash":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+    handle_album_creation_success "https://imgur.com/a/${album_id}" "${del_id}" "${album_title}"
+
+    if [ "${login}" = "false" ]; then
+      album_id="${del_id}"
+    fi
+  else # Album creation failed
+    err_msg="$(grep -Eo '"error":\s*"[^"]+"' <<<"${response}" | cut -d "\"" -f 4)"
+    test -z "${err_msg}" && err_msg="${response}"
+    handle_album_creation_error "${err_msg}" "${album_title}"
+  fi
+fi
+
+if [ -z "${upload_files[*]}" ]; then
+  upload_files[0]=""
+fi
+
+for upload_file in "${upload_files[@]}"; do
+
+  if [ -z "${upload_file}" ]; then
+    cd "${file_dir}" || exit 1
+
+    # new filename with date
+    img_file="$(date +"${file_name_format}")"
+    take_screenshot "${img_file}"
+  else
+    # upload file instead of screenshot
+    img_file="${upload_file}"
+  fi
+
+  # get full path
+  #cd "$(dirname "$(realpath "${img_file}")")"
+  #img_file="$(realpath "${img_file}")"
+
+  # check if file exists
+  if ! [ -f "${img_file}" ]; then
+    echo "file '${img_file}' doesn't exist !"
+    read -r _
+    exit 1
+  fi
+
+  # open image in editor if configured
+  if [ "${edit}" = "true" ]; then
+    edit_cmd=${edit_command//\%img/${img_file}}
+    echo "Opening editor '${edit_cmd}'"
+    if ! (eval "${edit_cmd}"); then
+      echo "Error for image '${img_file}': command '${edit_cmd}' failed, not uploading. For more information visit https://github.com/jomo/imgur-screenshot/wiki/Troubleshooting" | tee -a "${log_file}"
+      notify error "Something went wrong :(" "Information has been logged"
+      exit 1
+    fi
+  fi
+
+  if [ "${login}" = "true" ]; then
+    upload_authenticated_image "${img_file}"
+  else
+    upload_anonymous_image "${img_file}"
+  fi
+
+  # delete file if configured
+  if [ "${keep_file}" = "false" ] && [ -z "${1}" ]; then
+    echo "Deleting temp file ${file_dir}/${img_file}"
+    rm -rf -- "${img_file}"
+  fi
+
+  echo ""
+done
+
+
+if [ "${check_update}" = "true" ]; then
+  check_for_update
+fi
+
+read -r _

plugins/imgview

@@ -0,0 +1,113 @@
+#!/usr/bin/env sh
+
+# Description: Open hovered or current directory in image viewer.
+#              Generates media thumbnails with optional dependencies.
+#
+# Dependencies:
+#   - imv (https://github.com/eXeC64/imv) or,
+#   - sxiv (https://github.com/muennich/sxiv) or,
+#   - nsxiv (https://codeberg.org/nsxiv/nsxiv) or,
+#   - ucollage (https://github.com/ckardaris/ucollage) or,
+#   - lsix (https://github.com/hackerb9/lsix), or
+#   - viu (https://github.com/atanunq/viu), or
+#   - catimg (https://github.com/posva/catimg), or
+#   - optional: ffmpeg for audio thumbnails (album art)
+#   - optional: ffmpegthumbnailer for video thumbnails
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana, Luuk van Baal
+#
+# Consider setting NNN_PREVIEWDIR to $XDG_CACHE_HOME/nnn/previews
+# if you want to keep media thumbnails on disk between reboots.
+NNN_PREVIEWDIR="${NNN_PREVIEWDIR:-${TMPDIR:-/tmp}/nnn/previews}"
+
+exit_prompt() {
+    [ -n "$1" ] && printf "%s\n" "$1"
+    printf "%s" "Press any key to exit..."
+    cfg=$(stty -g); stty raw -echo; head -c 1; stty "$cfg"
+    clear
+    exit
+}
+
+make_thumbs() {
+    mkdir -p "$NNN_PREVIEWDIR$dir" || return
+    if [ "$1" = "viu" ] || [ "$1" = "catimg" ]; then
+        [ -d "$target" ] && exit_prompt "$1 can only display a single image"
+        mime="$(file -bL --mime-type -- "$target")"
+        case "$mime" in
+          audio/*) ffmpeg -i "$target" "$NNN_PREVIEWDIR$target.jpg" -y >/dev/null 2>&1
+              ret="$NNN_PREVIEWDIR/$target.jpg" ;;
+          video/*) ffmpegthumbnailer -i "$target" -o "$NNN_PREVIEWDIR$target.jpg" 2> /dev/null
+              ret="$NNN_PREVIEWDIR/$target.jpg" ;;
+          *) ret="$target" ;;
+        esac
+    fi
+    for file in "$dir"/*; do
+        if [ ! -f "$NNN_PREVIEWDIR$file.jpg" ]; then
+            case "$(file -bL --mime-type -- "$file")" in
+                audio/*) [ "$1" != "sxiv" ] &&
+                    ffmpeg -i "$file" "$NNN_PREVIEWDIR$file.jpg" -y >/dev/null 2>&1 ;;
+                video/*) [ "$1" != "ucollage" ] &&
+                    ffmpegthumbnailer -i "$file" -o "$NNN_PREVIEWDIR$file.jpg" 2> /dev/null ;;
+            esac
+        fi
+    done
+    for file in "$NNN_PREVIEWDIR$dir"/*; do
+        filename="$(basename "$file" .jpg)"
+        [ ! -e "$dir/$filename" ] && rm -- "$file" 2>/dev/null
+    done
+}
+
+listimages() {
+    find -L "$dir" "$NNN_PREVIEWDIR$dir" -maxdepth 1 -type f -print0 2>/dev/null | sort -z
+}
+
+view_files() {
+    [ -f "$target" ] && count="-n $(listimages | grep -a -m 1 -ZznF "$target" | cut -d: -f1)"
+    case "$1" in
+        nsxiv) listimages | xargs -0 nsxiv -a "${count:--t}" -- ;;
+        sxiv) listimages | xargs -0 sxiv -a "${count:--t}" -- ;;
+        imv*) listimages | xargs -0 "$1" "${count:-}" -- ;;
+    esac
+}
+
+target="$(readlink -f "$1")"
+[ -d "$target" ] && dir="$target" || dir="${target%/*}"
+if uname | grep -q "Darwin"; then
+    [ -f "$1" ] && open "$1" >/dev/null 2>&1 &
+elif type lsix >/dev/null 2>&1; then
+    if [ -d "$target" ]; then
+        cd "$target" || exit_prompt
+    fi
+    make_thumbs lsix
+    clear
+    lsix
+    cd "$NNN_PREVIEWDIR$dir" && lsix
+    exit_prompt
+elif type ucollage >/dev/null 2>&1; then
+    type ffmpeg >/dev/null 2>&1 && make_thumbs ucollage
+    UCOLLAGE_EXPAND_DIRS=1 ucollage "$dir" "$NNN_PREVIEWDIR$dir" || exit_prompt
+elif type sxiv >/dev/null 2>&1; then
+    type ffmpegthumbnailer >/dev/null 2>&1 && make_thumbs sxiv
+    view_files sxiv >/dev/null 2>&1 &
+elif type nsxiv >/dev/null 2>&1; then
+    type ffmpegthumbnailer >/dev/null 2>&1 && make_thumbs sxiv
+    view_files nsxiv >/dev/null 2>&1 &
+elif type imv >/dev/null 2>&1; then
+    make_thumbs imv
+    view_files imv >/dev/null 2>&1 &
+elif type imvr >/dev/null 2>&1; then
+    make_thumbs imv
+    view_files imvr >/dev/null 2>&1 &
+elif type viu >/dev/null 2>&1; then
+    clear
+    make_thumbs viu
+    viu -n "$ret"
+    exit_prompt
+elif type catimg >/dev/null 2>&1; then
+    make_thumbs catimg
+    catimg "$ret"
+    exit_prompt
+else
+    exit_prompt "Please install sxiv/nsxiv/imv/viu/catimg/lsix."
+fi

plugins/ipinfo

@@ -0,0 +1,13 @@
+#!/usr/bin/env sh
+
+# Description: Shows the external IP address and whois information. Useful over VPNs.
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+IP=$(curl -s ifconfig.me)
+
+whois "$IP"
+echo your external IP address is "$IP"
+
+read -r _

plugins/kdeconnect

@@ -0,0 +1,66 @@
+#!/usr/bin/env sh
+
+# Description: Send files or folders to your Android device using kdeconnect-cli.
+#              kdeconnect must be configured on the Android device and the PC.
+#
+# Usage:
+#   - Hover over a file or a folder and call the plugin.
+#   - Alternatively, select the files and folders you would like to send, and activate the plugin.
+#
+# Shell: POSIX compliant
+# Author: juacq97, raffaem, N-R-K
+
+# If you want system notification, put this equal to 1
+notify=0
+
+note() {
+	if [ $notify = 1 ]; then
+		notify-send -a "Kdeconnect" "$1"
+	else
+		echo "[Kdeconnect] $1"
+	fi
+}
+
+# kdeconnect doesn't cope with non-files
+filter_files() {
+	xargs -0 -I{} sh -c '
+		if [ -f "{}" ]; then
+			printf "%s\0" "{}";
+		else
+			printf "Error: not a regular file: %s\n" "{}" >&2;
+		fi;'
+}
+
+send() {
+	filter_files | xargs -0 -I{} kdeconnect-cli --name "$devname" --share {}
+	note "Files sent"
+}
+
+# Select paired device
+names=$(kdeconnect-cli --list-available --name-only 2>/dev/null)
+if [ -z "$names" ]; then
+	note "No devices paired and available"
+	exit
+fi
+
+ndevs=$(printf "%s" "$names" | awk 'END{print NR}')
+if [ "$ndevs" -eq 1 ]; then
+	devname="$names"
+else
+	printf "%s" "$names" | awk '{ print NR ". " $0 }'
+	printf "Pick a device: "
+	read -r pick
+	if [ -n "$pick" ] && [ "$pick" -eq "$pick" ]; then
+		devname=$(printf '%s' "$names" | awk "NR==$pick")
+	fi
+fi
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+if [ -s "$selection" ]; then
+	send < "$selection"
+	[ -p "$NNN_PIPE" ] && printf "-" > "$NNN_PIPE" # clear selection
+elif [ -n "$1" ]; then
+	printf "%s" "$1" | send
+else
+	note "No selection and no hovered file"
+fi

plugins/launch

@@ -0,0 +1,42 @@
+#!/usr/bin/env sh
+
+# Description: Independent POSIX-compliant GUI application launcher.
+#              Fuzzy find executables in $PATH and launch an application.
+#              stdin, stdout, stderr are suppressed so CLI tools exit silently.
+#
+#              To configure launch as an independent app launcher add a keybind
+#              to open launch in a terminal e.g.,
+#
+#              xfce4-terminal -e "${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins/launch
+#
+# Dependencies: fzf
+#
+# Usage: launch [delay]
+#        delay is in seconds, if omitted launch waits for 1 sec
+#
+# Integration with nnn: launch is installed with other plugins, nnn picks it up.
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+# shellcheck disable=SC2086
+
+IFS=':'
+
+get_selection() {
+    if type fzf >/dev/null 2>&1; then
+        { IFS=':'; ls -H $PATH; } | sort | fzf
+    else
+        exit 1
+    fi
+}
+
+if selection=$( get_selection ); then
+    setsid "$selection" 2>/dev/null 1>/dev/null &
+
+    if [ -n "$1" ]; then
+        sleep "$1"
+    else
+        sleep 1
+    fi
+fi

plugins/mimelist

@@ -0,0 +1,23 @@
+#!/usr/bin/env sh
+
+# Description: Find and list files by mime type in smart context
+#
+# Dependencies:
+#   - file
+#   - mimetype (optional, PERL File MimeInfo)
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana, Michel DHOOGE
+
+# shellcheck disable=SC1090,SC1091
+. "$(dirname "$0")"/.nnn-plugin-helper
+
+printf "mime (e.g., video/audio/image): "
+read -r mime
+
+printf "%s" "+l" > "$NNN_PIPE"
+if type mimetype >/dev/null 2>&1; then
+    find . | mimetype -f - | grep "$mime" | awk -F: '{printf "%s%c", $1, 0}' > "$NNN_PIPE"
+else
+    find . | file -if- | grep "$mime" | awk -F: '{printf "%s%c", $1, 0}' > "$NNN_PIPE"
+fi

plugins/moclyrics

@@ -0,0 +1,40 @@
+#!/usr/bin/env sh
+
+# Description: Fetches the lyrics of the track currently playing in MOC
+#
+# Dependencies: ddgr (https://github.com/jarun/ddgr)
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+# Check if MOC server is running
+cmd=$(pgrep -x mocp 2>/dev/null)
+ret=$cmd
+if [ -z "$ret" ]; then
+    exit
+fi
+
+# Grab the output
+out="$(mocp -i)"
+
+# Check if anything is playing
+state=$(echo "$out" | grep "State:" | cut -d' ' -f2)
+if ! [ "$state" = 'PLAY' ]; then
+    exit
+fi
+
+# Try by Artist and Song Title first
+ARTIST="$(echo "$out" | grep 'Artist:' | cut -d':' -f2 | sed 's/^[[:blank:]]*//;s/[[:blank:]]*$//')"
+TITLE="$(echo "$out" | grep 'SongTitle:' | cut -d':' -f2 | sed 's/^[[:blank:]]*//;s/[[:blank:]]*$//')"
+
+if [ -n "$ARTIST" ] && [ -n "$TITLE" ]; then
+    ddgr -w azlyrics.com --ducky "$ARTIST" "$TITLE"
+else
+    # Try by file name
+    FILENAME="$(basename "$(echo "$out" | grep 'File:' | cut -d':' -f2)")"
+    FILENAME="$(echo "${FILENAME%%.*}" | tr -d -)"
+
+    if [ -n "$FILENAME" ]; then
+        ddgr -w azlyrics.com --ducky "$FILENAME"
+    fi
+fi

plugins/mocq

@@ -0,0 +1,89 @@
+#!/usr/bin/env sh
+
+# Description: Appends and optionally plays music in MOC
+#
+# Notes:
+#   - if selection is available, plays it, else plays the current file or directory
+#   - appends tracks and exits is MOC is running, else clears playlist and adds tracks
+#   - to let mocp shuffle tracks, set SHUFFLE=1
+#
+# Shell: POSIX compliant
+# Authors: Arun Prakash Jana, ath3
+
+IFS="$(printf '\n\r')"
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+cmd=$(pgrep -x mocp 2>/dev/null)
+ret=$cmd
+
+SHUFFLE="${SHUFFLE:-0}"
+
+mocp_add ()
+{
+    if [ "$SHUFFLE" = 1 ]; then
+        if [ "$resp" = "y" ]; then
+            arr=$(tr '\0' '\n' < "$selection")
+        elif [ -n "$1" ]; then
+            arr="$1"
+        fi
+
+        for entry in $arr
+        do
+            if [ -d "$entry" ]; then
+                arr2=$arr2$(find "$entry" -type f \( ! -iname "*.m3u" ! -iname "*.pls" \))
+            elif echo "$entry" | grep -qv '\.m3u$\|\.pls$' ; then
+                arr2=$(printf "%s\n%s" "$entry" "$arr2")
+            fi
+        done
+
+        mocp -o shuffle
+        echo "$arr2" | xargs -d "\n" mocp -a
+    else
+        if [ "$resp" = "y" ]; then
+            xargs < "$selection" -0 mocp -a
+        else
+            mocp -a "$1"
+        fi
+    fi
+}
+
+if [ ! -s "$selection" ] && [ -z "$1" ]; then
+   exit
+fi
+
+if [ "$2" = "opener" ]; then
+    :
+elif [ -s "$selection" ]; then
+    printf "Work with selection? Enter 'y' to confirm: "
+    read -r resp
+fi
+
+if [ -z "$ret" ]; then
+    # mocp not running
+    mocp -S
+else
+    # mocp running, check if it's playing
+    state=$(mocp -i | grep "State:" | cut -d' ' -f2)
+
+    if [ "$state" = 'PLAY' ]; then
+        # add to playlist and exit
+        mocp_add "$1"
+
+        # uncomment the line below to show mocp interface after appending
+        # mocp
+
+        exit
+    fi
+fi
+
+# clear selection and play
+mocp -c
+mocp_add "$1" "$resp"
+mocp -p
+
+# uncomment the line below to show mocp interface after appending
+# mocp
+
+# Clear selection
+if [ "$resp" = "y" ] && [ -p "$NNN_PIPE" ]; then
+    printf "-" > "$NNN_PIPE"
+fi

plugins/mp3conv

@@ -0,0 +1,41 @@
+#!/usr/bin/env sh
+
+# Description: Extract audio from multimedia files and convert to mp3
+#
+# Dependencies: ffmpeg compiled with libmp3lame audio codec support
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+outdir=_mp3files
+
+handle_multimedia() {
+    mime="${1}"
+    file="${2}"
+
+    case "${mime}" in
+        audio/* | video/*)
+            ffmpeg -i "${file}" -vn -codec:a libmp3lame -q:a 2 "${outdir}/${file%.*}.mp3"
+            ;;
+        *)
+            ;;
+    esac
+}
+
+printf "Process 'a'll in directory or 'c'urrent? "
+read -r resp
+
+if [ "$resp" = "a" ]; then
+    if ! [ -e "${outdir}" ]; then
+        mkdir "${outdir}"
+    fi
+
+    for f in *; do
+        if [ -f "${f}" ]; then
+            mimestr="$( file --dereference --brief --mime-type -- "${f}" )"
+            handle_multimedia "${mimestr}" "${f}"
+        fi
+    done
+elif [ "$resp" = "c" ] && [ -f "$1" ]; then
+    ffmpeg -i "${1}" -vn -codec:a libmp3lame -q:a 2 "${1%.*}.mp3"
+fi

plugins/mtpmount

@@ -0,0 +1,76 @@
+#!/usr/bin/env sh
+
+# Description: Toggle mount of MTP device (eg. Android device)
+#              'l' to list mountable devices
+#              'n' integer associated to device to mount
+#              'q'/'Return' exit
+#
+# Dependencies: gvfs-mtp
+#
+# Notes: The MTP device should be mounted at /run/user/$UID/gvfs.
+#        Put /run/user/$UID/gvfs to bookmark entries (NNN_BMS) for faster access.
+#        Make sure the device is unlocked when mounting.
+#
+#        When doing copy-paste into MTP device, you will get an error like this:
+#            cp: preserving times for './gambar1.png': Operation not supported
+#        That just means the file is copied but timestamp won't be preserved.
+#        It's like doing `cp -p localfile.txt file-to-SMB.txt`.
+#
+# Shell: POSIX compliant
+# Author: Benawi Adha
+
+prompt="Device number ('l' to list): "
+
+IFS='
+'
+
+lsmtp () {
+    devs=$(gio mount -li | grep -e 'activation_root' | sed 's/\s*activation_root=//g')
+    c=1
+    printf "Devices list:\n"
+    for i in $devs; do
+        printf "%s %s\\n" "$c" "$i"
+        c=$(( c + 1 ))
+    done
+    echo
+}
+
+lsmtp
+printf "%s" "$prompt"
+read -r input
+
+while [ -n "$input" ]
+do
+    if [ "$input" = "l" ]; then
+        lsmtp
+    elif [ "$input" = "q" ] || [ "$input" -eq 0 ]; then
+        exit
+    elif [ "$input" -le "$(printf '%s\n' "${devs}" | grep -c '^')" ]; then
+        # dev=$(printf "%s\n" "$devs" | cut -d$'\n' -f${input})
+        c=1
+        for i in $devs; do
+            dev=$i
+            if [ "$input" -eq $c ]; then
+                break
+            fi
+            c=$(( c + 1 ))
+        done
+
+        if (gio mount -l | grep '^Mount([1-9]).*'"$dev" ) 1>/dev/null; then
+            if gio mount -u "${dev}"; then
+                printf "%s unmounted\n" "$dev"
+            fi
+        else
+            if gio mount "${dev}"; then
+                printf "%s mounted to /run/user/\$UID/gvfs\n" "$dev"
+            fi
+        fi
+        echo
+    else
+        printf "Invalid input\n"
+    fi
+
+    printf "%s" "$prompt"
+    read -r input
+done
+

plugins/nbak

@@ -0,0 +1,75 @@
+#!/usr/bin/env sh
+
+# Description: Backup nnn configuration
+#              - config dir content
+#              - environment config
+#              - shell functions and aliases
+#
+# Shell: POSIX compliant
+# Author: Léo Villeveygoux
+
+nnn_aliases="n nnn"
+
+outdir="nnn-$(whoami)@$(hostname)"
+
+outfile="${outdir}.tar.bz2"
+
+shellname="$(basename "$SHELL")"
+
+conffile="config.txt"
+
+configdir="${XDG_CONFIG_HOME:-$HOME/.config}/nnn"
+
+workdir="$PWD"
+
+tempdir="$(mktemp -d)"
+
+mkdir "$tempdir/$outdir"
+
+if [ ! -d "$tempdir" ]; then
+	echo "Can't create work directory." >&2
+	exit 1
+fi
+
+cd "$tempdir/$outdir" || exit 1
+
+# Backing up config dir content
+cp -r -- "$configdir" . || exit 1
+
+# Environment config
+env | sed "s/'/'\\\\''/" |\
+	awk '/^NNN_/{print "export '\''"$0"'\''"}' > "$conffile"
+
+# Shell functions/aliases
+case "$shellname" in
+	bash)
+		for name in $nnn_aliases ; do
+			if [ "$(bash -ic "type -t $name")" = "function" ] ; then
+				bash -ic "type $name" | tail -n+2 >> "$conffile"
+			elif bash -ic "alias $name" >/dev/null 2>&1 ; then
+				bash -ic "alias $name" >> "$conffile"
+			fi
+		done
+		;;
+	zsh)
+		for name in $nnn_aliases ; do
+			if zsh -ic "functions $name" ; then
+				zsh -ic "functions $name" >> "$conffile"
+			elif zsh -ic "alias $name" ; then
+				echo alias "$(zsh -ic "alias $name")" >> "$conffile"
+			fi
+		done
+		;;
+
+	*)
+		echo "Unknown shell, skipping alias/function checking." >&2
+		;;
+esac
+
+cd .. || exit 1
+
+printf "Saving as '%s' ... " "$workdir/$outfile"
+
+tar caf "$workdir/$outfile" "$outdir" && echo "Done" || echo "Failed"
+
+cd "$workdir" && rm -rf -- "$tempdir"

plugins/nmount

@@ -0,0 +1,88 @@
+#!/usr/bin/env sh
+
+# Description: Toggle mount status of a device using pmount
+#              If the device is not mounted, it will be mounted.
+#              If the device is mounted, it will be unmounted and powered down.
+#
+# Dependencies: lsblk, pmount (optional), udisks2
+#
+# Usage: Runs `lsblk` on 'l', exits on 'Return`.
+#
+# Notes:
+#   - The script uses Linux-specific lsblk to list block devices. Alternatives:
+#       macOS: "diskutil list"
+#       BSD: "geom disk list"
+#   - The script uses udisksctl (from udisks2) to power down devices. This is also Linux-specific.
+#     Users on non-Linux platforms can comment it and use an alternative to power-down disks.
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+prompt="device name [e.g. sdXn] ('l'ist, 'q'uit): "
+
+lsblk
+
+printf "\nEnsure you aren't still in the mounted device.\n"
+printf "%s" "$prompt"
+read -r dev
+
+while [ -n "$dev" ]; do
+    if [ "$dev" = "l" ]; then
+        lsblk
+    elif [ "$dev" = "q" ]; then
+        exit
+    else
+        # LUKS volumes mounted with udisksctl appear differently than with pmount
+        if grep -qs "$dev " /proc/mounts || [ -n "$(lsblk -n "/dev/$dev" -o MOUNTPOINT)" ]; then
+            sync "$(lsblk -n "/dev/$dev" -o MOUNTPOINT | sed "/^$/d")"
+            if type pumount >/dev/null 2>&1; then
+                pumount "/dev/$dev"
+                exit_code="$?"
+            else
+                # Unlike pmount, udisksctl does not transparently handle LUKS volumes
+                # We need to manually get the unlocked device, unmount it, and then lock the volume
+                if lsblk -n "/dev/$dev" -o FSTYPE | grep "crypto_LUKS" >/dev/null; then
+                    dev_map="$(udisksctl info -b /dev/"$dev" | grep "CleartextDevice" | grep -o "dm_2d[[:digit:]]*" | sed "s/_2d/-/")"
+                    udisksctl unmount -b "/dev/$dev_map" --no-user-interaction >/dev/null
+                    exit_code="$?"
+                    udisksctl lock -b "/dev/$dev" --no-user-interaction >/dev/null
+                else
+                    udisksctl unmount -b "/dev/$dev" --no-user-interaction >/dev/null
+                    exit_code="$?"
+                fi
+            fi
+            if [ $exit_code -eq 0 ]; then
+                echo "/dev/$dev unmounted."
+                if udisksctl power-off -b "/dev/$dev" --no-user-interaction; then
+                    echo "/dev/$dev ejected."
+                fi
+            fi
+        elif [ -b "/dev/$dev" ]; then
+            if type pmount >/dev/null 2>&1; then
+                pmount "/dev/$dev"
+                exit_code="$?"
+            else
+                # Unlike pmount, udisksctl does not transparently handle LUKS volumes
+                # We need to manually get the unlocked device and mount that instead of the volume itself
+                if [ "$(lsblk "/dev/$dev" -n -o FSTYPE)" = "crypto_LUKS" ]; then
+                    dev_map=$(udisksctl unlock -b "/dev/$dev" --no-user-interaction | grep -o "dm-[[:digit:]]*")
+                    udisksctl mount -b "/dev/$dev_map" --no-user-interaction >/dev/null
+                    exit_code="$?"
+                else
+                    udisksctl mount -b "/dev/$dev" --no-user-interaction >/dev/null
+                    exit_code="$?"
+                fi
+            fi
+            if [ $exit_code -eq 0 ]; then
+                sleep 1
+                echo "/dev/$dev mounted to $(lsblk -n "/dev/$dev" -o MOUNTPOINT | sed "/^$/d")."
+            fi
+        else
+            echo "/dev/$dev does not exist or is not a block device."
+        fi
+    fi
+
+    echo
+    printf "%s" "$prompt"
+    read -r dev
+done

plugins/nuke

@@ -0,0 +1,555 @@
+#!/usr/bin/env sh
+
+# Description: Sample script to play files in apps by file type or mime
+#
+# Shell: POSIX compliant
+# Usage: nuke filepath
+#
+# Integration with nnn:
+#   1. Export the required config:
+#         export NNN_OPENER=/absolute/path/to/nuke
+#         # Otherwise, if nuke is in $PATH
+#         # export NNN_OPENER=nuke
+#   2. Run nnn with the program option to indicate a CLI opener
+#         nnn -c
+#         # The -c program option overrides option -e
+#   3. nuke can use nnn plugins (e.g. mocq is used for audio), $PATH is updated.
+#
+# Details:
+#   Inspired by ranger's scope.sh, modified for usage with nnn.
+#
+#   Guards against accidentally opening mime types like executables, shared libs etc.
+#
+#   Tries to play 'file' (1st argument) in the following order:
+#     1. by extension
+#     2. by mime (image, video, audio, pdf)
+#     3. by mime (other file types)
+#     4. by mime (prompt and run executables)
+#
+# Modification tips:
+#   1. Invokes CLI utilities by default. Set GUI to 1 to enable GUI apps.
+#   2. PAGER is "less -R".
+#   3. Start GUI apps in bg to unblock. Redirect stdout and strerr if required.
+#   4. Some CLI utilities are piped to the $PAGER, to wait and quit uniformly.
+#   5. If the output cannot be paged use "read -r _" to wait for user input.
+#   6. On a DE, try 'xdg-open' or 'open' in handle_fallback() as last resort.
+#
+#   Feel free to change the utilities to your favourites and add more mimes.
+#
+# Defaults:
+#   By extension (only the enabled ones):
+#      most archives: list with atool, bsdtar
+#      rar: list with unrar
+#      7-zip: list with 7z
+#      pdf: zathura (GUI), pdftotext, mutool, exiftool
+#      audio: mocq (nnn plugin using MOC), mpv, media_client (Haiku), mediainfo, exiftool
+#      avi|mkv|mp4: smplayer, mpv (GUI), ffmpegthumbnailer, mediainfo, exiftool
+#      log: vi
+#      torrent: rtorrent, transmission-show
+#      odt|ods|odp|sxw: odt2txt
+#      md: glow (https://github.com/charmbracelet/glow), lowdown (https://kristaps.bsd.lv/lowdown)
+#      htm|html|xhtml: w3m, lynx, elinks
+#      json: jq, python (json.tool module)
+#   Multimedia by mime:
+#      image/*: imv/sxiv/nsxiv (GUI), viu (https://github.com/atanunq/viu), img2txt, exiftool
+#      video/*: smplayer, mpv (GUI), ffmpegthumbnailer, mediainfo, exiftool
+#      audio/*: mocq (nnn plugin using MOC), mpv, media_client (Haiku), mediainfo, exiftool
+#      application/pdf: zathura (GUI), pdftotext, mutool, exiftool
+#   Other mimes:
+#      text/troff: man -l
+#      text/* | */xml: vi
+#      image/vnd.djvu): djvutxt, exiftool
+#
+# TODO:
+#   1. Adapt, test and enable all mimes
+#   2. Clean-up the unnecessary exit codes
+
+# set to 1 to enable GUI apps and/or BIN execution
+GUI="${GUI:-0}"
+BIN="${BIN:-0}"
+
+set -euf -o noclobber -o noglob -o nounset
+IFS="$(printf '%b_' '\n')"; IFS="${IFS%_}" # protect trailing \n
+
+PATH=$PATH:"${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins"
+IMAGE_CACHE_PATH="$(dirname "$1")"/.thumbs
+
+FPATH="$1"
+FNAME=$(basename "$1")
+EDITOR="${VISUAL:-${EDITOR:-vi}}"
+PAGER="${PAGER:-less -R}"
+ext="${FNAME##*.}"
+if [ -n "$ext" ]; then
+    ext="$(printf "%s" "${ext}" | tr '[:upper:]' '[:lower:]')"
+fi
+
+is_mac() {
+    uname | grep -q "Darwin"
+}
+
+handle_pdf() {
+    if [ "$GUI" -ne 0 ]; then
+        if is_mac; then
+            nohup open "${FPATH}" >/dev/null 2>&1 &
+        elif type zathura >/dev/null 2>&1; then
+            nohup zathura "${FPATH}" >/dev/null 2>&1 &
+        else
+            return
+        fi
+    elif type pdftotext >/dev/null 2>&1; then
+        ## Preview as text conversion
+        pdftotext -l 10 -nopgbrk -q -- "${FPATH}" - | eval "$PAGER"
+    elif type mutool >/dev/null 2>&1; then
+        mutool draw -F txt -i -- "${FPATH}" 1-10 | eval "$PAGER"
+    elif type exiftool >/dev/null 2>&1; then
+        exiftool "${FPATH}" | eval "$PAGER"
+    else
+        return
+    fi
+    exit 0
+}
+
+handle_audio() {
+    if type mocp >/dev/null 2>&1 && type mocq >/dev/null 2>&1; then
+        mocq "${FPATH}" "opener" >/dev/null 2>&1
+    elif type mpv >/dev/null 2>&1; then
+        mpv "${FPATH}" >/dev/null 2>&1 &
+    elif type media_client >/dev/null 2>&1; then
+        media_client play "${FPATH}" >/dev/null 2>&1 &
+    elif type mediainfo >/dev/null 2>&1; then
+        mediainfo "${FPATH}" | eval "$PAGER"
+    elif type exiftool >/dev/null 2>&1; then
+        exiftool "${FPATH}"| eval "$PAGER"
+    else
+        return
+    fi
+    exit 0
+}
+
+handle_video() {
+    if [ "$GUI" -ne 0 ]; then
+        if is_mac; then
+            nohup open "${FPATH}" >/dev/null 2>&1 &
+        elif type smplayer >/dev/null 2>&1; then
+            nohup smplayer "${FPATH}" >/dev/null 2>&1 &
+        elif type mpv >/dev/null 2>&1; then
+            nohup mpv "${FPATH}" >/dev/null 2>&1 &
+        else
+            return
+        fi
+    elif type ffmpegthumbnailer >/dev/null 2>&1; then
+        # Thumbnail
+        [ -d "${IMAGE_CACHE_PATH}" ] || mkdir "${IMAGE_CACHE_PATH}"
+        ffmpegthumbnailer -i "${FPATH}" -o "${IMAGE_CACHE_PATH}/${FNAME}.jpg" -s 0
+        viu -n "${IMAGE_CACHE_PATH}/${FNAME}.jpg" | eval "$PAGER"
+    elif type mediainfo >/dev/null 2>&1; then
+        mediainfo "${FPATH}" | eval "$PAGER"
+    elif type exiftool >/dev/null 2>&1; then
+        exiftool "${FPATH}"| eval "$PAGER"
+    else
+        return
+    fi
+    exit 0
+}
+
+# handle this extension and exit
+handle_extension() {
+    case "${ext}" in
+        ## Archive
+        a|ace|alz|arc|arj|bz|bz2|cab|cpio|deb|gz|jar|lha|lz|lzh|lzma|lzo|\
+        rpm|rz|t7z|tar|tbz|tbz2|tgz|tlz|txz|tZ|tzo|war|xpi|xz|Z|zip)
+            if type atool >/dev/null 2>&1; then
+                atool --list -- "${FPATH}" | eval "$PAGER"
+                exit 0
+            elif type bsdtar >/dev/null 2>&1; then
+                bsdtar --list --file "${FPATH}" | eval "$PAGER"
+                exit 0
+            fi
+            exit 1;;
+        rar)
+            if type unrar >/dev/null 2>&1; then
+                ## Avoid password prompt by providing empty password
+                unrar lt -p- -- "${FPATH}" | eval "$PAGER"
+            fi
+            exit 1;;
+        7z)
+            if type 7z >/dev/null 2>&1; then
+                ## Avoid password prompt by providing empty password
+                7z l -p -- "${FPATH}" | eval "$PAGER"
+                exit 0
+            fi
+            exit 1;;
+
+        ## PDF
+        pdf)
+            handle_pdf
+            exit 1;;
+
+        ## Audio
+        aac|flac|m4a|mid|midi|mpa|mp2|mp3|ogg|wav|wma)
+            handle_audio
+            exit 1;;
+
+        ## Video
+        avi|mkv|mp4)
+            handle_video
+            exit 1;;
+
+        ## Log files
+        log)
+            "$EDITOR" "${FPATH}"
+            exit 0;;
+
+        ## BitTorrent
+        torrent)
+            if type rtorrent >/dev/null 2>&1; then
+                rtorrent "${FPATH}"
+                exit 0
+            elif type transmission-show >/dev/null 2>&1; then
+                transmission-show -- "${FPATH}"
+                exit 0
+            fi
+            exit 1;;
+
+        ## OpenDocument
+        odt|ods|odp|sxw)
+            if type odt2txt >/dev/null 2>&1; then
+                ## Preview as text conversion
+                odt2txt "${FPATH}" | eval "$PAGER"
+                exit 0
+            fi
+            exit 1;;
+
+        ## Markdown
+        md)
+            if type glow >/dev/null 2>&1; then
+                glow -sdark "${FPATH}" | eval "$PAGER"
+                exit 0
+            elif type lowdown >/dev/null 2>&1; then
+                lowdown -Tterm "${FPATH}" | eval "$PAGER"
+                exit 0
+            fi
+            ;;
+
+        ## HTML
+        htm|html|xhtml)
+            ## Preview as text conversion
+            if type w3m >/dev/null 2>&1; then
+                w3m -dump "${FPATH}" | eval "$PAGER"
+                exit 0
+            elif type lynx >/dev/null 2>&1; then
+                lynx -dump -- "${FPATH}" | eval "$PAGER"
+                exit 0
+            elif type elinks >/dev/null 2>&1; then
+                elinks -dump "${FPATH}" | eval "$PAGER"
+                exit 0
+            fi
+            ;;
+
+        ## JSON
+        json)
+            if type jq >/dev/null 2>&1; then
+                jq --color-output . "${FPATH}" | eval "$PAGER"
+                exit 0
+            elif type python >/dev/null 2>&1; then
+                python -m json.tool -- "${FPATH}" | eval "$PAGER"
+                exit 0
+            fi
+            ;;
+    esac
+}
+
+# sets the variable abs_target, this should be faster than calling printf
+abspath() {
+    case "$1" in
+        /*) abs_target="$1";;
+        *)  abs_target="$PWD/$1";;
+    esac
+}
+
+# storing the result to a tmp file is faster than calling listimages twice
+listimages() {
+    find -L "///${1%/*}" -maxdepth 1 -type f -print0 |
+        grep -izZE '\.(jpe?g|png|gif|webp|tiff|bmp|ico|svg)$' |
+        sort -zV | tee "$tmp"
+}
+
+load_dir() {
+    abspath "$2"
+    tmp="${TMPDIR:-/tmp}/nuke_$$"
+    trap 'rm -f -- "$tmp"' EXIT
+    count="$(listimages "$abs_target" | grep -a -m 1 -ZznF "$abs_target" | cut -d: -f1)"
+
+    if [ -n "$count" ]; then
+        if [ "$GUI" -ne 0 ]; then
+            xargs -0 nohup "$1" -n "$count" -- < "$tmp"
+        else
+            xargs -0 "$1" -n "$count" -- < "$tmp"
+        fi
+    else
+        shift
+        "$1" -- "$@" # fallback
+    fi
+}
+
+handle_multimedia() {
+    ## Size of the preview if there are multiple options or it has to be
+    ## rendered from vector graphics. If the conversion program allows
+    ## specifying only one dimension while keeping the aspect ratio, the width
+    ## will be used.
+    # local DEFAULT_SIZE="1920x1080"
+
+    mimetype="${1}"
+    case "${mimetype}" in
+        ## SVG
+        # image/svg+xml|image/svg)
+        #     convert -- "${FPATH}" "${IMAGE_CACHE_PATH}" && exit 6
+        #     exit 1;;
+
+        ## DjVu
+        # image/vnd.djvu)
+        #     ddjvu -format=tiff -quality=90 -page=1 -size="${DEFAULT_SIZE}" \
+        #           - "${IMAGE_CACHE_PATH}" < "${FPATH}" \
+        #           && exit 6 || exit 1;;
+
+        ## Image
+        image/*)
+            if [ "$GUI" -ne 0 ]; then
+                if is_mac; then
+                    nohup open "${FPATH}" >/dev/null 2>&1 &
+                    exit 0
+                elif type imv >/dev/null 2>&1; then
+                    load_dir imv "${FPATH}" >/dev/null 2>&1 &
+                    exit 0
+                elif type imvr >/dev/null 2>&1; then
+                    load_dir imvr "${FPATH}" >/dev/null 2>&1 &
+                    exit 0
+                elif type sxiv >/dev/null 2>&1; then
+                    load_dir sxiv "${FPATH}" >/dev/null 2>&1 &
+                    exit 0
+                elif type nsxiv >/dev/null 2>&1; then
+                    load_dir nsxiv "${FPATH}" >/dev/null 2>&1 &
+                    exit 0
+                fi
+            elif type viu >/dev/null 2>&1; then
+                viu -n "${FPATH}" | eval "$PAGER"
+                exit 0
+            elif type img2txt >/dev/null 2>&1; then
+                img2txt --gamma=0.6 -- "${FPATH}" | eval "$PAGER"
+                exit 0
+            elif type exiftool >/dev/null 2>&1; then
+                exiftool "${FPATH}" | eval "$PAGER"
+                exit 0
+            fi
+            # local orientation
+            # orientation="$( identify -format '%[EXIF:Orientation]\n' -- "${FPATH}" )"
+            ## If orientation data is present and the image actually
+            ## needs rotating ("1" means no rotation)...
+            # if [[ -n "$orientation" && "$orientation" != 1 ]]; then
+                ## ...auto-rotate the image according to the EXIF data.
+                # convert -- "${FPATH}" -auto-orient "${IMAGE_CACHE_PATH}" && exit 6
+            # fi
+
+            ## `w3mimgdisplay` will be called for all images (unless overridden
+            ## as above), but might fail for unsupported types.
+            exit 7;;
+
+        ## PDF
+        application/pdf)
+            handle_pdf
+            exit 1;;
+
+        ## Audio
+        audio/*)
+            handle_audio
+            exit 1;;
+
+        ## Video
+        video/*)
+            handle_video
+            exit 1;;
+
+        #     pdftoppm -f 1 -l 1 \
+        #              -scale-to-x "${DEFAULT_SIZE%x*}" \
+        #              -scale-to-y -1 \
+        #              -singlefile \
+        #              -jpeg -tiffcompression jpeg \
+        #              -- "${FPATH}" "${IMAGE_CACHE_PATH%.*}" \
+        #         && exit 6 || exit 1;;
+
+
+        ## ePub, MOBI, FB2 (using Calibre)
+        # application/epub+zip|application/x-mobipocket-ebook|\
+        # application/x-fictionbook+xml)
+        #     # ePub (using https://github.com/marianosimone/epub-thumbnailer)
+        #     epub-thumbnailer "${FPATH}" "${IMAGE_CACHE_PATH}" \
+        #         "${DEFAULT_SIZE%x*}" && exit 6
+        #     ebook-meta --get-cover="${IMAGE_CACHE_PATH}" -- "${FPATH}" \
+        #         >/dev/null && exit 6
+        #     exit 1;;
+
+        ## Font
+        # application/font*|application/*opentype)
+        #     preview_png="/tmp/$(basename "${IMAGE_CACHE_PATH%.*}").png"
+        #     if fontimage -o "${preview_png}" \
+        #                  --pixelsize "120" \
+        #                  --fontname \
+        #                  --pixelsize "80" \
+        #                  --text "  ABCDEFGHIJKLMNOPQRSTUVWXYZ  " \
+        #                  --text "  abcdefghijklmnopqrstuvwxyz  " \
+        #                  --text "  0123456789.:,;(*!?') ff fl fi ffi ffl  " \
+        #                  --text "  The quick brown fox jumps over the lazy dog.  " \
+        #                  "${FPATH}";
+        #     then
+        #         convert -- "${preview_png}" "${IMAGE_CACHE_PATH}" \
+        #             && rm -- "${preview_png}" \
+        #             && exit 6
+        #     else
+        #         exit 1
+        #     fi
+        #     ;;
+
+        ## Preview archives using the first image inside.
+        ## (Very useful for comic book collections for example.)
+        # application/zip|application/x-rar|application/x-7z-compressed|\
+        #     application/x-xz|application/x-bzip2|application/x-gzip|application/x-tar)
+        #     local fn=""; local fe=""
+        #     local zip=""; local rar=""; local tar=""; local bsd=""
+        #     case "${mimetype}" in
+        #         application/zip) zip=1 ;;
+        #         application/x-rar) rar=1 ;;
+        #         application/x-7z-compressed) ;;
+        #         *) tar=1 ;;
+        #     esac
+        #     { [ "$tar" ] && fn=$(tar --list --file "${FPATH}"); } || \
+        #     { fn=$(bsdtar --list --file "${FPATH}") && bsd=1 && tar=""; } || \
+        #     { [ "$rar" ] && fn=$(unrar lb -p- -- "${FPATH}"); } || \
+        #     { [ "$zip" ] && fn=$(zipinfo -1 -- "${FPATH}"); } || return
+        #
+        #     fn=$(echo "$fn" | python -c "import sys; import mimetypes as m; \
+        #             [ print(l, end='') for l in sys.stdin if \
+        #               (m.guess_type(l[:-1])[0] or '').startswith('image/') ]" |\
+        #         sort -V | head -n 1)
+        #     [ "$fn" = "" ] && return
+        #     [ "$bsd" ] && fn=$(printf '%b' "$fn")
+        #
+        #     [ "$tar" ] && tar --extract --to-stdout \
+        #         --file "${FPATH}" -- "$fn" > "${IMAGE_CACHE_PATH}" && exit 6
+        #     fe=$(echo -n "$fn" | sed 's/[][*?\]/\\\0/g')
+        #     [ "$bsd" ] && bsdtar --extract --to-stdout \
+        #         --file "${FPATH}" -- "$fe" > "${IMAGE_CACHE_PATH}" && exit 6
+        #     [ "$bsd" ] || [ "$tar" ] && rm -- "${IMAGE_CACHE_PATH}"
+        #     [ "$rar" ] && unrar p -p- -inul -- "${FPATH}" "$fn" > \
+        #         "${IMAGE_CACHE_PATH}" && exit 6
+        #     [ "$zip" ] && unzip -pP "" -- "${FPATH}" "$fe" > \
+        #         "${IMAGE_CACHE_PATH}" && exit 6
+        #     [ "$rar" ] || [ "$zip" ] && rm -- "${IMAGE_CACHE_PATH}"
+        #     ;;
+    esac
+}
+
+handle_mime() {
+    mimetype="${1}"
+    case "${mimetype}" in
+        ## Manpages
+        text/troff)
+            man -l "${FPATH}"
+            exit 0;;
+
+        ## Text
+        text/* | */xml)
+            "$EDITOR" "${FPATH}"
+            exit 0;;
+            ## Syntax highlight
+            # if [[ "$( stat --printf='%s' -- "${FPATH}" )" -gt "${HIGHLIGHT_SIZE_MAX}" ]]; then
+            #     exit 2
+            # fi
+            # if [[ "$( tput colors )" -ge 256 ]]; then
+            #     local pygmentize_format='terminal256'
+            #     local highlight_format='xterm256'
+            # else
+            #     local pygmentize_format='terminal'
+            #     local highlight_format='ansi'
+            # fi
+            # env HIGHLIGHT_OPTIONS="${HIGHLIGHT_OPTIONS}" highlight \
+            #     --out-format="${highlight_format}" \
+            #     --force -- "${FPATH}" && exit 5
+            # pygmentize -f "${pygmentize_format}" -O "style=${PYGMENTIZE_STYLE}"\
+            #     -- "${FPATH}" && exit 5
+            # exit 2;;
+
+        ## DjVu
+        image/vnd.djvu)
+            if type djvutxt >/dev/null 2>&1; then
+                ## Preview as text conversion (requires djvulibre)
+                djvutxt "${FPATH}" | eval "$PAGER"
+                exit 0
+            elif type exiftool >/dev/null 2>&1; then
+                exiftool "${FPATH}" | eval "$PAGER"
+                exit 0
+            fi
+            exit 1;;
+    esac
+}
+
+handle_fallback() {
+    if [ "$GUI" -ne 0 ]; then
+        if type xdg-open >/dev/null 2>&1; then
+            nohup xdg-open "${FPATH}" >/dev/null 2>&1 &
+            exit 0
+        elif type open >/dev/null 2>&1; then
+            nohup open "${FPATH}" >/dev/null 2>&1 &
+            exit 0
+        fi
+    fi
+
+    echo '----- File details -----' && file --dereference --brief -- "${FPATH}"
+    exit 1
+}
+
+handle_blocked() {
+    case "${MIMETYPE}" in
+        application/x-sharedlib)
+            exit 0;;
+
+        application/x-shared-library-la)
+            exit 0;;
+
+        application/x-executable)
+            exit 0;;
+
+        application/x-shellscript)
+            exit 0;;
+
+        application/octet-stream)
+            exit 0;;
+    esac
+}
+
+handle_bin() {
+    case "${MIMETYPE}" in
+        application/x-executable|application/x-shellscript)
+        clear
+        echo '-------- Executable File --------' && file --dereference --brief -- "${FPATH}"
+        printf "Run executable (y/N/'a'rgs)? "
+        read -r answer
+        case "$answer" in
+            [Yy]* ) exec "${FPATH}";;
+            [Aa]* )
+                printf "args: "
+                read -r args
+                exec "${FPATH}" "$args";;
+            [Nn]* ) exit;;
+        esac
+    esac
+}
+
+MIMETYPE="$( file -bL --mime-type -- "${FPATH}" )"
+handle_extension
+handle_multimedia "${MIMETYPE}"
+handle_mime "${MIMETYPE}"
+[ "$BIN" -ne 0 ] && [ -x "${FPATH}" ] && handle_bin
+handle_blocked "${MIMETYPE}"
+handle_fallback
+
+exit 1

plugins/oldbigfile

@@ -0,0 +1,16 @@
+#!/usr/bin/env sh
+
+# Description: List files bigger than input size by ascending access date.
+#
+# Dependencies: find sort
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+printf "Min file size (MB): "
+read -r size
+
+find . -size +"$size"M -type f -printf '%A+ %s %p\n' | sort
+
+echo "Press any key to exit"
+read -r _

plugins/openall

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+
+# Description: Open selected files in nuke one by one or in oneshot
+#
+# Notes: 1. Opens the hovered file if the selection is empty
+#        2. nuke is the default, set OPENER below for custom
+#        3. Opener is invoked once for each file in a loop
+#        4. Keep pressing "Enter" to open files one by one
+#
+# Shell: bash
+# Author: Arun Prakash Jana
+
+sel=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+OPENER="${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins/nuke"
+
+if [ -s "$sel" ]; then
+    targets=()
+    while IFS= read -r -d '' entry || [ -n "$entry" ]; do
+        targets+=( "$entry" )
+    done < "$sel"
+
+    elements=${#targets[@]}
+
+    if (( elements == 1 )); then
+        # If there's only one file selected, open without prompts
+        "$OPENER" "${targets[0]}"
+    else
+        printf "open [A]ll? "
+        read -r all
+
+        for ((index=0; index <= ${#targets[@]}; index++)); do
+            "$OPENER" "${targets[index]}"
+            if [ "$all" != "A" ] && (( index+1 < elements )); then
+                printf "press Enter to open '%s'\n" "${targets[index+1]}"
+                read -r -s -n 1 key
+                if [[ $key != "" ]]; then
+                    break
+                fi
+            fi
+        done
+    fi
+
+    # Clear selection
+    if [ -s "$sel" ] && [ -p "$NNN_PIPE" ]; then
+        printf "-" > "$NNN_PIPE"
+    fi
+elif [ -n "$1" ]; then
+    "$OPENER" "$1"
+fi

plugins/organize

@@ -0,0 +1,62 @@
+#!/usr/bin/env sh
+
+# Description: Organize files in directories by category
+#
+# Note: This plugin clears the selection as it changes the contents of the current dir
+#
+# Shell: POSIX compliant
+# Author: th3lusive
+
+sel=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+
+organize() {
+    case "$(file -biL "$1")" in
+        *video*)
+            [ ! -d "Videos" ] && mkdir "Videos"
+            mv -- "$1" "Videos/$1"
+            printf "Moved %s to Videos\n" "$1" ;;
+
+        *audio*) [ ! -d "Audio" ] && mkdir "Audio"
+            mv -- "$1" "Audio/$1"
+            printf "Moved %s to Audio\n" "$1" ;;
+
+        *image*)
+            [ ! -d "Images" ] && mkdir "Images"
+            mv -- "$1" "Images/$1"
+            printf "Moved %s to Images\n" "$1" ;;
+
+        *pdf*|*document*|*epub*|*djvu*|*cb*)
+            [ ! -d "Documents" ] && mkdir "Documents"
+            mv -- "$1" "Documents/$1"
+            printf "Moved %s to Documents\n" "$1" ;;
+
+        *text*)
+            [ ! -d "Plaintext" ] && mkdir "Plaintext"
+            mv -- "$1" "Plaintext/$1"
+            printf "Moved %s to Plaintext\n" "$1" ;;
+
+        *tar*|*xz*|*compress*|*7z*|*rar*|*zip*)
+            [ ! -d "Archives" ] && mkdir "Archives"
+            mv -- "$1" "Archives/$1"
+            printf "Moved %s to Archives\n" "$1" ;;
+
+        *binary*)
+            [ ! -d "Binaries" ] && mkdir "Binaries"
+            mv -- "$1" "Binaries/$1"
+            printf "Moved %s to Binaries\n" "$1" ;;
+    esac
+}
+
+main() {
+    for file in *
+    do
+       [ -f "$file" ] && organize "$file"
+    done
+
+    # Clear selection
+    if [ -s "$sel" ] && [ -p "$NNN_PIPE" ]; then
+        printf "-" > "$NNN_PIPE"
+    fi
+}
+
+main "$@"

plugins/pdfread

@@ -0,0 +1,30 @@
+#!/usr/bin/env sh
+
+# Description: Read a text or PDF file in British English
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+if [ -n "$1" ]; then
+    tmpf="$(basename "$1")"
+    tmpf="${TMPDIR:-/tmp}"/"${tmpf%.*}"
+
+    if [ "$(head -c 4 "$1")" = "%PDF" ]; then
+        # Convert using pdftotext
+        pdftotext -nopgbrk -layout "$1" - | sed 's/\xe2\x80\x8b//g' > "$tmpf".txt
+
+        pico2wave -w "$tmpf".wav -l en-GB "$(tr '\n' ' ' < "$tmpf".txt)"
+
+        rm -- "$tmpf".txt
+    else
+        pico2wave -w "$tmpf".wav -l en-GB "$(tr '\n' ' ' < "$1")"
+    fi
+
+    # to jump around and note the time
+    mpv "$tmpf".wav
+
+    # flat read but better quality
+    # play -qV0 "$tmpf".wav treble 2 gain -l 2
+
+    rm -- "$tmpf".wav
+fi

plugins/preview-tabbed

@@ -0,0 +1,231 @@
+#!/usr/bin/env bash
+
+# Description: tabbed/xembed based file previewer
+#
+# Dependencies:
+#   - tabbed (https://tools.suckless.org/tabbed): xembed host
+#   - xterm (or urxvt or st or alacritty) : xembed client for text-based preview
+#   - mpv (https://mpv.io): xembed client for video/audio
+#   - sxiv (https://github.com/muennich/sxiv) or,
+#   - nsxiv (https://codeberg.org/nsxiv/nsxiv) : xembed client for images
+#   - zathura (https://pwmt.org/projects/zathura): xembed client for PDF
+#   - nnn's nuke plugin for text preview and fallback
+#     nuke is a fallback for 'mpv', 'sxiv'/'nsxiv', and 'zathura', but has its
+#     own dependencies, see the script for more information
+#   - vim (or any editor/pager really)
+#   - file
+#   - mktemp
+#   - xdotool (optional, to keep main window focused)
+#
+# Usage:
+#   - Install the dependencies. Then set a NNN_FIFO
+#     and set a key for the plugin, then start `nnn`:
+#       $ NNN_FIFO=/tmp/nnn.fifo nnn
+#   - Launch the plugin with the designated key from nnn
+#
+# Notes:
+#   1. This plugin needs a "NNN_FIFO" to work. See man.
+#   2. If the same NNN_FIFO is used in multiple nnn instances, there will be one
+#      common preview window. With different FIFO paths, they will be independent.
+#   3. This plugin only works on X, not on Wayland.
+#
+# How it works:
+#   We use `tabbed` [1] as a xembed [2] host, to have a single window
+#   owning each previewer window. So each previewer must be a xembed client.
+#   For text previewers, this is not an issue, as there are a lot of
+#   xembed-able terminal emulator (we default to `xterm`, but examples are
+#   provided for `urxvt` and `st`). For graphic preview this can be trickier,
+#   but a few popular viewers are xembed-able, we use:
+#     - `mpv`: multimedia player, for video/audio preview
+#     - `sxiv`/`nsxiv`: image viewer
+#     - `zathura`: PDF viewer
+#     - but we always fallback to `nuke` plugin
+#
+# [1]: https://tools.suckless.org/tabbed/
+# [2]: https://specifications.freedesktop.org/xembed-spec/xembed-spec-latest.html
+#
+# Shell: Bash (job control is weakly specified in POSIX)
+# Author: Léo Villeveygoux
+
+
+XDOTOOL_TIMEOUT=2
+PAGER=${PAGER:-"vim -R"}
+NUKE="${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins/nuke"
+
+if [ -n "$WAYLAND_DISPLAY" ] ; then
+    echo "Wayland is not supported in preview-tabbed, this plugin could freeze your session!" >&2
+    exit 1
+fi
+
+if type xterm >/dev/null 2>&1 ; then
+    TERMINAL="xterm -into"
+elif type urxvt >/dev/null 2>&1 ; then
+    TERMINAL="urxvt -embed"
+elif type st >/dev/null 2>&1 ; then
+    TERMINAL="st -w"
+elif type alacritty >/dev/null 2>&1 ; then
+    TERMINAL="alacritty --embed"
+else
+    echo "No xembed term found" >&2
+fi
+
+if type xdg-user-dir >/dev/null 2>&1 ; then
+    PICTURES_DIR=$(xdg-user-dir PICTURES)
+fi
+
+term_nuke () {
+    # $1 -> $XID, $2 -> $FILE
+    $TERMINAL "$1" -e "$NUKE" "$2" &
+}
+
+start_tabbed () {
+    FIFO="$(mktemp -u)"
+    mkfifo "$FIFO"
+
+    tabbed > "$FIFO" &
+
+    jobs # Get rid of the "Completed" entries
+
+    TABBEDPID="$(jobs -p %%)"
+
+    if [ -z "$TABBEDPID" ] ; then
+        echo "Can't start tabbed"
+        exit 1
+    fi
+
+    read -r XID < "$FIFO"
+
+    rm -- "$FIFO"
+}
+
+get_viewer_pid () {
+        VIEWERPID="$(jobs -p %%)"
+}
+
+kill_viewer () {
+        if [ -n "$VIEWERPID" ] && jobs -p | grep "$VIEWERPID" ; then
+            kill "$VIEWERPID"
+        fi
+}
+
+sigint_kill () {
+	kill_viewer
+	kill "$TABBEDPID"
+	exit 0
+}
+
+previewer_loop () {
+    unset -v NNN_FIFO
+    # mute from now
+    exec >/dev/null 2>&1
+
+    MAINWINDOW="$(xdotool getactivewindow)"
+
+    start_tabbed
+    trap sigint_kill SIGINT
+
+    xdotool windowactivate "$MAINWINDOW"
+
+    # Bruteforce focus stealing prevention method,
+    # works well in floating window managers like XFCE
+    # but make interaction with the preview window harder
+    # (uncomment to use):
+    #xdotool behave "$XID" focus windowactivate "$MAINWINDOW" &
+
+    while read -r FILE ; do
+
+        jobs # Get rid of the "Completed" entries
+
+        if ! jobs | grep tabbed ; then
+            break
+        fi
+
+        if [ ! -e "$FILE" ] ; then
+            continue
+        fi
+
+        kill_viewer
+
+        MIME="$(file -bL --mime-type "$FILE")"
+
+        case "$MIME" in
+            video/*)
+                if type mpv >/dev/null 2>&1 ; then
+                    mpv --force-window=immediate --loop-file --wid="$XID" "$FILE" &
+                else
+                    term_nuke "$XID" "$FILE"
+                fi
+                ;;
+            audio/*)
+                if type mpv >/dev/null 2>&1 ; then
+                    mpv --force-window=immediate --loop-file --wid="$XID" "$FILE" &
+                else
+                    term_nuke "$XID" "$FILE"
+                fi
+                ;;
+            image/*)
+                if type sxiv >/dev/null 2>&1 ; then
+                    sxiv -ae "$XID" "$FILE" &
+                elif type nsxiv >/dev/null 2>&1 ; then
+                    nsxiv -ae "$XID" "$FILE" &
+                else
+                    term_nuke "$XID" "$FILE"
+                fi
+                ;;
+            application/pdf)
+                if type zathura >/dev/null 2>&1 ; then
+                    zathura -e "$XID" "$FILE" &
+                else
+                    term_nuke "$XID" "$FILE"
+                fi
+                ;;
+            inode/directory)
+                if [[ -n $PICTURES_DIR && "$FILE" == "$PICTURES_DIR"* ]] ; then
+                    if type sxiv >/dev/null 2>&1 ; then
+                        sxiv -te "$XID" "$FILE" &
+                    elif type nsxiv >/dev/null 2>&1 ; then
+                        nsxiv -te "$XID" "$FILE" &
+                    else
+                        $TERMINAL "$XID" -e nnn "$FILE" &
+                    fi
+                else
+                    $TERMINAL "$XID" -e nnn "$FILE" &
+                fi
+                ;;
+            text/*)
+                if [ -x "$NUKE" ] ; then
+                    term_nuke "$XID" "$FILE"
+                else
+                    # shellcheck disable=SC2086
+                    $TERMINAL "$XID" -e $PAGER "$FILE" &
+                fi
+                ;;
+            *)
+                if [ -x "$NUKE" ] ; then
+                    term_nuke "$XID" "$FILE"
+                else
+                    $TERMINAL "$XID" -e sh -c "file '$FILE' | $PAGER -" &
+                fi
+                ;;
+        esac
+        get_viewer_pid
+
+        # following lines are not needed with the bruteforce xdotool method
+        ACTIVE_XID="$(xdotool getactivewindow)"
+        if [ $((ACTIVE_XID == XID)) -ne 0 ] ; then
+            xdotool windowactivate "$MAINWINDOW"
+        else
+            timeout "$XDOTOOL_TIMEOUT" xdotool behave "$XID" focus windowactivate "$MAINWINDOW" &
+        fi
+    done
+    kill "$TABBEDPID"
+    kill_viewer
+}
+
+if [ ! -r "$NNN_FIFO" ] ; then
+    echo "Can't read \$NNN_FIFO ('$NNN_FIFO')"
+    exit 1
+fi
+
+previewer_loop < "$NNN_FIFO" &
+disown

plugins/preview-tui

@@ -0,0 +1,538 @@
+#!/usr/bin/env bash
+
+# Description: Terminal based file previewer
+#
+# Note: This plugin needs a "NNN_FIFO" to work. See man.
+#
+# Dependencies:
+#   - Supports 6 independent methods to preview with:
+#       - tmux (>=3.0), or
+#       - kitty with allow_remote_control and listen_on set in kitty.conf, or
+#       - wezterm (https://wezfurlong.org/wezterm), or
+#       - QuickLook on WSL (https://github.com/QL-Win/QuickLook), or
+#       - Windows Terminal (https://github.com/Microsoft/Terminal | https://aka.ms/terminal) with WSL, or
+#       - $NNN_TERMINAL set to a terminal (it's xterm by default).
+#   - less or $NNN_PAGER
+#   - tree or exa/eza or (GNU) ls
+#   - mediainfo or file
+#   - mktemp
+#   - unzip
+#   - tar
+#   - man
+#   - optional: bsdtar or atool for additional archive preview
+#   - optional: bat for code syntax highlighting
+#   - optional: ueberzug, kitty terminal, wezterm terminal, img2sixel, viu, catimg or chafa for images
+#   - optional: convert(ImageMagick) for playing gif preview (mandatory for kitty image previews)
+#   - optional: mpv for gif and video
+#       Also requires a terminal supporting the sixel (https://www.arewesixelyet.com/)
+#       or kitty (https://sw.kovidgoyal.net/kitty/graphics-protocol) video_output backends.
+#       Requires tmux compiled with `./configure --enable-sixel` if used.
+#   - optional: ffmpegthumbnailer for video thumbnails (https://github.com/dirkvdb/ffmpegthumbnailer)
+#   - optional: ffmpeg for audio thumbnails
+#   - optional: libreoffce for opendocument/officedocument preview
+#   - optional: pdftoppm(poppler) for pdf thumbnails
+#   - optional: gnome-epub-thumbnailer for epub thumbnails (https://gitlab.gnome.org/GNOME/gnome-epub-thumbnailer)
+#   - optional: fontpreview for font preview (https://github.com/sdushantha/fontpreview)
+#   - optional: djvulibre for djvu
+#   - optional: glow or lowdown for markdown
+#   - optional: w3m or lynx or elinks for html
+#   - optional: set/export NNN_ICONLOOKUP as 1 to enable file icons in front of directory previews with .iconlookup
+#       Icons and colors are configurable in .iconlookup
+#   - optional: scope.sh file viewer from ranger.
+#       1. drop scope.sh executable in $PATH
+#       2. set/export $NNN_SCOPE as 1
+#   - optional: pistol file viewer (https://github.com/doronbehar/pistol).
+#       1. install pistol
+#       2. set/export $NNN_PISTOL as 1
+#   - optional: librsvg for rsvg-convert
+#
+# Usage:
+#   You need to set a NNN_FIFO path and a key for the plugin with NNN_PLUG,
+#   then start `nnn`:
+#
+#     $ nnn -a
+#
+#   or
+#
+#     $ NNN_FIFO=/tmp/nnn.fifo nnn
+#
+#   Then launch the `preview-tui` plugin in `nnn`.
+#
+#   If you provide the same NNN_FIFO to all nnn instances, there will be a
+#   single common preview window. If you provide different FIFO path (e.g.
+#   with -a), they will be independent.
+#
+#   The previews will be shown in a tmux split. If that isn't possible, it
+#   will try to use a kitty terminal split. And as a final fallback, a
+#   different terminal window will be used ($NNN_TERMINAL).
+#
+#   Kitty users need something similar to the following in their kitty.conf:
+#   - `allow_remote_control yes`
+#   - `listen_on unix:$TMPDIR/kitty`
+#   - `enabled_layouts splits` (optional)
+#   With ImageMagick installed, this terminal can use the icat kitten to display images.
+#   Refer to kitty documentation for further details.
+#
+#   Users with both tmux and kitty can leverage image previews inside tmux with kitty's icat kitten
+#   - setup kitty as stated above
+#   - tmux >= v3.3a required
+#   - add the following to your tmux.conf:
+#     - `set -g allow-passthrough on`
+#
+#   Wezterm should work out of the box. If `NNN_PREVIEWIMGPROG` is not specified it will use
+#   built in iTerm2 image protocol.
+#
+#   Note that GNU ls is used for its `--group-directories-first` flag.
+#   On MacOS this may be installed with `brew install coreutils`, or the flag can be removed.
+#   iTerm2 users are recommended to use viu to view images without getting pixelated.
+#
+#   Windows Terminal users can set "Profile termination behavior" under "Profile > Advanced" settings
+#   to automatically close pane on quit when exit code is 0.
+#
+#   When specifying a different terminal, additional arguments are supported. In particular, you can
+#   append a specific title to the terminal and set it to "nofocus" in your WM config.
+#   E.g for alacritty and i3, you can set $NNN_TERMINAL to 'alacritty --title preview-tui' and add
+#   'no_focus [title="preview-tui"]' to your i3 config file.
+#
+# Shell: Bash (for environment manipulation through arrays)
+# Authors: Todd Yamakawa, Léo Villeveygoux, @Recidiviste, Mario Ortiz Manero, Luuk van Baal, @WanderLanz, @flipflop133
+
+# Configurable environment variables:
+NNN_SPLIT=${NNN_SPLIT:-}                                   # permanent split direction
+NNN_TERMINAL=${NNN_TERMINAL:-}                             # external terminal to be used
+NNN_SPLITSIZE=${NNN_SPLITSIZE:-50}                         # previewer split size percentage
+TMPDIR=${TMPDIR:-/tmp}                                     # location of temporary files
+ENVVARS=(
+  "NNN_SCOPE=${NNN_SCOPE:-0}"                              # use scope
+  "NNN_PISTOL=${NNN_PISTOL:-0}"                            # use pistol
+  "NNN_ICONLOOKUP=${NNN_ICONLOOKUP:-0}"                    # use .iconlookup
+  "NNN_PAGER=${NNN_PAGER:-less -P?n -R -C}"                # pager options
+  "NNN_BATTHEME=${NNN_BATTHEME:-ansi}"                     # bat theme
+  "NNN_BATSTYLE=${NNN_BATSTYLE:-numbers}"                  # bat style
+  "NNN_PREVIEWWIDTH=${NNN_PREVIEWWIDTH:-1920}"             # width of generated preview images
+  "NNN_PREVIEWHEIGHT=${NNN_PREVIEWHEIGHT:-1080}"           # height of generated preview images
+  "NNN_PREVIEWDIR=${NNN_PREVIEWDIR:-$TMPDIR/nnn/previews}" # location of generated preview images
+  "NNN_PREVIEWIMGPROG=${NNN_PREVIEWIMGPROG:-}"             # program used to preview images
+  "NNN_PREVIEWVIDEO=${NNN_PREVIEWVIDEO:-}"                 # mpv backend used to preview video
+)
+# Non-configurable environment variables
+NNN_PARENT=${NNN_FIFO#*.}
+[ "$NNN_PARENT" -eq "$NNN_PARENT" ] 2>/dev/null || NNN_PARENT="" # Make empty if non-numeric
+ENVVARS+=(
+  "PWD=$PWD"
+  "PATH=$PATH"
+  "NNN_FIFO=$NNN_FIFO"
+  "FIFOPID=$TMPDIR/nnn-preview-tui-fifopid.$NNN_PARENT"
+  "FIFOPATH=$TMPDIR/nnn-preview-tui-fifo.$NNN_PARENT"
+  "PREVIEWPID=$TMPDIR/nnn-preview-tui-previewpid.$NNN_PARENT"
+  "CURSEL=$TMPDIR/nnn-preview-tui-selection.$NNN_PARENT"
+  "FIFO_UEBERZUG=$TMPDIR/nnn-preview-tui-ueberzug-fifo.$NNN_PARENT"
+  "POSOFFSET=$TMPDIR/nnn-preview-tui-posoffset"
+)
+
+trap '' PIPE
+exists() { type "$1" >/dev/null 2>&1 ;}
+pkill() { command pkill "$@" >/dev/null 2>&1 ;}
+prompt() { clear; printf "%b" "$@"; cfg=$(stty -g); stty raw -echo; head -c 1; stty "$cfg" ;}
+pidkill() {
+    if [ -f "$1" ]; then
+        PID="$(cat "$1" 2>/dev/null)" || return 1
+        kill "$PID" >/dev/null 2>&1
+        RET=$?
+        wait "$PID" 2>/dev/null
+        return $RET
+    fi
+    return 1
+}
+
+start_preview() {
+    if [ -e "${TMUX%%,*}" ] && tmux -V | grep -q '[ -][3456789]\.'; then
+        NNN_TERMINAL=tmux
+        exists mpv && tmux display -p '#{client_termfeatures}' | grep -q 'sixel' && ENVVARS+=("NNN_PREVIEWVIDEO=sixel")
+    elif [ -n "$KITTY_LISTEN_ON" ]; then
+        NNN_TERMINAL=kitty
+        exists mpv && ENVVARS+=("NNN_PREVIEWVIDEO=kitty")
+    elif [ -n "$WEZTERM_PANE" ]; then
+        NNN_TERMINAL=wezterm
+        exists mpv && ENVVARS+=("NNN_PREVIEWVIDEO=kitty")
+    elif [ -z "$NNN_TERMINAL" ] && [ "$TERM_PROGRAM" = "iTerm.app" ]; then
+        NNN_TERMINAL=iterm
+        exists mpv && ENVVARS+=("NNN_PREVIEWVIDEO=sixel")
+    elif [ -n "$WT_SESSION" ]; then
+        NNN_TERMINAL=winterm
+    else
+        NNN_TERMINAL="${NNN_TERMINAL:-xterm}"
+    fi
+
+    if [ -z "$NNN_SPLIT" ] && [ $(($(tput lines) * 2)) -gt "$(tput cols)" ]; then
+        NNN_SPLIT='h'
+    elif [ "$NNN_SPLIT" != 'h' ]; then
+        NNN_SPLIT='v'
+    fi
+
+    ENVVARS+=("NNN_TERMINAL=$NNN_TERMINAL" "NNN_SPLIT=$NNN_SPLIT" "QLPATH=$2" "PREVIEW_MODE=1")
+    case "$NNN_TERMINAL" in
+        iterm|winterm) # has to run in separate shell command: escape
+            ENVVARS=("${ENVVARS[@]/#/\\\"}")
+            ENVVARS=("${ENVVARS[@]/%/\\\"}")
+            command="$SHELL -c 'env ${ENVVARS[*]} \\\"$0\\\" \\\"$1\\\"'" ;;
+    esac
+
+    case "$NNN_TERMINAL" in
+        tmux) # tmux splits are inverted
+            ENVVARS=("${ENVVARS[@]/#/-e}")
+            if [ "$NNN_SPLIT" = "v" ]; then split="h"; else split="v"; fi
+            tmux split-window -l"$NNN_SPLITSIZE"% "${ENVVARS[@]}" -d"$split" -p"$NNN_SPLITSIZE" "$0" "$1" ;;
+        kitty) # Setting the layout for the new window. It will be restored after the script ends.
+            ENVVARS=("${ENVVARS[@]/#/--env=}")
+            kitty @ goto-layout splits
+            # Trying to use kitty's integrated window management as the split window.
+            kitty @ launch --no-response --title "preview-tui" --keep-focus \
+                --cwd "$PWD" "${ENVVARS[@]}" --location "${NNN_SPLIT}split" "$0" "$1" ;;
+        wezterm)
+            export "${ENVVARS[@]}"
+            if [ "$NNN_SPLIT" = "v" ]; then split="--horizontal"; else split="--bottom"; fi
+            wezterm cli split-pane --cwd "$PWD" $split --percent "$NNN_SPLITSIZE" "$0" "$1" >/dev/null
+            wezterm cli activate-pane-direction Prev ;;
+        iterm)
+            if [ "$NNN_SPLIT" = "h" ]; then split="horizontally"; else split="vertically"; fi
+            osascript <<-EOF
+            tell application "iTerm"
+                tell current session of current window
+                    split $split with default profile command "$command"
+                end tell
+            end tell
+EOF
+            ;;
+        winterm)
+            if [ "$NNN_SPLIT" = "h" ]; then split="H"; else split="V"; fi
+            wt -w 0 sp -$split -s"0.$NNN_SPLITSIZE" "$command" \; -w 0 mf previous 2>/dev/null ;;
+        *)  if [ -n "$2" ]; then
+                env "${ENVVARS[@]}" QUICKLOOK=1 "$0" "$1" &
+            else
+                # shellcheck disable=SC2086 # (allow arguments)
+                env "${ENVVARS[@]}" $NNN_TERMINAL -e "$0" "$1" &
+            fi ;;
+    esac
+}
+
+toggle_preview() {
+    export "${ENVVARS[@]}"
+    if exists QuickLook.exe; then
+        QLPATH="QuickLook.exe"
+    elif exists Bridge.exe; then
+        QLPATH="Bridge.exe"
+    fi
+    if pidkill "$FIFOPID"; then
+        [ -p "$NNN_PPIPE" ] && printf "0" > "$NNN_PPIPE"
+        pidkill "$PREVIEWPID"
+        pkill -f "tail --follow $FIFO_UEBERZUG"
+        if [ -n "$QLPATH" ] && stat "$1"; then
+            f="$(wslpath -w "$1")" && "$QLPATH" "$f" &
+        fi
+    else
+        [ -p "$NNN_PPIPE" ] && printf "1" > "$NNN_PPIPE"
+        start_preview "$1" "$QLPATH"
+    fi
+}
+
+fifo_pager() {
+    cmd="$1"
+    shift
+
+    # We use a FIFO to access $NNN_PAGER PID in jobs control
+    mkfifo "$FIFOPATH" || return
+
+    $NNN_PAGER < "$FIFOPATH" &
+    printf "%s" "$!" > "$PREVIEWPID"
+
+    (
+        exec > "$FIFOPATH"
+        if [ "$cmd" = "pager" ]; then
+            if exists bat; then
+                bat --terminal-width="$cols" --decorations=always --color=always \
+                    --paging=never --style="$NNN_BATSTYLE" --theme="$NNN_BATTHEME" "$@" &
+            else
+                $NNN_PAGER "$@" &
+            fi
+        else
+            "$cmd" "$@" &
+        fi
+    )
+
+    rm -- "$FIFOPATH"
+}
+
+# Binary file: show file info inside the pager
+print_bin_info() {
+    printf -- "-------- \033[1;31mBinary file\033[0m --------\n"
+    if exists mediainfo; then
+        mediainfo "$1"
+    else
+        file -b "$1"
+    fi
+}
+
+handle_mime() {
+    case "$2" in
+        image/jpeg) image_preview "$cols" "$lines" "$1" ;;
+        image/gif) generate_preview "$cols" "$lines" "$1" "gif" ;;
+        image/vnd.djvu) generate_preview "$cols" "$lines" "$1" "djvu" ;;
+        image/*) generate_preview "$cols" "$lines" "$1" "image" ;;
+        video/*) generate_preview "$cols" "$lines" "$1" "video" ;;
+        audio/*) generate_preview "$cols" "$lines" "$1" "audio" ;;
+        application/font*|application/*opentype|font/*) generate_preview "$cols" "$lines" "$1" "font" ;;
+        */*office*|*/*document*|*/*msword|*/*ms-excel) generate_preview "$cols" "$lines" "$1" "office" ;;
+        application/zip) fifo_pager unzip -l "$1" ;;
+        text/troff)
+            if exists man; then
+                fifo_pager man -Pcat -l "$1"
+            else
+                fifo_pager pager "$1"
+            fi ;;
+        *) handle_ext "$1" "$3" "$4" ;;
+    esac
+}
+
+handle_ext() {
+    case "$2" in
+        epub) generate_preview "$cols" "$lines" "$1" "epub" ;;
+        pdf) generate_preview "$cols" "$lines" "$1" "pdf" ;;
+        gz|bz2) fifo_pager tar -tvf "$1" ;;
+        md) if exists glow; then
+                fifo_pager glow -s dark "$1"
+            elif exists lowdown; then
+                fifo_pager lowdown -Tterm "$1"
+            else
+                fifo_pager pager "$1"
+            fi ;;
+        htm|html|xhtml)
+            if exists w3m; then
+                fifo_pager w3m "$1"
+            elif exists lynx; then
+                fifo_pager lynx "$1"
+            elif exists elinks; then
+                fifo_pager elinks "$1"
+            else
+                fifo_pager pager "$1"
+            fi ;;
+        7z|a|ace|alz|arc|arj|bz|cab|cpio|deb|jar|lha|lz|lzh|lzma|lzo\
+        |rar|rpm|rz|t7z|tar|tbz|tbz2|tgz|tlz|txz|tZ|tzo|war|xpi|xz|Z)
+            if exists atool; then
+                fifo_pager atool -l "$1"
+            elif exists bsdtar; then
+                fifo_pager bsdtar -tvf "$1"
+            fi ;;
+        *) if [ "$3" = "bin" ]; then
+               fifo_pager print_bin_info "$1"
+           else
+               fifo_pager pager "$1"
+           fi ;;
+    esac
+}
+
+preview_file() {
+    clear
+    # Trying to use pistol if it's available.
+    if [ "$NNN_PISTOL" -ne 0 ] && exists pistol; then
+        fifo_pager pistol "$1"
+        return
+    fi
+
+    # Trying to use scope.sh if it's available.
+    if [ "$NNN_SCOPE" -ne 0 ] && exists scope.sh; then
+        fifo_pager scope.sh "$1" "$cols" "$lines" "$(mktemp -d)" "True"
+        return
+    fi
+
+    # Use QuickLook if it's available.
+    if [ -n "$QUICKLOOK" ]; then
+        stat "$1" && f="$(wslpath -w "$1")" && "$QLPATH" "$f" &
+        return
+    fi
+
+    # Detecting the exact type of the file: the encoding, mime type, and extension in lowercase.
+    encoding="$(file -bL --mime-encoding -- "$1")"
+    mimetype="$(file -bL --mime-type -- "$1")"
+    ext="${1##*.}"
+    [ -n "$ext" ] && ext="$(printf "%s" "${ext}" | tr '[:upper:]' '[:lower:]')"
+    lines=$(tput lines)
+    cols=$(tput cols)
+
+    # Otherwise, falling back to the defaults.
+    if [ -d "$1" ]; then
+        cd "$1" || return
+        if [ "$NNN_ICONLOOKUP" -ne 0 ] && [ -f "$(dirname "$0")"/.iconlookup ]; then
+            [ "$NNN_SPLIT" = v ] && BSTR="\n"
+            # shellcheck disable=SC2012
+            ls -F --group-directories-first | head -n "$((lines - 3))" | "$(dirname "$0")"/.iconlookup -l "$cols" -B "$BSTR" -b " "
+        elif exists tree; then
+            fifo_pager tree --filelimit "$(find . -maxdepth 1 | wc -l)" -L 3 -C -F --dirsfirst --noreport
+        elif exists exa; then
+            fifo_pager exa -T --group-directories-first --colour=always -L 3
+        elif exists eza; then # eza is a community fork of exa (exa is unmaintained)
+            fifo_pager eza -T --group-directories-first --colour=always -L 3
+        else
+            fifo_pager ls -F --group-directories-first --color=always
+        fi
+        cd ..
+    elif [ "${encoding#*)}" = "binary" ]; then
+        handle_mime "$1" "$mimetype" "$ext" "bin"
+    else
+        handle_mime "$1" "$mimetype" "$ext"
+    fi
+}
+
+generate_preview() {
+  if [ -n "$QLPATH" ] && stat "$3"; then
+        f="$(wslpath -w "$3")" && "$QLPATH" "$f" &
+  elif [ -n "$NNN_PREVIEWVIDEO" ] && [[ "$4" == +(gif|video) ]]; then
+    [ "$4" = "video" ] && args=(--start=10% --length=4) || args=()
+    video_preview "$1" "$2" "$3" "${args[@]}" && return
+  elif [ ! -f "$NNN_PREVIEWDIR/$3.jpg" ] || [ -n "$(find -L "$3" -newer "$NNN_PREVIEWDIR/$3.jpg")" ]; then
+        mkdir -p "$NNN_PREVIEWDIR/${3%/*}"
+        case $4 in
+            audio) ffmpeg -i "$3" -filter_complex "scale=iw*min(1\,min($NNN_PREVIEWWIDTH/iw\,ih)):-1" "$NNN_PREVIEWDIR/$3.jpg" -y ;;
+            epub) gnome-epub-thumbnailer "$3" "$NNN_PREVIEWDIR/$3.jpg" ;;
+            font) fontpreview -i "$3" -o "$NNN_PREVIEWDIR/$3.jpg" ;;
+            gif) if [ -p "$FIFO_UEBERZUG" ] && exists convert; then
+                    frameprefix="$NNN_PREVIEWDIR/$3/${3##*/}"
+                    if [ ! -d "$NNN_PREVIEWDIR/$3" ]; then
+                        mkdir -p "$NNN_PREVIEWDIR/$3"
+                        convert -coalesce -resize "$NNN_PREVIEWWIDTH"x"$NNN_PREVIEWHEIGHT"\> "$3" "$frameprefix.jpg" ||
+                        MAGICK_TMPDIR="/tmp" convert -coalesce -resize "$NNN_PREVIEWWIDTH"x"$NNN_PREVIEWHEIGHT"\> "$3" "$frameprefix.jpg"
+                    fi
+                    frames=$(($(find "$NNN_PREVIEWDIR/$3" | wc -l) - 2))
+                    [ $frames -lt 0 ] && return
+                    while true; do
+                        for i in $(seq 0 $frames); do
+                            image_preview "$1" "$2" "$frameprefix-$i.jpg"
+                            sleep 0.1
+                        done
+                    done &
+                    printf "%s" "$!" > "$PREVIEWPID"
+                    return
+                 elif [ -n "$NNN_PREVIEWVIDEO" ]; then
+                    video_preview "$1" "$2" "$3" && return
+                 else
+                    image_preview "$1" "$2" "$3" && return
+                 fi ;;
+            image) if exists rsvg-convert && [[ "${3##*.}" == "svg" ]]; then
+                       rsvg-convert -a -w "$NNN_PREVIEWWIDTH" -h "$NNN_PREVIEWHEIGHT" -f png -o "$NNN_PREVIEWDIR/$3.png" "$3"
+                   elif exists convert; then
+                       convert "$3" -flatten -resize "$NNN_PREVIEWWIDTH"x"$NNN_PREVIEWHEIGHT"\> "$NNN_PREVIEWDIR/$3.jpg"
+                   else
+                       image_preview "$1" "$2" "$3" && return
+                   fi ;;
+            office) libreoffice --convert-to jpg "$3" --outdir "$NNN_PREVIEWDIR/${3%/*}"
+                    filename="$(printf "%s" "${3##*/}" | cut -d. -f1)"
+                    mv -- "$NNN_PREVIEWDIR/${3%/*}/$filename.jpg" "$NNN_PREVIEWDIR/$3.jpg" ;;
+            pdf) pdftoppm -jpeg -f 1 -singlefile "$3" "$NNN_PREVIEWDIR/$3" ;;
+            djvu) ddjvu -format=ppm -page=1 "$3" "$NNN_PREVIEWDIR/$3.jpg" ;;
+            video) video_preview "$1" "$2" "$3" && return ;;
+        esac
+    fi
+    if [ -f "$NNN_PREVIEWDIR/$3.jpg" ]; then
+        image_preview "$1" "$2" "$NNN_PREVIEWDIR/$3.jpg"
+    elif [[ "${3##*.}" == "svg" ]] && [ -f "$NNN_PREVIEWDIR/$3.png" ]; then
+        image_preview "$1" "$2" "$NNN_PREVIEWDIR/$3.png"
+    else
+        fifo_pager print_bin_info "$3"
+    fi
+} >/dev/null 2>&1
+
+image_preview() {
+    clear
+    exec >/dev/tty
+    if [ "$NNN_TERMINAL" = "kitty" ] && [[ "$NNN_PREVIEWIMGPROG" == +(|icat) ]]; then
+        kitty +kitten icat --silent --scale-up --place "$1"x"$2"@0x0 --transfer-mode=stream --stdin=no "$3" &
+    elif [ "$NNN_TERMINAL" = "tmux" ] && [[ -n "$KITTY_LISTEN_ON" ]] && [[ "$NNN_PREVIEWIMGPROG" == +(|icat) ]]; then
+        kitty +kitten icat --silent --scale-up --place "$(($1 - 1))x$(($2 - 1))"@0x0 --transfer-mode=memory --stdin=no "$3" &
+    elif [ "$NNN_TERMINAL" = "wezterm" ] && [[ "$NNN_PREVIEWIMGPROG" == +(|imgcat) ]]; then
+        wezterm imgcat "$3" &
+    elif exists ueberzug && [[ "$NNN_PREVIEWIMGPROG" == +(|ueberzug) ]]; then
+        ueberzug_layer "$1" "$2" "$3" && return
+    elif exists catimg && [[ "$NNN_PREVIEWIMGPROG" == +(|catimg) ]]; then
+        catimg "$3" &
+    elif exists viu && [[ "$NNN_PREVIEWIMGPROG" == +(|viu) ]]; then
+        viu -t "$3" &
+    elif exists chafa && [[ "$NNN_PREVIEWIMGPROG" == +(|chafa) ]]; then
+        chafa "$3" &
+    elif exists img2sixel && [[ "$NNN_PREVIEWIMGPROG" == +(|img2sixel) ]]; then
+        img2sixel -g "$3" &
+    else
+        fifo_pager print_bin_info "$3" && return
+    fi
+    printf "%s" "$!" > "$PREVIEWPID"
+}
+
+video_preview() {
+    clear
+    exec >/dev/tty
+    if [ -n "$NNN_PREVIEWVIDEO" ]; then
+        mpv --no-config --really-quiet --vo="$NNN_PREVIEWVIDEO" --profile=sw-fast --loop-file --no-audio "$4" "$3" &
+    else
+        ffmpegthumbnailer -m -s0 -i "$3" -o "$NNN_PREVIEWDIR/$3.jpg" || rm -- "$NNN_PREVIEWDIR/$3.jpg" &
+    fi
+    printf "%s" "$!" > "$PREVIEWPID"
+}
+
+ueberzug_layer() {
+    [ -f "$POSOFFSET" ] && read -r x y < "$POSOFFSET"
+    printf '{"action": "add", "identifier": "nnn_ueberzug", "x": %d, "y": %d, "width": "%d", "height": "%d", "scaler": "fit_contain", "path": "%s"}\n'\
+        "${x:-0}" "${y:-0}" "$1" "$2" "$3" > "$FIFO_UEBERZUG"
+}
+
+ueberzug_remove() {
+    printf '{"action": "remove", "identifier": "nnn_ueberzug"}\n' > "$FIFO_UEBERZUG"
+}
+
+winch_handler() {
+    clear
+    pidkill "$PREVIEWPID"
+    if [ -p "$FIFO_UEBERZUG" ]; then
+        pkill -f "tail --follow $FIFO_UEBERZUG"
+        tail --follow "$FIFO_UEBERZUG" | ueberzug layer --silent --parser json &
+    fi
+    preview_file "$(cat "$CURSEL")"
+}
+
+preview_fifo() {
+    while read -r selection; do
+        if [ -n "$selection" ]; then
+            pidkill "$PREVIEWPID"
+            [ -p "$FIFO_UEBERZUG" ] && ueberzug_remove
+            [ "$selection" = "close" ] && break
+            preview_file "$selection"
+            printf "%s" "$selection" > "$CURSEL"
+        fi
+    done < "$NNN_FIFO"
+    sleep 0.1 # make sure potential preview by winch_handler is killed
+    pkill -P "$$"
+}
+
+if [ "$PREVIEW_MODE" -eq 1 ] 2>/dev/null; then
+    if exists ueberzug && [ "$NNN_TERMINAL" != "kitty" ] && [[ "$NNN_PREVIEWIMGPROG" == +(|ueberzug) ]]; then
+        mkfifo "$FIFO_UEBERZUG"
+        tail --follow "$FIFO_UEBERZUG" | ueberzug layer --silent --parser json &
+    fi
+
+    preview_file "$PWD/$1"
+    preview_fifo & WAITPID=$!
+    printf "%s" "$!" > "$FIFOPID"
+    printf "%s" "$PWD/$1" > "$CURSEL"
+    trap 'winch_handler' WINCH
+    trap 'rm -- "$PREVIEWPID" "$CURSEL" "$FIFO_UEBERZUG" "$FIFOPID" "$POSOFFSET" 2>/dev/null' INT HUP EXIT
+    while kill -s 0 $WAITPID; do
+      wait $WAITPID 2>/dev/null
+    done
+    exit 0
+else
+    if [ ! -r "$NNN_FIFO" ]; then
+        prompt "No FIFO available! (\$NNN_FIFO='$NNN_FIFO')\nPlease read Usage in '$0'."
+    elif [ "$KITTY_WINDOW_ID" ] && [ -z "$TMUX" ] && [ -z "$KITTY_LISTEN_ON" ]; then
+        prompt "\$KITTY_LISTEN_ON not set!\nPlease read Usage in '$0'."
+    else
+        toggle_preview "$1" &
+    fi
+fi

plugins/pskill

@@ -0,0 +1,35 @@
+#!/usr/bin/env sh
+
+# Description: Fuzzy list and kill a (zombie) process by name
+#
+# Dependencies: fzf, ps
+#
+# Note: To kill a zombie process enter "zombie"
+#
+# Shell: POSIX compliant
+# Author: Arun Prakash Jana
+
+printf "Enter process name ['defunct' for zombies]: "
+read -r psname
+
+# shellcheck disable=SC2009
+if [ -n "$psname" ]; then
+    if type sudo >/dev/null 2>&1; then
+        sucmd=sudo
+    elif type doas >/dev/null 2>&1; then
+        sucmd=doas
+    else
+        sucmd=: # noop
+    fi
+
+    if type fzf >/dev/null 2>&1; then
+        fuzzy=fzf
+    else
+        exit 1
+    fi
+
+    cmd="$(ps -ax | grep -iw "$psname" | "$fuzzy" | sed -e 's/^[ \t]*//' | cut -d' ' -f1)"
+    if [ -n "$cmd" ]; then
+        $sucmd kill -9 "$cmd"
+    fi
+fi

plugins/renamer

@@ -0,0 +1,45 @@
+#!/usr/bin/env sh
+
+# Description: Batch rename selection or current directory with qmv or vidir
+#
+# Notes:
+#   - Try to mimic current batch rename functionality but with correct
+#     handling of edge cases by qmv or vidir.
+#   - Qmv opens with hidden files if no selection is used. Selected
+#	  directories are shown.
+#   - Vidir don't show directories nor hidden files.
+#
+# Shell: POSIX compliant
+# Author: José Neder
+
+selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection}
+
+if type qmv >/dev/null 2>&1; then
+	batchrenamesel="qmv -fdo -da"
+	batchrename="qmv -fdo -a"
+elif type vidir >/dev/null 2>&1; then
+	batchrenamesel="vidir"
+	batchrename="vidir"
+else
+    printf "there is not batchrename program installed."
+    exit
+fi
+
+if [ -s "$selection" ]; then
+    printf "rename selection? "
+    read -r resp
+fi
+
+if [ "$resp" = "y" ]; then
+    # -o flag is necessary for interactive editors
+    xargs -o -0 $batchrenamesel < "$selection"
+
+    # Clear selection
+    if [ -p "$NNN_PIPE" ]; then
+        printf "-" > "$NNN_PIPE"
+    fi
+elif [ ! "$(LC_ALL=C ls -a)" = ".
+.." ]; then
+	# On older systems that don't have ls -A
+    $batchrename
+fi