1. Install the [utilities you may need](https://github.com/jarun/nnn#utility-dependencies) based on your regular workflows.
2. Configure [cd on quit](https://github.com/jarun/nnn/wiki/Basic-use-cases#configure-cd-on-quit).
3. Optionally open all text files in `$EDITOR` (fallback vi): `export NNN_USE_EDITOR=1`.
-4. For additional functionality [install plugins](https://github.com/jarun/nnn/tree/master/plugins#installing-plugins) and the GUI app launcher [`nlaunch`](https://github.com/jarun/nnn/tree/master/misc/nlaunch).
+4. For additional functionality [install plugins](https://github.com/jarun/nnn/tree/master/plugins#installing-plugins).
Notes:
MISC
! ^] Shell ;K :K xK Execute plugin K
C Execute entry R ^V Pick plugin
- U Manage session = Launch
+ U Manage session = Launch app
c Remote mount u Unmount
] ^P Prompt/run cmd L Lock
```
+++ /dev/null
-`nlaunch` is an independent POSIX-compliant GUI application launcher shell script. To use it with `nnn` you need to mark the file executable and drop it somewhere in your `$PATH`.
-
-It requires [`fzy`](https://github.com/jhawthorn/fzy) to show a fuzzy drop-down menu.
-
-To use `nlaunch` as an independent launcher add a keybind to open `nlaunch` in a terminal e.g.
-
- xfce4-terminal -e nlaunch
+++ /dev/null
-#!/usr/bin/env sh
-
-# Description: Fuzzy find executables in $PATH and launch an application.
-# stdin, stdout, stderr are suppressed so CLI utilities exit silently.
-# Works as an independent app launcher.
-#
-# Requires fzy.
-#
-# Usage: nlaunch [delay]
-# delay is in seconds, if omitted nlaunch waits for 1 sec
-#
-# Shell: POSIX compliant
-# Author: Arun Prakash Jana
-
-IFS=':'
-
-get_selection() {
- ls -H $PATH | sort | fzy
-}
-
-if selection=$( get_selection ); then
- setsid "$selection" 2>/dev/null 1>/dev/null &
-
- if ! [ -z "$1" ]; then
- sleep "$1"
- else
- sleep 1
- fi
-fi
| diffs | Diff for selection (limited to 2 for directories) | sh | vimdiff |
| dragdrop | Drag/drop files from/into nnn | sh | [dragon](https://github.com/mwh/dragon) |
| exetoggle | Toggle executable status of hovered file | sh | chmod |
-| fzcd | Change to the directory of a fuzzy-selected file/dir | sh | fzy/fzf<br>(optional fd) |
+| fzcd | Change to the directory of a fuzzy-selected file/dir | sh | fzf/fzy<br>(optional fd) |
| fzhist | Fuzzy-select a cmd from history, edit in `$EDITOR` and run | sh | fzy |
| fzopen | Fuzzy find a file in dir subtree and edit or open | sh | fzy, xdg-open |
| getplugs | Update plugins | sh | curl |
| imgviu | View an image or images in dir in `$PAGER` | sh | [viu](https://github.com/atanunq/viu), less |
| ipinfo | Fetch external IP address and whois information | sh | curl, whois |
| kdeconnect | Send selected files to an Android device | sh | kdeconnect-cli |
+| launch | GUI application launcher | sh | fzf/fzy |
| mediainf | Show media information | sh | mediainfo |
| moclyrics | Show lyrics of the track playing in moc | sh | [ddgr](https://github.com/jarun/ddgr), [moc](http://moc.daper.net/) |
| mocplay | Append (and/or play) selection/dir/file in moc | sh | [moc](http://moc.daper.net/) |
Plugins are installed to `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/plugins`. You can run the `getplugs` plugin later to update the plugins. It backs up earlier plugins.
-**NOTE:** `getplugs` also downloads the launcher `nlaunch` and tries to place it at `/usr/local/bin/` using `sudo`. If it fails you have to place `nlauch` manually somewhere in your `$PATH`.
-
## Executing plugins
**Method 1:** Directly with <kbd>:key</kbd>:
fi
}
-if [ "$(is_cmd_exists sudo)" -eq "0" ]; then
- sucmd=sudo
-elif [ "$(is_cmd_exists doas)" -eq "0" ]; then
- sucmd=doas
-else
- sucmd=: # noop
-fi
+# if [ "$(is_cmd_exists sudo)" -eq "0" ]; then
+# sucmd=sudo
+# elif [ "$(is_cmd_exists doas)" -eq "0" ]; then
+# sucmd=doas
+# else
+# sucmd=: # noop
+# fi
# backup any earlier plugins
if [ -d "$PLUGIN_DIR" ]; then
done
cd ../.. || exit 1
-$sucmd mv -vf nnn-master/misc/nlaunch/nlaunch /usr/local/bin/
rm -rf nnn-master/ master.tar.gz
--- /dev/null
+#!/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
+#
+# Requires: fzf or fzy
+#
+# 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
+
+IFS=':'
+
+get_selection() {
+ if which fzf >/dev/null 2>&1; then
+ ls -H $PATH | sort | fzf
+ elif which fzy >/dev/null 2>&1; then
+ ls -H $PATH | sort | fzy
+ else
+ exit 1
+ fi
+}
+
+if selection=$( get_selection ); then
+ setsid "$selection" 2>/dev/null 1>/dev/null &
+
+ if ! [ -z "$1" ]; then
+ sleep "$1"
+ else
+ sleep 1
+ fi
+fi
#!/usr/bin/env sh
# #############################################################################
-# nuke: a sample script to play files in different apps by file type and mime
-# shell: POSIX compliant
-# usage: nuke filepath
+# Description: Sample script to play files in apps by file type or mime
#
-# nnn integration:
+# 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
# nnn -c
# 3. nuke can use nnn plugins (e.g. mocplay is used for audio), $PATH is updated.
#
-# details:
+# Details:
# Inspired by ranger's scope.sh, modified for usage with nnn.
#
# Tries to play 'file' (1st argument) in the following order:
# ii. by mime (image, video, audio, pdf)
# iii. by mime (other file types)
#
-# modification tips:
+# 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.
#
# Feel free to change the utilities to your favourites and add more mimes.
#
-# defaults:
+# Defaults:
# By extension (only the enbaled ones):
# most archives: list with atool, bsdtar
# rar: list with unrar
#define UTIL_TAR 4
#define UTIL_LOCKER 5
#define UTIL_CMATRIX 6
-#define UTIL_NLAUNCH 7
+#define UTIL_LAUNCH 7
#define UTIL_SH_EXEC 8
#define UTIL_ARCHIVEMOUNT 9
#define UTIL_SSHFS 10
#define UTIL_VI 12
#define UTIL_LESS 13
#define UTIL_SH 14
+#define UTIL_FZF 15
+#define UTIL_FZY 16
/* Utilities to open files, run actions */
static char * const utils[] = {
"vlock",
#endif
"cmatrix",
- "nlaunch",
+ "launch",
"sh -c",
"archivemount",
"sshfs",
"vi",
"less",
"sh",
+ "fzf",
+ "fzy",
};
/* Common strings */
#define MSG_FEW_COLOUMNS 38
#define MSG_REMOTE_OPTS 39
#define MSG_RCLONE_DELAY 40
+#define MSG_APP_NAME 41
static const char * const messages[] = {
"no traversal",
"entry exists",
"too few columns!",
"'s'shfs / 'r'clone?",
- "may take a while, try refresh"
+ "may take a while, try refresh",
+ "app name: ",
};
/* Supported configuration environment variables */
if (len == 1)
cur = oldcur;
goto end;
+ case '=': // fallthrough /* Launch app */
case ':': // fallthrough /* Run plugin keys */
case ';': // fallthrough
case '?': /* Help and config key, '?' is an invalid regex */
"1MISC\n"
"9! ^] Shell ;K :K xK Execute plugin K\n"
"cC Execute entry R ^V Pick plugin\n"
- "cU Manage session = Launch\n"
+ "cU Manage session = Launch app\n"
"cc SSHFS mount u Unmount\n"
"9] ^P Prompt/run cmd L Lock\n"};
setdirwatch();
goto begin;
case SEL_LAUNCH:
- if (getutil(utils[UTIL_NLAUNCH])) {
- spawn(utils[UTIL_NLAUNCH], "0", NULL, path, F_NORMAL);
- break;
- } // fallthrough
+ mkpath(plugindir, utils[UTIL_LAUNCH], newpath);
+ if ((getutil(utils[UTIL_FZF]) || getutil(utils[UTIL_FZY]))
+ && access(newpath, X_OK) == 0) {
+ tmp = newpath;
+ r = F_NORMAL;
+ } else {
+ tmp = xreadline(NULL, messages[MSG_APP_NAME]);
+ r = F_NOWAIT | F_NOTRACE | F_MULTI;
+ }
+
+ if (tmp && *tmp) // NOLINT
+ spawn(tmp, "0", NULL, path, r);
+
+ if (cfg.filtermode)
+ presel = FILTER;
+ goto nochange;
default: /* SEL_RUNCMD */
#ifndef NORL
if (cfg.picker) {
goto nochange;
}
#endif
- if (tmp && tmp[0]) // NOLINT
+ if (tmp && *tmp) // NOLINT
prompt_run(tmp, (ndents ? dents[cur].name : ""), path);
}