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/