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.

Image files:

• ueberzug

Videos:

• ffmpegthumbnailer

Text files:

• source-highlight
• highlight

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/