Fortyseven / extract-grid-overview

Creates a montage grid of frames from a video file with frame and time offset labels to help give a basic summary of the video file contents.

extract-grid-overview

Creates a montage grid of frames from a video file with frame and time offset labels to help give a basic summary of the video file contents.

WARNING: This is an extremely kludgy tool that makes a real mess but tries to clean up afterward. If you stop it mid-process you might have a bunch of .png files to clean up. This is seriously janky and will probably be unhappy with small files with large grid sizes.

There are ABSOLUTELY better ways to do this, but it works "good enough" for my purposes. (You know how that goes.) I will likely circle back at some point and make further improvements. 🤞

Options

Usage: extract-grid-overview.py [options] input-video.mkv output-montage.png

• --cols and --rows let you specify the dimensions of the output grid
• --no-labels removes the frame information labels

Requirements

• ffmpeg (including ffprobe)
• imagemagick (with included convert and montage)

Example Output

Star Trek: The Animated Series, Default 8x8 (4:3)

Real Genius, 8x8 (widescreen)

Max Headroom, 20x20 (4:3)