# grab Decode frames of a video file and write them as PNGs (local render, no credits). By default the frames are merged into contact sheets: up to 12 per image, each cell labelled with its timecode (`08s10f`, zero segments dropped) and drawn as large as fits, so a handful of frames arrives as one high-resolution picture instead of a directory to open one by one (separate: true writes a PNG per frame). Grabs the asset's own pixels, unlike capture which renders the composited node. The recommended tool for understanding a video at the frame level; past ~12 frames prefer filmstrip. | | | | --- | --- | | MCP tool | `grab` | | CLI | `diffusion grab [options]` | | CLI aliases | `diffusion sample` | ## Input | Field | Type | CLI | Description | | --- | --- | --- | --- | | `path` | `string`, required | `` | absolute file path or URL (works with or without an open project), or a library path like `b-roll/clip.mp4` (needs an open project) | | `times` | `Time[]` | `-t, --times ` | timestamps to grab — seconds ("1.5"), frames ("45f"), or "MM:SS"; negatives count back from the end, so -1 is one second before the end and -1f one frame before it (default: [0]) | | `count` | `integer` | `-c, --count ` | instead of times, grab this many frames evenly spaced across the clip (or across the start/end window) | | `auto` | `boolean` | `-a, --auto` | scan the clip at 2fps and keep a frame each time the footage settles into a new visual state (transitions are waited out, so picks stay sharp); returns at most count frames (default cap: 30), static footage like screen recordings returns far fewer; requires WebGPU | | `start` | `Time` | `-s, --start