MCPcopy Create free account
hub / github.com/dirkvdb/ffmpegthumbnailer

github.com/dirkvdb/ffmpegthumbnailer @v2.3.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.3.0 ↗ · + Follow
1,118 symbols 2,062 edges 36 files 23 documented · 2% updated 8d agov2.3.0 · 2025-12-14★ 63416 open issues

Browse by type

Functions 835 Types & classes 283
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Build

FFmpegthumbnailer is a lightweight video thumbnailer that can be used by file managers to create thumbnails for your video files. The thumbnailer uses ffmpeg to decode frames from the video files, so supported videoformats depend on the configuration flags of ffmpeg.

This thumbnailer was designed to be as fast and lightweight as possible. The only dependencies are ffmpeg and libpng/libjpeg.

Usage

ffmpegthumbnailer is called from the command line

Available command line arguments: * -i: input video filename * -o: output filename of the generated image file (filename ending with .jpg or .jpeg will be in jpeg format, otherwise png is used) * -s: size of the generated thumbnail in pixels (use 0 for original size) (default value: 128) * -t: time to seek to (percentage or absolute time hh:mm:ss) (default: 10%) * -f: use this option to overlay a movie strip on the generated thumbnail * -q: image quality (0 = bad, 10 = best) (default: 8) only applies to jpeg output * -c: override image format (jpeg or png) (default: determined by filename) * -a: ignore aspect ratio and generate square thumbnail * -m: prefer embedded image metadata over video content * -w: workaround some issues in older versions of ffmpeg (only use if you experience problems like 100% cpu usage on certain files) * -v: print version number * -h: display the usage

Core symbols most depended-on inside this repo

Shape

Method 716
Class 261
Function 119
Enum 22

Languages

C++100%
C1%

Modules by API surface

test/testframework/catch.hpp973 symbols
libffmpegthumbnailer/videothumbnailer.cpp23 symbols
libffmpegthumbnailer/moviedecoder.cpp21 symbols
libffmpegthumbnailer/videothumbnailerc.cpp11 symbols
libffmpegthumbnailer/moviedecoder.h11 symbols
main.cpp9 symbols
libffmpegthumbnailer/jpegwriter.cpp9 symbols
libffmpegthumbnailer/videothumbnailer.h7 symbols
kffmpegthumbnailer/kffmpegthumbnailer.cpp7 symbols
libffmpegthumbnailer/videothumbnailerc.h6 symbols
libffmpegthumbnailer/pngwriter.cpp6 symbols
libffmpegthumbnailer/stringoperations.h4 symbols

For agents

$ claude mcp add ffmpegthumbnailer \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page