Video Thumbnail Service

A lightweight microservice that generates video thumbnails by extracting a frame using ffmpeg.

Requirements

• Node.js 18+
• ffmpeg installed on the system

Setup

npm install
npm start

The service runs on port 3100 by default. Set the PORT environment variable to change it.

Usage

GET /thumbnail?url=https://example.com/video.mp4

Returns a JPEG image of the first frame (at 1 second).

Configuration

Set VITE_THUMBNAIL_URL in the Flotilla .env file to the deployed service URL:

VITE_THUMBNAIL_URL=https://your-thumbnail-service.example.com