Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thimc/lfimg
Image preview support for lf (list files) using Überzug
https://github.com/thimc/lfimg
cli file lf manager preview terminal ueberzug
Last synced: 1 day ago
JSON representation
Image preview support for lf (list files) using Überzug
- Host: GitHub
- URL: https://github.com/thimc/lfimg
- Owner: thimc
- License: gpl-3.0
- Created: 2020-02-13T20:40:27.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-20T05:23:03.000Z (4 months ago)
- Last Synced: 2025-01-22T07:03:19.333Z (9 days ago)
- Topics: cli, file, lf, manager, preview, terminal, ueberzug
- Language: Shell
- Size: 646 KB
- Stars: 266
- Watchers: 7
- Forks: 47
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Image preview support for lf (list files) using Überzug
lfimg is a repository that contains scripts that are used for generating image
preview in lf.\
If you want image preview support for vifm, head on over to
[vifmimg](https://github.com/cirala/vifmimg).
## Prerequisites
Besides lf and Überzug you will need to install the following packages:
* ffmpegthumbnailer
* ImageMagick
* poppler
* epub-thumbnailer
* wkhtmltopdf
* file (pre-installed on most linux flavours; needed for nixOs)
The following packages are optional but if installed will provide more functionality to lfimg.
* bat (optional - color highlight for text files)
* chafa (optional - for image preview over SSH or inside Wayland session)
* unzip (optional - for .zip and .jar files)
* 7z (optional - for .7z files)
* unrar (optional - for .rar files)
* catdoc (optional - for .doc files)
* docx2txt (optional - for .docx files)
* odt2txt (optional - for .odt and *.ods files)
* gnumeric (optional - for .xls and .xlsx files)
* exiftool (optional - for music files)
* iso-info (optional - for .iso files)
* transmission (optional - for .torrent files)
* [comicthumb](https://codeberg.org/johndovern/comicthumb) (optional - for .cbz and .cbr files)
## Installation
The preferred way of installing lfimg is running make:
```
make install
```
If you prefer to do it manually you will need to do the following:
1. Extract the following files: **cleaner**, **preview** to **~/.config/lf/**.
2. Extract **lfrun** to a directory that is in your $PATH variable (such as
/usr/bin or ~/.local/bin).
3. Edit your **lfrc** file and add the following lines:
```
set previewer ~/.config/lf/preview
set cleaner ~/.config/lf/cleaner
```
Make sure to adjust the previewer and cleaner paths to where you put those
scripts in step 2.
4. In order to use lfimg you will need to start lf using the **lfrun** script.
I recommend that you make an alias in your shell that points to lfrun.\
If you are using bash, append the following to your **~/.bashrc**:
```
alias lf=lfrun
```
## Credits
* [lf](https://github.com/gokcehan/lf/)
* [Seebye's Überzug](https://github.com/seebye/ueberzug)
* [Brodie's](https://github.com/BrodieRobertson/) initial preview script which
I used as a template for handling the miscellaneous filetypes that this
script also handles.