ctpv/README.md

54 lines
1.1 KiB
Markdown
Raw Normal View History

2022-06-14 13:00:53 +02:00
# ctpv
Terminal previewer
![showcase](doc/showcase.gif)
----
2022-06-16 07:00:57 +02:00
ctpv is an utility for previewing various files
(including images with [Überzug](https://github.com/seebye/ueberzug)).
2022-06-14 13:00:53 +02:00
2022-06-16 07:00:57 +02:00
ctpv is a remake of an awesome program named
[stpv](https://github.com/Naheel-Azawy/stpv) written in C.
2022-06-14 13:00:53 +02:00
stpv worked perfectly for me, except it was kinda sluggish because
it was written in POSIX shell.
2022-06-16 07:00:57 +02:00
ctpv is an attempt to make a faster version of stpv and add some
new features.
2022-06-14 13:00:53 +02:00
Originally it was made for [lf](https://github.com/gokcehan/lf)
2022-06-16 07:00:57 +02:00
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.
2022-06-14 13:00:53 +02:00
## Installation
### Manual
```sh
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
2022-06-16 07:00:57 +02:00
Full documentation for the program can be found here:
https://nikitaivanovv.github.io/ctpv/