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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file previewer-0.9.0.tar.gz.

File metadata

  • Download URL: previewer-0.9.0.tar.gz
  • Upload date:
  • Size: 3.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.10.12 Linux/5.15.0-1041-azure

File hashes

Hashes for previewer-0.9.0.tar.gz
Algorithm Hash digest
SHA256 098fe5e15efea4b36c966b2d2774b06efe68e0347ac9852f27b6df533ec08ec7
MD5 b5c8e60fd2d4cf275595f4299b2a867d
BLAKE2b-256 b80724fdd26ca0d3c6d6be4cc2d8507bd3c11d8ca67763ce82688f085e5ba933

See more details on using hashes here.

File details

Details for the file previewer-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: previewer-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 3.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.10.12 Linux/5.15.0-1041-azure

File hashes

Hashes for previewer-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 eac04ac26cbc6510e6500de95ec7af70ca799d29dcea18eb7ca2c55a75c951e0
MD5 428e7cf4079f485035e9387489730295
BLAKE2b-256 539d906ad168b9c5a3bc2dc94868b9941505928e7b351109ec434ced7d1e5728

See more details on using hashes here.

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