Note: This is a fork of vifmimg which uses Ueberzug for image previewing. Since Uberzug is depreciated I tend to use timg instead which outputs similar experiences.

This script is used along vifm to generate image previews for various file types in vifm.

If you want image preview support for lf check out cirala/lfimg.

The script is currently able to handle the following formats:

• Video
• Pdf
• Djvu
• eBook
• Images
• Audio files
• Fonts

All previews are cached (except for regular images) and stored in your ~/.cache/vifm/ folder.

1. Copy the vifmimg and vifmrun scripts to a folder that is included in your $PATH variable for easy access to the files.

2. Edit your ~/.config/vifm/vifmrc file and add fileviewer properties like so:

    fileviewer *.pdf
        \ vifmimg pdf %px %py %pw %ph %c
        \ %pc
        \ vifmimg clear

    fileviewer *.djvu
        \ vifmimg djvu %px %py %pw %ph %c
        \ %pc
        \ vifmimg clear

    fileviewer *.epub
        \ vifmimg epub %px %py %pw %ph %c
        \ %pc
        \ vifmimg clear

    fileviewer <video/*>
        \ vifmimg video %px %py %pw %ph %c
        \ %pc
        \ vifmimg clear

    fileviewer <image/*>
        \ vifmimg draw %px %py %pw %ph %c
        \ %pc
        \ vifmimg clear

    fileviewer <audio/*>
        \ vifmimg audio %px %py %pw %ph %c
        \ %pc
        \ vifmimg clear

    fileviewer <font/*>
        \ vifmimg font %px %py %pw %ph %c
        \ %pc
        \ vifmimg clear

3. In order to launch vifm with image preview support from now on, you will need to use the supplied vifmrun script.

I recommend that you make an alias in your shell that points to vifm.

• Überzug and Vifm (isn't this obvious?)
• ffmpegthumbnailer
• ImageMagick
• pdftoppm (Available in the AUR as poppler package.)
• ddjvu (Contains in the Debian/Ubuntu djvulibre-bin package.)
• epub-thumbnailer
• fontpreview

• Seebye for creating Überzug and the initial script that this script is heavily based upon.
• Ranger's approach to file previewing as an inspiration source.