Skip to main content

Video or Folder preview generator

Project description

Github PyPi Python CI

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

Video preview

Example: generate a preview from a folder containing images

We can build a preview folder containing images like this:

Folder with images

$ 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

Folder preview

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

previewer-0.9.0.tar.gz (3.8 MB view hashes)

Uploaded Source

Built Distribution

previewer-0.9.0-py3-none-any.whl (3.8 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page