Add nplay as a plugin

This commit is contained in:
Arun Prakash Jana 2019-12-08 08:27:53 +05:30
parent 5826da920f
commit 5708585c3b
No known key found for this signature in database
GPG key ID: A75979F35C080412
4 changed files with 4 additions and 29 deletions

View file

@ -153,7 +153,7 @@ There is no config file. Associated files are stored under `${XDG_CONFIG_HOME:-$
| Example `export` | Description | | Example `export` | Description |
| --- | --- | | --- | --- |
| `NNN_OPENER=nplay` | custom file opener ([nplay](https://github.com/jarun/nnn/blob/master/misc/nplay/nplay)) | | `NNN_OPENER=nplay` | custom file opener ([nplay](https://github.com/jarun/nnn/blob/master/plugins/nplay)) |
| `NNN_BMS='d:~/Documents;D:~/Docs archive/'` | key-bookmark pairs [max 10] | | `NNN_BMS='d:~/Documents;D:~/Docs archive/'` | key-bookmark pairs [max 10] |
| `NNN_PLUG='o:fzopen;m:nmount;x:_chmod +x $nnn'` | key-plugin (or cmd) pairs (<kbd>:key</kbd> to run) [max 15] | | `NNN_PLUG='o:fzopen;m:nmount;x:_chmod +x $nnn'` | key-plugin (or cmd) pairs (<kbd>:key</kbd> to run) [max 15] |
| `NNN_USE_EDITOR=1` | open text files in `$VISUAL` (else `$EDITOR`, fallback vi) | | `NNN_USE_EDITOR=1` | open text files in `$VISUAL` (else `$EDITOR`, fallback vi) |

View file

@ -1,26 +0,0 @@
## nplay
`nplay` (*NnnPLAY*) is a customizable file opener by file extension or mime type.
It is customizable and written for the CLI mode by default. To set GUI mode and use GUI apps by change the line
GUI=0
to
GUI=1
### Usage
nplay filepath
### Integration with `nnn`
1. Export the required config:
export NNN_OPENER=/path/to/nplay
# Otherwise, if nplay is in $PATH
export NNN_OPENER=nplay
2. Run `nnn` with the program option to indicate a CLI opener
nnn -c
3. `nplay` can use `nnn` plugins (e.g. mocplay is used for audio), $PATH is updated to include `nnn` plugins dir.

View file

@ -38,6 +38,7 @@ Plugins extend the capabilities of `nnn`. They are _executable_ scripts (or bina
| mocplay | Append (and/or play) selection/dir/file in moc | sh | [moc](http://moc.daper.net/) | | mocplay | Append (and/or play) selection/dir/file in moc | sh | [moc](http://moc.daper.net/) |
| nmount | Toggle mount status of a device as normal user | sh | pmount, udisks2 | | nmount | Toggle mount status of a device as normal user | sh | pmount, udisks2 |
| notes | Open a quick notes file/dir in `$EDITOR` | sh | - | | notes | Open a quick notes file/dir in `$EDITOR` | sh | - |
| nplay | Sample file opener (CLI-only by default) | sh | various |
| oldbigfile | List large files by access time | sh | find, sort | | oldbigfile | List large files by access time | sh | find, sort |
| organize | Auto-organize files in directories by file type | sh | file | | organize | Auto-organize files in directories by file type | sh | file |
| pastebin | Paste contents of a text a file ix.io | sh | - | | pastebin | Paste contents of a text a file ix.io | sh | - |

View file

@ -7,9 +7,9 @@
# #
# nnn integration: # nnn integration:
# 1. Export the required config: # 1. Export the required config:
# export NNN_OPENER=/path/to/nplay # export NNN_OPENER=/absolute/path/to/nplay
# # Otherwise, if nplay is in $PATH # # Otherwise, if nplay is in $PATH
# export NNN_OPENER=nplay # # export NNN_OPENER=nplay
# 2. Run nnn with the program option to indicate a CLI opener # 2. Run nnn with the program option to indicate a CLI opener
# nnn -c # nnn -c
# 3. nplay can use nnn plugins (e.g. mocplay is used for audio), $PATH is updated. # 3. nplay can use nnn plugins (e.g. mocplay is used for audio), $PATH is updated.