ComfyUI-Sonder-Editor

Sonder Editor is a timeline-based video editor for ComfyUI, built for iterative long-form generation. Arrange scenes, clips, audio, guide frames, and prompts; then select the range you want to process.

Generation stays in ComfyUI; Sonder is where each iteration starts and ends — send the selection through the connected graph, then review or place the result back on the timeline. Sonder's generation capabilities and constraints depend on the diffusion model, nodes, and workflow connected to it.

▶ Watch the 90-second overview

What it is

Sonder Editor adds a timeline-based editing surface to ComfyUI without taking generation out of the node graph. You import media into a project, lay clips, audio, guides, and prompts onto a multi-lane timeline, select a range (or stage a batch of render jobs), and hand that off to the generation workflow you've wired up downstream. Outputs come back as project assets you can review, compare, and place back on the timeline.

<p align="center"> <img src="docs/images/node.png" width="420" alt="The Sonder Editor node in a ComfyUI graph, showing its sockets, project card, and inline viewport preview"> </p> <p align="center"><em>One native node in your graph — sockets in, sockets out. The fullscreen editor opens from it, and the dormant node keeps a live project card and viewport preview.</em></p>

See it work

Three techniques from the same project, run through the same workflow. Each clip shows the timeline alongside the result it produced — and both halves are yours to open: the scenes are in the sample project, and the example workflow is the one that generated them.

Prompt Relay

Prompt sections are cut along the timeline, each applying to its own range, so a single clip moves through a whole beat instead of holding one prompt for its entire length. Sonder Prompt Relay Bridge exports the render window's prompt lanes as ComfyUI-PromptRelay payload strings.

https://github.com/user-attachments/assets/3c1643f7-3944-4949-b7da-a47ad9c5fa5b

Guides

Guide frames sit on the timeline where you place them — first and last, or any frame in between — and the model fills what falls between them. Guides have their own lane and an animatic preview mode; Sonder Guides Bridge Start / End wrap the generation body to inject them per frame.

https://github.com/user-attachments/assets/31e013a7-7e34-4f8d-8dc2-9114fe157165

IC-LoRA motion transfer

An OpenPose clip on a Driver lane drives the generation frame for frame. Sonder Driver Selector and Sonder Driver Bridge resolve and decode that lane for the render window, so driver and result stay in lockstep on the timeline.

https://github.com/user-attachments/assets/7c8459fb-6d10-4b84-9bc6-a1e98308c3f1

Highlights

• Multi-lane timeline — video/audio lanes with drag, trim, split, snapping, lock/hide, lane management, multi-layer compositing, and per-item fit modes.
• Scenes — each with its own duration, resolution, and FPS.
• Prompt sections — two prompt lanes with Visual/Speech/Sounds channels, templates, and history.
• Guide frames — per-frame reference images for conditioning, with an animatic preview mode. For LTX-style workflows, Settings > Guides exposes a project-durable Guide collision auto-offset toggle (default on): single- image guides are moved to the nearest free temporal coordinate when a Driver occupies the same RoPE slot, and the applied move is recorded in generated asset metadata. With the toggle off, queueing warns about unresolved collisions. The editor CSV outputs and Sonder Guides Bridge are alternative injection paths; do not inject the same project guides through both.
• Selections & context — saved in/out ranges with pre/post context frames and mask offsets for generation overlap.
• Render queue + batch render — stage and queue render jobs, including contiguous chunked batches.
• Asset gallery — project-scoped assets and artifacts, folders, inspector, compare mode, trash/restore, favorites, reference-aware deletes, and tracked generation metadata.
• Timeline export — export video/audio with a frame-streaming CPU compositing path; practical duration is bounded by disk space rather than RAM.
• Color-managed exports — video presets encode and tag BT.709, and timeline decoding honors source color tags, so exports match the browser preview.
• Playback — fullscreen/dormant viewport preview with adaptive rebuffering.

Nodes

Sonder Editor is the only node you always add — the rest are optional pipeline adapters, grouped under the Sonder, Sonder/IO, and Sonder/Logic menus in ComfyUI.

Editor & generation bridges — Sonder

