thumbnail

This block is part of the video group and was last modified in core v15.0.0.

thumbnail condition v15.0.0

Extracts a single frame from a video as a JPEG poster image. Runs inline : it decodes one frame, not the whole file.

In pins 5 + flow

flow
flow
file required
value
Video file. Accepts a file object (from another file block) or a relative path string.
output file
value
Output path for the .jpg, relative to the entity root : e.g. public/clips/thumb123.jpg. When empty, a hash-named .jpg is written alongside the input.
at (s)
number
Timestamp to grab, in seconds. When it lands past the end of the video the midpoint is used instead, so a short clip still gets a picture.
Default 1
max size
number
Longest-side cap in pixels. Set to 0 to keep the source size.
Default 640
quality
number
JPEG quality on ffmpeg's scale: 2 is best, 31 is worst. Values outside that range fall back to 3.
Default 3

Out pins 5 + flow

flow
flow
success
condition
output file
value
Path the JPEG was written to, relative to the entity root : feed it to get link or store it directly.
width
number
Width of the written thumbnail.
height
number
Height of the written thumbnail.
error
value

poster frame

video still

screenshot

video thumbnail

A typical wiring for thumbnail: a function trigger starts the flow; value feeds the file pin; the flow out pin feeds debug.

Used in these guides

These documentation pages use or explain this block:

Introduced in v15.0.0.