README.md

vimg

CLI for video images. Generate animated video contact sheets fast. Uses ffmpeg.

Note: Support for animated avif isn't everywhere yet, try viewing with firefox/chromium.

Command: vcs

Create a new contact sheet for a video.

Extracts capture frames and joins into sheet(s) then encodes into an animated, or static, vcs avif.

vimg vcs [OPTIONS] -c <COLUMNS> -H <CAPTURE_HEIGHT> -n <NUMBER> <VIDEO>

See examples.

Command: extract

Extract capture bmp images from a video using ffmpeg.

vimg extract [OPTIONS] -n <NUMBER> <VIDEO>

Command: join

Join same-sized capture images into a single grid image.

vimg join [OPTIONS] --columns <COLUMNS> --output <OUTPUT> <CAPTURE_IMAGES>...

Install

Arch Linux

Available in the AUR.

Windows

Pre-built vimg.exe included in the latest release.

Using cargo

Latest release

cargo install vimg

Latest code direct from git

cargo install --git https://github.com/alexheretic/vimg

Requirements

ffmpeg that's not too old should be in $PATH.

Minimum supported rust compiler

Maintained with latest stable rust.