diff --git a/plugins/autojump b/plugins/autojump index dc840628..19c6548e 100755 --- a/plugins/autojump +++ b/plugins/autojump @@ -2,9 +2,10 @@ # Description: Navigate to directory using jump/autojump/zoxide # -# Dependencies: jump - https://github.com/gsamokovarov/jump -# OR autojump - https://github.com/wting/autojump -# OR zoxide - https://github.com/ajeetdsouza/zoxide +# Dependencies: +# - jump - https://github.com/gsamokovarov/jump +# - OR autojump - https://github.com/wting/autojump +# - OR zoxide - https://github.com/ajeetdsouza/zoxide # # Note: The dependencies STORE NAVIGATION PATTERNS # diff --git a/plugins/bookmarks b/plugins/bookmarks index 1bb3503d..8cb3ea24 100755 --- a/plugins/bookmarks +++ b/plugins/bookmarks @@ -7,7 +7,6 @@ # Usage: # 1. Create a $BOOKMARKS_DIR directory # By default, $BOOKMARKS_DIR is set to: ${XDG_CACHE_HOME:-$HOME/.cache}/nnn/bookmarks -# # 2. Create symlinks to directories # `cd $BOOKMARKS_DIR` # `ln -s /path/to/useful/directory bookmark_name` @@ -20,7 +19,7 @@ # https://linux.101hacks.com/cd-command/cdpath/ # # TODO: -# 1. Remove `fzf` dependency +# - Remove `fzf` dependency # # Shell: POSIX compliant # Author: Todd Yamakawa diff --git a/plugins/boom b/plugins/boom index 39da84c2..77bb1b8c 100755 --- a/plugins/boom +++ b/plugins/boom @@ -1,7 +1,10 @@ #!/usr/bin/env sh -# Description: Play random music from current directory. Identifies MP3, FLAC, M4A, WEBM, WMA. -# You may want to set GUIPLAYER. +# 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 diff --git a/plugins/bulknew b/plugins/bulknew index 4010662d..64331e47 100755 --- a/plugins/bulknew +++ b/plugins/bulknew @@ -1,7 +1,7 @@ #!/usr/bin/env sh -# Description: Allows for creation of multiple files/directories at the same time. -# Plugin opens a temp file where each entry is to be written on a separate line +# 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 diff --git a/plugins/chksum b/plugins/chksum index 97f0cf0a..318f1c8b 100755 --- a/plugins/chksum +++ b/plugins/chksum @@ -2,13 +2,14 @@ # Description: Create and verify checksums # -# For selection: it will generate one file containing the checksums with file names -# [and with paths if they are in another directory] -# the output checksum filename will be checksum_timestamp.checksum_type -# For file: if the file is a checksum, the plugin does the verification +# 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 -# For directory: recursively calculates checksum for all the files in the directory +# - directory: recursively calculates checksum for all the files in the dir # the output checksum filename will be directory.checksum_type # # Shell: POSIX compliant diff --git a/plugins/diffs b/plugins/diffs index 1028f4e7..0464781b 100755 --- a/plugins/diffs +++ b/plugins/diffs @@ -2,10 +2,11 @@ # Description: Show diff of 2 directories or multiple files in vimdiff # -# Note: 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 +# 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 diff --git a/plugins/dragdrop b/plugins/dragdrop index ef352da7..6ecb5c8d 100755 --- a/plugins/dragdrop +++ b/plugins/dragdrop @@ -3,13 +3,13 @@ # Description: Open a Drag and drop window, to drop files onto other programs. # Also provides drag and drop window for files. # -# Dependencies: https://github.com/mwh/dragon +# Dependencies: dragon - https://github.com/mwh/dragon # # Notes: -# - Files that are dropped will be added to nnn's selection -# Some webbased files will be downloaded to current directory with curl -# and it may overwrite some existing files -# - The user has to mm to clear nnn's selection first +# 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 diff --git a/plugins/dups b/plugins/dups index 98e8f727..c87757e7 100755 --- a/plugins/dups +++ b/plugins/dups @@ -1,19 +1,19 @@ #!/usr/bin/env sh -# Description: List non-empty duplicate files in the current directory (based on size followed by MD5) +# 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 # -# Note: bash compatible required for mktemp +# 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 +# Shell: Bash # Authors: syssyphus, KlzXS -# If the size of a file has more that $size_digits digits the file will be misplaced -# 12 digits fit files up to 931GiB - EDITOR="${EDITOR:-vi}" TMPDIR="${TMPDIR:-/tmp}" diff --git a/plugins/fzhist b/plugins/fzhist index 2a801f08..91b47393 100755 --- a/plugins/fzhist +++ b/plugins/fzhist @@ -1,7 +1,9 @@ #!/usr/bin/env sh -# Description: Fuzzy find a command from history, edit in $EDITOR and run as a command -# Currently supports only bash and fish history +# Description: Fuzzy find a command from history, +# edit in $EDITOR and run as a command +# +# Note: Supports only bash and fish history # # Shell: POSIX compliant # Author: Arun Prakash Jana diff --git a/plugins/fzplug b/plugins/fzplug index e7993455..c2ad7622 100755 --- a/plugins/fzplug +++ b/plugins/fzplug @@ -1,21 +1,27 @@ #!/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. -# -# 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). +# 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 need be, but be sure to call them in the find command below at lines 27 and 33. +# 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="" @@ -38,7 +44,8 @@ else --bind="?:toggle-preview") fi -# Try running the script on the hovered file, and abort if no plugin was selected (ESC or ^C pressed), +# 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 diff --git a/plugins/gpgd b/plugins/gpgd index 7f1dba2e..44d5c0f4 100755 --- a/plugins/gpgd +++ b/plugins/gpgd @@ -1,8 +1,10 @@ #!/usr/bin/env sh -# Description: Decrypts selected files using gpg. The contents of the decrypted file are stored in a file with extension .dec +# 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. +# 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 diff --git a/plugins/gpge b/plugins/gpge index ba935ab6..69016a9d 100755 --- a/plugins/gpge +++ b/plugins/gpge @@ -1,9 +1,11 @@ #!/usr/bin/env sh -# Description: Encrypts selected files using gpg. Can encrypt either asymmetrically (key) or symmetrically (passphrase). -# If asymmetric encryption is chosen a key can be chosen from the list of capable public keys using fzf. +# 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 +# Note: Symmetric encryption only works for a single (current) file as per gpg limitations # # Shell: POSIX compliant # Author: KlzXS diff --git a/plugins/hexview b/plugins/hexview index ad6e97fa..cb1006df 100755 --- a/plugins/hexview +++ b/plugins/hexview @@ -1,6 +1,7 @@ #!/usr/bin/env sh # Description: View a file in hex +# # Dependencies: hx (https://github.com/krpors/hx)/xxd and $PAGER # # Shell: POSIX compliant diff --git a/plugins/imgresize b/plugins/imgresize index f04a883b..351fe712 100755 --- a/plugins/imgresize +++ b/plugins/imgresize @@ -1,15 +1,16 @@ #!/usr/bin/env sh # Description: Resize images in a directory to screen resolution with imgp -# imgp homepage: https://github.com/jarun/imgp +# +# Dependencipes: imgp - https://github.com/jarun/imgp # # Notes: -# 1. Set res if you don't want to be prompted for desktop resolution every 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 +# 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 diff --git a/plugins/imgthumb b/plugins/imgthumb index 8e217077..a47f661b 100755 --- a/plugins/imgthumb +++ b/plugins/imgthumb @@ -2,6 +2,8 @@ # Description: View thumbnail of an image or a directory of images with lsix # +# Dependencies: lsix +# # Shell: POSIX compliant # Author: Arun Prakash Jana diff --git a/plugins/imgur b/plugins/imgur index c6a46ae1..4aa7a65e 100755 --- a/plugins/imgur +++ b/plugins/imgur @@ -32,7 +32,7 @@ # # Slightly modified for `nnn` integration # -# Shell: bash +# Shell: Bash # Description: Upload an image file to imgur if [ "${1}" = "--debug" ]; then diff --git a/plugins/imgview b/plugins/imgview index 9a308322..667bcca7 100755 --- a/plugins/imgview +++ b/plugins/imgview @@ -2,9 +2,11 @@ # Description: Open images in hovered directory and thumbnails # open hovered image in sxiv or viu and browse other images in the directory -# Dependencies: imv (https://github.com/eXeC64/imv) or, -# sxiv (https://github.com/muennich/sxiv) or, -# viu (https://github.com/atanunq/viu), less +# +# Dependencies: +# - imv (https://github.com/eXeC64/imv) or, +# - sxiv (https://github.com/muennich/sxiv) or, +# - viu (https://github.com/atanunq/viu), less # # Shell: POSIX compliant # Author: Arun Prakash Jana diff --git a/plugins/kdeconnect b/plugins/kdeconnect index 9bef7dfd..5f63d8bc 100755 --- a/plugins/kdeconnect +++ b/plugins/kdeconnect @@ -1,6 +1,7 @@ #!/usr/bin/env sh -# Description: Send the selected files to your Android device using kdeconnect-cli. You must have installed and configured kdeconnect both on the Android device and on the PC. +# Description: Send the selected files to your Android device using kdeconnect-cli. +# kdeconnect must be configured on the Android device and the PC. # # Shell: POSIX compliant # Author: juacq97 diff --git a/plugins/moclyrics b/plugins/moclyrics index 0dc3cd79..2f698070 100755 --- a/plugins/moclyrics +++ b/plugins/moclyrics @@ -1,6 +1,7 @@ #!/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 diff --git a/plugins/mocplay b/plugins/mocplay index dbda0d3c..038ecc92 100755 --- a/plugins/mocplay +++ b/plugins/mocplay @@ -3,9 +3,9 @@ # 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 +# - 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 diff --git a/plugins/mp3conv b/plugins/mp3conv index b582cbca..029f5445 100755 --- a/plugins/mp3conv +++ b/plugins/mp3conv @@ -2,7 +2,7 @@ # Description: Extract audio from multimedia files and convert to mp3 # -# Dependency: ffmpeg compiled with libmp3lame audio codec support +# Dependencies: ffmpeg compiled with libmp3lame audio codec support # # Shell: POSIX compliant # Author: Arun Prakash Jana diff --git a/plugins/mtpmount b/plugins/mtpmount index a295ea07..d6feea06 100755 --- a/plugins/mtpmount +++ b/plugins/mtpmount @@ -5,6 +5,8 @@ # '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. @@ -14,8 +16,6 @@ # 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`. # -# Dependencies: gvfs-mtp -# # Shell: POSIX compliant # Author: Benawi Adha diff --git a/plugins/nmount b/plugins/nmount index 460f8b48..fc154e27 100755 --- a/plugins/nmount +++ b/plugins/nmount @@ -4,14 +4,16 @@ # If the device is not mounted, it will be mounted. # If the device is mounted, it will be unmounted and powered down. # -# Runs `lsblk` if 'l' is entered, exits on 'Return`. +# Dependencies: lsblk # -# Note: -# - The script uses Linux-specific lsblk to list block devices. Alternatives: +# 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 alterntive to power-down disks. +# - 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 alterntive to power-down disks. # # Shell: POSIX compliant # Author: Arun Prakash Jana diff --git a/plugins/nuke b/plugins/nuke index 1018a621..d65565b6 100755 --- a/plugins/nuke +++ b/plugins/nuke @@ -1,6 +1,5 @@ #!/usr/bin/env sh -# ############################################################################# # Description: Sample script to play files in apps by file type or mime # # Shell: POSIX compliant @@ -60,10 +59,9 @@ # text/* | */xml: vi # image/vnd.djvu): djvutxt, exiftool # -# ToDo: +# TODO: # 1. Adapt, test and enable all mimes # 2. Clean-up the unnecessary exit codes -# ############################################################################# # set to 1 to enable GUI apps GUI="${GUI:-0}" diff --git a/plugins/pdfview b/plugins/pdfview index 262e34fe..e21b3486 100755 --- a/plugins/pdfview +++ b/plugins/pdfview @@ -3,8 +3,8 @@ # Description: View a PDF file in pager # # Notes: -# - $PAGER must be 'less -R' or 'most' -# - To use mutool, uncomment the relevant lines and comment the pdftotext line +# - $PAGER must be 'less -R' or 'most' +# - To use mutool, uncomment the relevant lines and comment the pdftotext line # # Shell: POSIX compliant # Author: Arun Prakash Jana diff --git a/plugins/preview-tabbed b/plugins/preview-tabbed index 0fcb3148..a4921786 100755 --- a/plugins/preview-tabbed +++ b/plugins/preview-tabbed @@ -2,33 +2,30 @@ # Description: tabbed/xembed based file previewer # -# Note: This plugin needs a "NNN_FIFO" to work. See man. -# # Dependencies: -# - tabbed (https://tools.suckless.org/tabbed): xembed host -# - xterm (or urxvt or st) : xembed client for text-based preview -# - mpv (https://mpv.io): xembed client for video/audio -# - sxiv (https://github.com/muennich/sxiv): xembed client for images -# - zathura (https://pwmt.org/projects/zathura): xembed client for PDF documents -# - nnn's nuke plugin for text preview and fallback (should be in plugins directory) -# nuke is a fallback for 'mpv', 'sxiv', and 'zathura', but it has has its own -# dependencies, see the script itself -# - vim (or any editor/pager really) -# - file -# - mktemp -# - xdotool (optional, to keep main window focused) +# - tabbed (https://tools.suckless.org/tabbed): xembed host +# - xterm (or urxvt or st) : xembed client for text-based preview +# - mpv (https://mpv.io): xembed client for video/audio +# - sxiv (https://github.com/muennich/sxiv): 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', 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) # -# How to use: -# First, install the dependencies. Then you need to set a NNN_FIFO path -# and set a key for the plugin, then start `nnn`: +# 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 # -# $ NNN_FIFO=/tmp/nnn.fifo nnn -# -# Then in `nnn`, launch the `preview-tabbed` plugin. -# -# If you provide the same NNN_FIFO to all nnn instances, there will be a -# single common preview window. I you provide different FIFO path, they -# will be independent. +# 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. # # How it works: # We use `tabbed` [1] as a xembed [2] host, to have a single window @@ -45,7 +42,7 @@ # [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) +# Shell: Bash (job control is weakly specified in POSIX) # Author: Léo Villeveygoux diff --git a/plugins/preview-tui b/plugins/preview-tui index a69cf224..e649a279 100755 --- a/plugins/preview-tui +++ b/plugins/preview-tui @@ -6,28 +6,26 @@ # For a more extended version of this script with additional optional dependencies, see preview-tui-ext. # # Dependencies: -# - Supports 4 independent methods to preview with: -# - tmux (>=3.0), or -# - kitty with allow_remote_control and listen_on set in kitty.conf, or -# - QuickLook on WSL (https://github.com/QL-Win/QuickLook) -# - $TERMINAL set to a terminal (it's xterm by default). -# - less or $PAGER -# - tree or exa or ls -# - mediainfo or file -# - mktemp -# - unzip -# - tar -# - man -# - optional: bat for code syntax highlighting -# - optional: ueberzug, kitty terminal, viu or catimg for images. -# - optional: scope.sh file viewer from ranger. -# To use: -# 1. drop scope.sh executable in $PATH -# 2. set/export $USE_SCOPE as 1 -# - optional: pistol file viewer (https://github.com/doronbehar/pistol). -# To use: -# 1. install pistol -# 2. set/export $USE_PISTOL as 1 +# - Supports 4 independent methods to preview with: +# - tmux (>=3.0), or +# - kitty with allow_remote_control and listen_on set in kitty.conf, or +# - QuickLook on WSL (https://github.com/QL-Win/QuickLook) +# - $TERMINAL set to a terminal (it's xterm by default). +# - less or $PAGER +# - tree or exa or ls +# - mediainfo or file +# - mktemp +# - unzip +# - tar +# - man +# - optional: bat for code syntax highlighting +# - optional: ueberzug, kitty terminal, viu or catimg for images. +# - optional: scope.sh file viewer from ranger. +# 1. drop scope.sh executable in $PATH +# 2. set/export $USE_SCOPE as 1 +# - optional: pistol file viewer (https://github.com/doronbehar/pistol). +# 1. install pistol +# 2. set/export $USE_PISTOL as 1 # # Usage: # You need to set a NNN_FIFO path and a key for the plugin with NNN_PLUG, @@ -39,7 +37,7 @@ # # $ NNN_FIFO=/tmp/nnn.fifo nnn # -# Then in `nnn`, launch the `preview-tui` plugin. +# 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. diff --git a/plugins/renamer b/plugins/renamer index eb79435f..d01cca66 100755 --- a/plugins/renamer +++ b/plugins/renamer @@ -3,11 +3,11 @@ # Description: Batch rename selection or current directory with qmv # # 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. +# - 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 diff --git a/plugins/uidgid b/plugins/uidgid index d72f1e0a..261ac60f 100755 --- a/plugins/uidgid +++ b/plugins/uidgid @@ -3,7 +3,6 @@ # Description: list uid and gid of files # # Note: To list UID and GID of all users in a pretty format, run: -# # cut -d':' -f1,3,4,5 < /etc/passwd | column -ts ":" # # Shell: POSIX compliant diff --git a/plugins/unmount-parent b/plugins/unmount-parent index 4abf6ab0..3a89f650 100755 --- a/plugins/unmount-parent +++ b/plugins/unmount-parent @@ -1,15 +1,19 @@ #!/usr/bin/env sh -# Description: Autodetects a nnn remote mountpoint (mounted with `c`) from any of its subfolders and allows unmounting it -# from there without first going back to the top or entering the remote name. Also works when hovering the mountpoint -# directly like vanilla `u`. +# Description: Autodetects a nnn remote mountpoint (mounted with `c`) +# from any of its subfolders and allows unmounting it +# from the subdir without navigating to the mountppoint +# or entering the remote name. Also works when hovering +# the mountpoint directly like vanilla `u`. # # Dependencies: fusermount +# # Shell: POSIX compliant # Authors: Kabouik & 0xACE # -# TODO: Try better avoiding lazy unmount by forcing nnn context to leave the subfolder before fusermount. -# I tried `printf "%s" "0c$m" > "$NNN_PIPE"` but this would break nnn UI all the time, see #854. +# TODO: +# - Avoid lazy unmount by forcing nnn context to leave the subfolder before fusermount. +# Tried `printf "%s" "0c$m" > "$NNN_PIPE"` but it breaks the nnn interfacee, see #854. err=0 m=$HOME/.config/nnn/mounts diff --git a/plugins/upgrade b/plugins/upgrade index b2170f7b..3be9a837 100755 --- a/plugins/upgrade +++ b/plugins/upgrade @@ -4,7 +4,7 @@ # # Note: This script installs a package, should be issued with admin privilege # -# Shell: POSIX-compliant +# Shell: POSIX compliant # Author: Arun Prakash Jana cur="$(nnn -v)" diff --git a/plugins/upload b/plugins/upload index 0bbf5626..733cf87d 100755 --- a/plugins/upload +++ b/plugins/upload @@ -3,7 +3,9 @@ # Description: Upload to Firefox Send if ffsend is found, else # Paste contents of a text a file http://ix.io # Upload a binary file to file.io +# # Dependencies: ffsend (https://github.com/timvisee/ffsend), curl, jq, tr +# # Note: Binary file set to expire after a week # # Shell: POSIX compliant diff --git a/plugins/vidthumb b/plugins/vidthumb index 248abd76..590cf81a 100755 --- a/plugins/vidthumb +++ b/plugins/vidthumb @@ -3,8 +3,8 @@ # Description: Generate video thumbnails and view them # # Dependencies: -# ffmpegthumbnailer: https://github.com/dirkvdb/ffmpegthumbnailer -# lsix: https://github.com/hackerb9/lsix +# - ffmpegthumbnailer: https://github.com/dirkvdb/ffmpegthumbnailer +# - lsix: https://github.com/hackerb9/lsix # # Shell: POSIX compliant # Author: Arun Prakash Jana diff --git a/plugins/wall b/plugins/wall index a1541346..deea19a6 100755 --- a/plugins/wall +++ b/plugins/wall @@ -1,9 +1,10 @@ #!/usr/bin/env sh # Description: Set the selected image as wallpaper using nitrogen or pywal. +# # Usage: Hover on an image and run the script to set it as wallpaper. # -# Shell: POSIX Compliant +# Shell: POSIX compliant # Author: juacq97 if [ -n "$1" ]; then diff --git a/plugins/x2sel b/plugins/x2sel index 0e6cbad7..70104d77 100755 --- a/plugins/x2sel +++ b/plugins/x2sel @@ -1,17 +1,19 @@ #!/usr/bin/env sh # Description: Copy system clipboard newline-separated file list to selection -# Dependencies: -# - tr -# - xclip/xsel (Linux) -# - pbpaste (macOS) -# - termux-clipboard-get (Termux) -# - powershell (WSL) -# - cygwim's /dev/clipboard (Cygwin) -# - wl-paste (Wayland) -# - clipboard (Haiku) # -# Limitation: breaks if a filename has newline in it +# Dependencies: +# - tr +# - xclip/xsel (Linux) +# - pbpaste (macOS) +# - termux-clipboard-get (Termux) +# - powershell (WSL) +# - cygwim's /dev/clipboard (Cygwin) +# - wl-paste (Wayland) +# - clipboard (Haiku) +# +# Note: +# - Limitation: breaks if a filename has newline in it # # Shell: POSIX compliant # Author: Léo Villeveygoux, after Arun Prakash Jana's .cbcp @@ -21,7 +23,6 @@ IFS="$(printf '%b_' '\n')"; IFS="${IFS%_}" # protect trailing \n selection=${NNN_SEL:-${XDG_CONFIG_HOME:-$HOME/.config}/nnn/.selection} getclip () { - if type xsel >/dev/null 2>&1; then # Linux xsel -bo @@ -47,7 +48,6 @@ getclip () { # Haiku clipboard --print fi - } CLIPBOARD=$(getclip) diff --git a/plugins/xdgdefault b/plugins/xdgdefault index 366190a4..a302b22a 100755 --- a/plugins/xdgdefault +++ b/plugins/xdgdefault @@ -1,13 +1,13 @@ #!/usr/bin/env sh -# Description: Sets the xdg-open's default application for the current entry's -# file type. ${XDG_DATA_DIRS} and ${XDG_DATA_HOME} are set to the recommended -# defaults if unset, as specified in XDG Base Directory Specification, -# [ http://specifications.freedesktop.org/basedir-spec/ ]. +# Description: Sets the xdg-open's default application for the current entry's file +# type. ${XDG_DATA_DIRS} and ${XDG_DATA_HOME} are set to the recommended +# defaults if unset, as specified in XDG Base Directory Specification +# - http://specifications.freedesktop.org/basedir-spec/. # # Dependencies: xdg-utils, fzf # -# Shell: POSIX +# Shell: POSIX compliant # Author: lwnctd if [ -z "$1" ] || ! command -v fzf > /dev/null 2>& 1; then