Trevor PaughSystems engineer
Trevor PaughProject Chronicles

Chronicles / Clipper Overlord

Covers: a week on thumbnails

Progress

About fifteen pull requests on the cover alone: picking a frame automatically, letting Claude judge the candidates, drawing the title in five styles, an Edit cover tool, and setting the YouTube thumbnail only after YouTube finishes processing.

The Edit cover tool over the Inbox: the title typed one line per box, words to highlight, the five styles, a size slider, and a drag-to-place title.
The Edit cover tool over the Inbox: the title typed one line per box, words to highlight, the five styles, a size slider, and a drag-to-place title.

A clip’s cover decides whether anyone taps it. From 2026-09-30 to 2026-10-03 the cover got more attention than any other single feature.

How a cover gets made

  1. Candidate frames. The renderer pulls several stills from the clip, favouring moments with a clearly visible face and no on-screen text overlapping it.
  2. A judge. Claude is shown the candidates and asked to pick the one with the most open, engaged expression and the title kept clear of the face. Its one-line reason is stored and shown in the Inbox, so a strange pick can be understood and overridden.
  3. The title. Drawn onto the frame in Poppins in one of five styles: outlined caps, a highlight box, a big number, a headline bar, or a quote.
  4. Thumbnail upload. YouTube rejects a thumbnail set too early. The publisher now waits for the video to finish processing, then sets the cover.

The editor

Automatic picks are usually right but not always. The Edit cover tool shows the five candidates, lets the owner step through them, redraw the title, or switch style, and saves the result. Covers survive a clip being re-trimmed, which took a dedicated fix after an edit silently reset them.

Why so many rounds

Each piece arrived as its own small PR with a review, and several of the reviews found real problems: covers lost on edit, thumbnails set before processing, title text colliding with the face. Fifteen PRs is what it took to get from “a frame” to “the right frame, titled, kept, and uploaded at the right moment.”