Subclip Timeline Contact Sheets
Analyse and review the whole timeline in bulk
Subclip Timeline Contact Sheets
One frame per call is slow and spends tokens on repeated setup. A contact sheet renders the moments you choose from the saved, composed timeline (media, Remotion, HyperFrames, 3D, text, captions) and returns them together as a labelled grid, so you can judge every doubtful moment in one round and fix them in bulk.
Tools
analyze_timeline: one call, no guessing. Duration, canvas, layers by lane, scene boundaries and pacing, audio roles and volumes, titles and caption summary, fonts and colours, mood hints, a colour palette sampled from real frames, a list of issues with times, andrecommendedContactSheetTimes.withContactSheet: trueadds the overview sheet.renderFrames: falsegives an instant text-only answer.get_timeline_contact_sheet: the images. Pick moments withtimes(seconds), orfrom+towithcountorevery, orat:auto,scene-changes,layer-starts,caption-pages. Each tile shows#index m:ss.s fFRAME; refer to "tile 7" or "0:12.4" in your notes and in follow-up edits. Tiles markedHF OFFwere rendered without HyperFrames layers (the HyperFrames browser was unavailable, or you asked forhideHyperframes: true); do not judge those layers from them.
Both are fast by default: detail: "fast" renders every tile at tile size (320 px), not at full canvas size, so a sheet of 12 usually returns in a few seconds, and frames already rendered for the current saved revision are reused (repeating a sheet, or re-checking just the changed times, is almost instant). This is a medium-resolution look meant for quick decisions, not for reading small print. Use detail: "balanced" (384 px tiles from a 2x render) when text in tiles is hard to read, and detail: "full" (whole canvas rendered, then scaled down: the slowest) or a single full-size frame with view_current_frame / export_current_frame only for the few moments that need a close look. Do not ask for full for a first review.
Sheets and manifests are written to the app cache (not into the project), and the result gives their absolute paths; pass saveToProject: true on get_timeline_contact_sheet to keep them in the project workspace. Both work in the background on the latest saved revision; the project does not need to be open. If a render takes longer than waitSeconds, the result has status: "running" and a jobId: call get_timeline_contact_sheet again with that jobId. Read progress.progressState (advancing, waiting, stalled) and progressPercent before you decide anything is stuck; the first HyperFrames frame can take a while while its browser starts. Sheets are saved in outputDirectory (the app cache by default), so you can read them again without rendering.
Workflow
- Orient:
analyze_timeline(default settings). Readissuesfirst, thenscenes,styleandtext. This replaces most outline reads for a first look. - Look:
get_timeline_contact_sheetwithat: "auto", or withtimestaken fromissues[].atandrecommendedContactSheetTimes. Put every moment you are unsure about into the same call. - Decide in bulk: write one fix list keyed by tile number and time (for example "tile 4 0:08.2 title clipped right; tile 7 1:02.0 caption over logo"), then apply all the fixes before looking again.
- Verify only what changed: call
get_timeline_contact_sheetagain withtimeslimited to the changed moments (and one moment either side of a cut you moved). Compare with the first sheet. Do not re-render the whole timeline after a small edit. - Finish with one overview sheet (
at: "auto") as the final evidence. Never claim a visual result you have not seen in a rendered tile after your last edit.
Choosing times
- Whole-video review:
at: "auto"(12 tiles). Longer videos:count: 24(two sheets) or severalfrom/towindows. - Pacing and cuts:
at: "scene-changes". Titles and overlays:at: "layer-starts". Caption styling and line breaks:at: "caption-pages". - Timing of a transition, entrance or exit: one sheet with
every: 0.1(or about three frames either side of the moment) over a shortfrom/towindow. Sheets a second apart miss 1 to 3 frame timing. Convert frames to seconds as frame divided by fps, rounded down. - Before and after: render the same
timesbefore and after the edit and compare tile by tile. - A time past the end is moved to the last frame; two times on the same frame are merged. Read
notesin the result.
Token budget
- A tile is 320 px wide by default and a sheet of 12 costs roughly 1,000 to 1,500 image tokens (see
estimatedImageTokens). Use the defaults for review. For small text preferdetail: "balanced"over a bigger sheet; raisetileWidth(up to 960) and lower the tile count only when you really need more pixels per tile. CheckrenderSeconds,cacheHitsandconcurrencyin the result to see how much was rendered versus reused. - Prefer fewer, deliberate sheets. Up to 48 tiles per call (split into sheets of 12). Use
includeImages: falsewhen you only need the saved files or a count. - HyperFrames layers are captured through a browser; the first frame of each layer is the slow one, later frames of the same layer reuse the warm browser.
hideHyperframes: trueis still the fastest path for a quick layout check on a heavy project; render the HyperFrames layers on the final check.
Reading what you see
Check, per tile: clipping and off-canvas placement, text collisions and safe margins, black or empty frames, stacking order, caption legibility, consistent fonts and colours with the rest of the video, and anything that looks different from the neighbouring tiles. Compare the picture with analyze_timeline: a tile that is empty where a layer should be visible is a real defect, not a rendering quirk, unless it is marked HF OFF.
Use view_current_frame (full size) only for the single moment you need to inspect closely after the sheet shows a doubt; use extract_video_frames only on a source file, not on the timeline.
- Downloads
- 80All time
- Security audit
- Pass
- Last updated
- 2d ago
- Current version
- v1.0.0
- License
- MIT-0
