mirrors/nnn
1
0
Fork 0
mirror of https://github.com/jarun/nnn.git synced 2024-11-27 13:21:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated Live previews (markdown)

Mischievous Meerkat 2020-06-10 06:50:28 +05:30
parent 5a9a5ee843
commit 947455aac6
1 changed files with 3 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
Live-previews.md

@ -28,16 +28,16 @@ Depends on how many simultaneous `nnn` instances you need:
Follow the instructions in the [plugin documentation](https://github.com/jarun/nnn/tree/master/plugins) for installation and general plugin configuration. Follow the instructions in the [plugin documentation](https://github.com/jarun/nnn/tree/master/plugins) for installation and general plugin configuration.
There are 3 previewer plugins for `nnn`, using various mechanisms to display the preview window: There are 2 previewer plugins for `nnn`, using various mechanisms to display the preview window:
- [preview-kitty](https://github.com/jarun/nnn/blob/master/plugins/preview-kitty): the preview window is a [kitty](https://sw.kovidgoyal.net/kitty/) pane (needs kitty's allow_remote_control option turned on), and files are previewed using text tools ([exa](https://github.com/ogham/exa) or ls, [bat](https://github.com/sharkdp/bat) or cat, mediainfo or file, kitty's icat).
- [preview-tabbed](https://github.com/jarun/nnn/blob/master/plugins/preview-tabbed): the preview window is a [tabbed](https://tools.suckless.org/tabbed) X window, files are viewed using Xembed capable programs ([mpv](https://mpv.io) for audio/video, [sxiv](https://github.com/muennich/sxiv) for images, [zathura](https://pwmt.org/projects/zathura) for PDF, xterm/urxvt/st + [nuke](https://github.com/jarun/nnn/blob/master/plugins/nuke) plugin text preview for other files) - [preview-tabbed](https://github.com/jarun/nnn/blob/master/plugins/preview-tabbed): the preview window is a [tabbed](https://tools.suckless.org/tabbed) X window, files are viewed using Xembed capable programs ([mpv](https://mpv.io) for audio/video, [sxiv](https://github.com/muennich/sxiv) for images, [zathura](https://pwmt.org/projects/zathura) for PDF, xterm/urxvt/st + [nuke](https://github.com/jarun/nnn/blob/master/plugins/nuke) plugin text preview for other files)
- [preview-tui](https://github.com/jarun/nnn/blob/master/plugins/preview-tui): the preview window is either a tmux pane or a new terminal window, and files are previewed using simple text tools (tree, head, file). This is the most barebone, dependecy free preview plugin, and probably the one you want to start from if you want to make your own. - [preview-tui](https://github.com/jarun/nnn/blob/master/plugins/preview-tui): the preview window is either a tmux pane or a new terminal window or a [kitty](https://sw.kovidgoyal.net/kitty/) pane (needs kitty's `allow_remote_control` option turned on), and files are previewed using tools like tree, less, file, mediainfo, kitty's icat etc. It can also use ranger's scope.sh or pistol. It's a good starting point from where you can build your own customized plugin.
**Notes:** **Notes:**
1. `nnn` does not watch the hovered file and update the path if it's modified while under preview. Press <kbd>Esc</kbd> or click on the entry to update the preview without changing the hovered entry. 1. `nnn` does not watch the hovered file and update the path if it's modified while under preview. Press <kbd>Esc</kbd> or click on the entry to update the preview without changing the hovered entry.
2. To close the `preview-tui` and `preview-kitty` preview windows, press <kbd>^C</kbd> on the preview window. Run the plugin again if you want to preview. 2. To close the `preview-tui` and `preview-kitty` preview windows, press <kbd>^C</kbd> on the preview window. Run the plugin again if you want to preview.
3. To run a plugin when you start `nnn`, use the option `-P`
## Custom script configuration example ## Custom script configuration example