Simple Terminal PreViewer (STPV)

Preview as many possible kinds of files.

Dependencies

• ueberzug for image previews
• Tons of things for other stuff…

Overall, it should fine without most dependencies, it will fallback to simpler previews. Check stpv to see all needed toys.

Usage

stpv

Note: stpvimg should be run first as mentioned below for image previews to work

stpv $FILE $H $W $X $Y $ID # all arguments except FILE are optional
stpv --clear $ID # only if stpvimg is running

stpvimg

ID=$$
stpvimg --listen $ID &
stpvimg --add $ID 1.png
stpvimg --add $ID 2.png $X $Y $W $H
stpvimg --clear $ID
stpvimg --end $ID

Integration with fmz

stpv is already integrated with fmz. Just install stpv and fmz will use it.

Integration with lf

lf now support image previews. All what is needed is to add the following to lfrc:

set previewer stpv
set cleaner stpvimgclr
&stpvimg --listen $id

Integration with fzf

fzfp

Installation

sudo make install

Configuration

~~/.config/stpv/config.sh~:

PV_IMAGE_ENABLED=1
PV_TYPE=img
PREFER_TEXT=
DARK_DOCS=1
SAFE=1

P.S. use any string for true, leave empty for false

Video

https://youtu.be/MXkjcgzILIc

License

GPL3