aboutsummaryrefslogtreecommitdiffstats
path: root/misc/nlay/README.md
blob: 4671eeca99c8d690c0a9652274a4d403f5d6ce41 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
## nlay

`nlay` (*NnnpLAY*) is a customizable media type or action handler

### Usage

`nlay` is not used by `nnn` now. However, the bash script can be used to run desktop search utility or screensaver:

    nlay file type
    file: absolute path to file ("" for an action)
    type: type of media or action

### Default apps

* gnome-search-tool, catfish - file search
* vlock - terminal screensaver (alternatives - cmatrix, termsaver)

### Perks

- simple to modify (extensive in-file notes, comments and indicative code)
- handle files by category (e.g. plaintext, search, screensaver)
- support for multiple apps by order of preference
- run app in the foreground or silently detached in the background
- optionally add app arguments

### Tips to modify

- set `app=` in any category to change the player
- set `opts=` to use app options
- toggle `bg=` to enable or disable running app silently (`stdout` and `stderr` redirected to `/dev/null`) in background. E.g., vim (CLI) should be verbose and in the foreground while Sublime Text (GUI) can be started silently in the background.
- enable the commented out code under `ENABLE_FILE_TYPE_HANDLING` to handle specific file extensions e.g. use a different app than the one used for the category.