#version-control #extract #join #vimg

app vimg

CLI for video images. Generates animated video contact sheets fast.

5 releases

Uses new Rust 2024

new 0.2.0 May 10, 2025
0.1.3 Jul 27, 2023
0.1.2 May 19, 2023
0.1.1 Mar 10, 2023
0.1.0 Mar 8, 2023

#16 in Video

Download history

209 downloads per month

MIT license

44KB
791 lines

vimg

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

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.

Dependencies

~12–23MB
~342K SLoC