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
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.
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.
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 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.
Interrogation.Showcase.mp4
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.
Pretty.People.Showcase.mp4
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.
Dance.Showcase.mp4
- 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.
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.
| 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). |
| 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. |
| 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.
- 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-ffmpegdependency bundles a usable ffmpeg automatically, but a system-wideffmpegon yourPATHis recommended for the widest format support. torchis provided by ComfyUI and is not installed by this pack (see Troubleshooting).
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.
cd ComfyUI/custom_nodes
git clone https://github.com/SonderSaid/ComfyUI-Sonder-Editor.git
cd ComfyUI-Sonder-Editor
pip install -r requirements.txtThen restart ComfyUI. The pack registers its nodes and serves its web UI automatically.
- Add the Sonder Editor node to your graph.
- Open the editor (expand the node card to enter the fullscreen session).
- Import media — drag files or a folder into the asset gallery.
- Build a timeline — drag clips onto lanes; trim/arrange them; add guide frames and prompt sections as needed.
- Choose what to render — set an in/out Selection on the timeline, or stage jobs in the Render Queue.
- Wire the handoff — connect the editor's output into your generation workflow and a downstream Sonder Save Video (or Sonder Preview Video) node.
- Run the prompt. The editor renders the selected window (or queued snapshots) into your workflow, and outputs return as project assets.
Download the Sonder LTX 2.3 Playground workflow for a ready-wired generation graph covering prompt relay, multi-pass upscaling, image guides, and driver-controlled generation. It pairs with the sample project below.
- Getting Started — install to first generated take, starting with pure text-to-video.
- Editor Basics — layout, timeline, item types, gestures, and shortcuts.
- Generating — the generation window, model templates, prompts, guides, Drivers, the render queue, and what's frozen vs. live in queued jobs.
- Assets & Gallery — asset lifecycle, tracked metadata, inspect/compare, and timeline export.
A ready-made showcase project — media, scenes, guides, prompts, generated takes, and cached thumbnails — is available as a direct download.
- Download
Project-Sample.zip. - Extract it into
ComfyUI/output/sonder-projects/so the sample sits in its own folder there. - Open the Sonder Editor node and select the project from the project selector.
- Sonder Editor stores projects as local files under ComfyUI's configured output area. Do not expose a ComfyUI instance running this pack to untrusted networks unless you have put ComfyUI behind your own authentication and network controls.
- Generated files can embed ComfyUI prompt/workflow metadata when Embed Metadata is enabled on Sonder Save Video. Turn that off before sharing files if your graph, prompts, paths, model names, or node settings are private.
- Project
media/,cache/, and generated output folders are user data, not source distribution files. Do not commit them to a public repository. - External Project Links is off by default. Enabling it in Editor Settings makes this ComfyUI installation follow project and media symlinks/junctions wherever the editor resolves files. Treat every linked folder as readable by anyone who can reach your ComfyUI server.
torch / torchaudio got reinstalled and GPU stopped working.
ComfyUI ships a torch build matched to your GPU/CUDA. This pack intentionally
does not list torch/torchaudio in its requirements so an automatic
pip install can't overwrite that build with a mismatched (often CPU-only)
wheel. If audio features need torchaudio and it's missing, install the build
that matches your existing torch/CUDA version manually.
cv2 import errors after installing another custom node.
This pack uses opencv-python-headless (no GUI dependencies, correct for a
server). Some other custom nodes install the full opencv-python package, and
the two conflict — whichever was installed last wins, and the other's cv2 can
break. If you hit this, pick one variant for your whole environment (headless is
the safe choice for ComfyUI) and reinstall it so it's the only OpenCV present.
ffmpeg not found / export or decode fails.
Install ffmpeg and make sure it's on your PATH, then restart ComfyUI. The
bundled imageio-ffmpeg binary is used as a fallback, but a system ffmpeg is
more capable across formats.
I can't link a project on another drive or a UNC share. Enable Allow External Project Links in Editor Settings first, then use Link project folder... from the project menu and paste the server-visible path. Local Windows drives use a junction without elevated privileges; UNC paths need a true symlink, which requires Windows Developer Mode or an elevated ComfyUI process. Do not toggle the setting while a render or Save Bridge job is in flight; its finalization safely remains pending until the matching path is trusted again.
ComfyUI-Sonder-Editor — Copyright (C) 2026 SonderSaid
This program is free software: you can redistribute it and/or modify it under the terms of version 3 of the GNU General Public License as published by the Free Software Foundation.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for details, or visit https://www.gnu.org/licenses/.