ctpv

Terminal previewer

ctpv is an utility for previewing various files (including images with Überzug).

ctpv is a remake of an awesome program named stpv written in C. stpv worked perfectly for me, except it was kinda sluggish because it was written in POSIX shell. ctpv is an attempt to make a faster version of stpv and add some new features.

Originally it was made for lf file manager but I believe that it can be easily integrated into other programs as well if they support previews provided by external programs like lf does.

Dependencies

These programs are needed to make specific previews work. If a preview requires some program and it's not found on the system, ctpv will fallback to other previews.

File types	Required programs
Text files	`source-highlight` `highlight`
Image files	`ueberzug`
Videos	`ffmpegthumbnailer`
Diff files	`colordiff` `delta` `diff-so-fancy`
Markdown	`mdcat`
JSON files	`jq`
PDF files	`pdftoppm`
Torrent files	`transmission-show`
HTML files	`w3m` `lynx` `elinks`
Any other files	`exiftool`

Installation

Manual

git clone https://github.com/NikitaIvanovV/ctpv
cd ctpv
sudo make install

Uninstall with sudo make uninstall

Integration

lf file manager

Add these lines to your lf config (usually located at ~/.config/lf/lfrc):

set previewer ctpv
set cleaner ctpvclear
&ctpv -s $id
cmd on-quit $ctpv -e $id

Documentation

Full documentation for the program can be found here: https://nikitaivanovv.github.io/ctpv/

1.7 KiB Raw Blame History