piper.yazi
Pipe any shell command as a previewer.
Installation
ya pack -a yazi-rs/plugins:piper
Usage
Piper is a general-purpose previewer - you can pass any shell command to piper and it will use the command's output as the preview content.
It accepts a string parameter, which is the shell command to be executed, for example:
# ~/.config/yazi/yaiz.toml
[[plugin.prepend_previewers]]
name = "*"
run = 'piper -- echo "$1"'
This will set piper as the previewer for all file types and use $1 (file path) as the preview content.
Variables
Available variables:
$w: the width of the preview area.$h: the height of the preview area.$1: the path to the file being previewed.
Examples
Here are some configuration examples:
Preview CSV with bat
[[plugin.prepend_previewers]]
name = "*.csv"
run = 'piper -- bat -p --color=always "$1"'
Preview Markdown with glow
[[plugin.prepend_previewers]]
name = "*.md"
run = 'piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dark "$1"'
Note that there's a bug in Glow v2.0 that causes slight color differences between tty and non-tty environments.
Preview directory tree with eza
[[plugin.prepend_previewers]]
name = "*/"
run = 'piper -- eza -TL=3 --color=always --icons=always --group-directories-first --no-quotes "$1"'
License
This plugin is MIT-licensed. For more information check the LICENSE file.