Previewer

Command line tool to generate montages (image previews) from video clips or folders containing images.

Install

Install ffmpeg if you want to generate previews for video clips.

$ sudo apt update
$ sudo apt install ffmpeg

Install the latest release of previewer from PyPI

$ pip3 install previewer
$ previewer --help

Or install previewer from the sources

$ pip3 install poetry
$ pip3 install git+https://github.com/essembeh/previewer
$ previewer --help

Usage

You can customize the generated image:

• change geometry (width, height, crop, fit or fill) of the thumbnails
• change the background color
• show or hide the a title
• adjust the space between thumbnails
• add a border, a shadow to thumbnails

Example: generate a preview from a video clip

We can build a preview image of a video using:

$ previewer --crop 256 --shadow --title --background lightblue "samples/Rick Astley - Never Gonna Give You Up.mp4"
🎬 Generate montage from video samples/Rick Astley - Never Gonna Give You Up.mp4 using 36 thumbnails
🍺 Montage generated ./Rick Astley - Never Gonna Give You Up.jpg

Example: generate a preview from a folder containing images

We can build a preview folder containing images like this:

$ previewer --columns 5 --polaroid --background b2967d "samples/Rick Astley - Never Gonna Give You Up"
📷 Generate montage from folder samples/Rick Astley - Never Gonna Give You Up/ containing 20 images
🍺 Montage generated ./Rick Astley - Never Gonna Give You Up.jpg