Docker Hub GitHub Container Registry

imagorvideo is a new initiative that brings video thumbnail capability through ffmpeg, built on the foundations of imagor – a fast, Docker-ready image processing server written in Go with libvips.

Imagorvideo uses ffmpeg C bindings that extracts image thumbnail from video by attempting to select the best frame, then forwards to libvips to perform all existing image operations supported by imagor.

imagorvideo uses reader stream for mkv and webm video types. For other video types that requires seeking from a non seek-able source such as HTTP or S3, it simulates seek using memory buffer or temp file, by having the whole file to be fully loaded to perform seek.

This project is a work in progress. It also aims to be a reference project demonstrating imagor extensibility.

Quick Start

docker run -p 8000:8000 shumc/imagorvideo -imagor-unsafe




Check out imagor for all existing image operations supported.


Config options specific to imagorvideo. Please refer to imagor for all existing options supported.

  -ffmpeg-fallback-image string
        FFmpeg fallback image on processing error. Supports image path enabled by loaders or storages


View Github