Course contentsShow
← System Design
Lesson 1603 of 1,91939. Real-World System: Image and Video HostingFree lesson

Thumbnail and Preview Generation

Extracting keyframes from videos and generating preview thumbnails at specific timestamps for user experience.

Thumbnail and Preview Generation

What You'll Learn

You'll learn how to efficiently extract representative frames from uploaded videos and generate preview thumbnails that help users quickly identify and browse content.


The Core Challenge

When a user uploads a video to your hosting platform, they expect to see a thumbnail immediately—both in their library and when sharing the link. Similarly, hovering over a video might show a preview animation. Your system must automatically extract meaningful frames from the video and generate optimized thumbnail images.

Why This Matters

Imagine scrolling through hundreds of videos without thumbnails—you'd have no idea what each contains without playing them. Thumbnails serve as visual summaries, dramatically improving user experience and click-through rates.

Key Design Decisions

Keyframe Extraction Strategy:

  • Extract frames at specific timestamps (e.g., 25%, 50%, 75% through the video)
  • Use the first non-black frame (avoids blank intros)
  • Apply machine learning to detect the most "interesting" frame (faces, action, contrast)

Multiple Thumbnail Sizes: Generate several resolutions for different contexts:

  • Grid view: 320×180 (small)
  • Detail page: 1280×720 (large)
  • Mobile: 480×270 (medium)

Preview Generation: Create short animated previews by extracting keyframes at regular intervals (every 5-10 seconds), then combining them into a lightweight format like animated WebP or a series of JPEG thumbnails loaded on hover.

Processing Timing: This happens in your asynchronous processing pipeline immediately after upload and before or alongside transcoding, since you need to access the video file anyway.

Storage Organization: Store thumbnails in object storage with predictable naming: thumbnails/{video_id}/small.jpg, thumbnails/{video_id}/preview_{frame_number}.jpg

Key Takeaway: Thumbnail and preview generation extracts representative frames from videos at strategic timestamps, creating multiple resolution thumbnails and preview sequences that dramatically improve browsing experience while being generated asynchronously after upload.