| Node | What it does | |------|--------------| | Sonder Editor | The main editor and output node: timeline, scenes, gallery, and render queue. | | Sonder Guides Bridge Start / End | Paired loop nodes that wrap a generation body to inject per-frame guide images. | | Sonder Driver Selector | Resolves a selected Driver lane without decoding media and exposes a has_driver presence flag for lazy routing; pass its reference to the Driver Bridge. | | Sonder Driver Bridge | Decodes the selected Driver lane's frames from a Driver Selector reference, emitting driver images, local start index, and conditioning strength for the render window. | | Sonder Masks Bridge | Exposes the editor's generation-mask window as separate video/audio mask-time pairs, each gated by an Edit/Freeze toggle (a frozen channel emits a zero-width window, so nothing is generated for it). Feed a downstream temporal mask node. | | Sonder Prompt Relay Bridge | Exports the render window's prompt lanes as ComfyUI-PromptRelay payload strings (no model patching). |

Save & preview — Sonder/IO

| Node | What it does | |------|--------------| | Sonder Save Video | Encodes an IMAGE tensor to a project video asset, optionally muxing audio; previews the first frame. Auto-corrects accumulated VAE color drift against the render's protected context frames (color_drift_correction, on by default). | | Sonder Save Bridge | Creates a prompt-isolated output target in the project cache — external save nodes write there, then the bridge registers the results into the Sonder asset system after the prompt settles. | | Sonder Preview Video | Encodes frames to a temporary video for in-UI preview playback. | | Sonder Metadata Collector / Sonder Metadata Collector Nodes 2.0 | Both collect explicitly wired upstream widget values into a generated asset's tracked metadata. The established collector keeps manually shaped workflow sockets; the Nodes 2.0 entry uses native heterogeneous V3 Autogrow sockets when the installed ComfyUI supports them. |

Routing & logic — Sonder/Logic

| Node | What it does | |------|--------------| | Sonder Selector | Selects one label from a newline-delimited list and outputs its text plus zero-based index. | | Sonder Switch | Routes any one data type across N branches and evaluates only the selected branch (lazy). | | Sonder Cluster | Routes a shared branch selection across multiple lanes, each lane carrying its own type (lazy). |

Sonder Switch, Sonder Cluster, and Sonder Metadata Collector Nodes 2.0 use ComfyUI's newer V3 node API and load only on recent ComfyUI builds. V3 registration is schema-validated before it changes discovery: older or incompatible builds keep the complete V1 node set under the normal Sonder Metadata Collector name. When V3 is available, it appears separately as Sonder Metadata Collector Nodes 2.0. Automatic migration is not enabled: frontend v1.45.21 only offers replacements for missing node types and does not transfer links into dotted Autogrow inputs. Use V3 for new collectors until ComfyUI can preserve those links.

Requirements

• ComfyUI (recent version). Nodes 2.0 widget hiding requires a frontend that processes widget.options.hidden (including frontend v1.45.21 and current stable builds); earlier frontend builds retain the legacy LiteGraph fallback.
• Python 3.10+ (matching your ComfyUI environment).
• ffmpeg — required for video/audio decode, encode, and export. The imageio-ffmpeg dependency bundles a usable ffmpeg automatically, but a system-wide ffmpeg on your PATH is recommended for the widest format support.
• torch is provided by ComfyUI and is not installed by this pack (see Troubleshooting).

Installation

Option A — ComfyUI-Manager (recommended)

Search for Sonder Editor in ComfyUI-Manager and install, then restart ComfyUI.

Not yet on the Registry? Use Option B until the first publish lands.

Option B — Manual (git clone)

cd ComfyUI/custom_nodes
git clone https://github.com/SonderSaid/ComfyUI-Sonder-Editor.git
cd ComfyUI-Sonder-Editor
pip install -r requirements.txt

Then restart ComfyUI. The pack registers its nodes and serves its web UI automatically.

Quickstart

1. Add the Sonder Editor node to your graph.
2. Open the editor (expand the node card to enter the fullscreen session).
3. Import media — drag files or a folder into the asset gallery.
4. Build a timeline — drag clips onto lanes; trim/arrange them; add guide frames and prompt sections as needed.
5. Choose what to render — set an in/out Selection on the timeline, or stage jobs in the Render Queue.
6. Wire the handoff — connect the editor's output into your generation workflow and a downstream Sonder Save Video (or Sonder Preview Video) node.
7. Run the prompt. The editor renders the selected window (or queued snapshots) into your workflow, and outputs return as project assets.

Example workflow

Download the **[Sonder LT