Nodes/Image Oasis/Video Oasis Viewer 🌴
ComfyUI Node

Video Oasis Viewer 🌴

A Save Video node that doesn't touch your output folder until you say so

By NikoDemon80·Created 3 months ago·Updated 3 days ago· 24
Video Oasis Viewer 🌴
  • video
  • video
â—„video_oasis_ui{}â–º

Stock ComfyUI's video preview story is a mess: either you get the cheap in-graph preview that can't scrub, or you wire in a Save Video node and suddenly every queue run is dumping files into your output folder. Video Oasis Viewer (class VideoOasisPreview) fixes the second half: it's a preview-first player that encodes to ComfyUI's temp directory and doesn't write anything to output/ until you press Save. Same node that LTX Oasis uses internally for its own playback, available standalone so anything that emits a VIDEO can get a proper player.

Plug a VIDEO in, run the graph, and you get a real editor-style player: scrub bar with frame counter, frame-step (arrows, Shift for ~1s), mute, playback speed, and a lightbox with scroll-to-zoom and drag-to-pan. The loop button cycles off → loop → cycle, where cycle walks the scene bar like a rolling dailies reel - nice for judging a batch of variations without clicking through them.

The scene bar is the star

Up to 48 recent clips live in a thumbnail strip under the player. Click one to load it; long-press drag to reorder; the + button loads any video from your output/ tree; a ✓ marks the ones you've saved. It survives ComfyUI tab switches and page reloads - the temp previews get pruned on a full restart, but saved files stay. The workflow here is: generate a bunch, scan them in the bar, save the keepers. That's genuinely better than the old generate-and-pray-into-output loop.

Two power moves live in the bar:

  • Clip - scrub to an in-point, hit [, scrub to the out, hit ], press Clip. You get a trimmed copy (e.g. output/video/clip_NNNNN.mp4) in the bar.
  • Create Movie - concatenates every saved bar clip left to right into one file. If the clips share bitstream params it's a stream-copy (lossless, fast); after Clip or mixed encode settings it re-encodes so joins stay clean. The join audio is rebuilt rather than blindly spliced - clips are trimmed to their own frame count and the samples either side of each cut are crossfaded, which kills the AAC tail-padding gap and the audio-drift that plagued naive concats down a long scene bar. Per-clip detail prints to the console under [VOV Movie].

You can also drag a paused frame straight off the player onto any image input on the graph - Load Image, LTX's Start Frame, beat guides, whatever. It's a tiny feature and it saves a whole save-then-load step.

The inputs and outputs that matter

The required input is the one you came for:

  • video (VIDEO) - "The video to preview (and save when you press Save)." That tooltip is the whole node in one sentence.

Everything else (format, codec, quality, save prefix) lives in the video_oasis_ui STRING widget, serialized with the node. The single output:

  • video (VIDEO) - passes the same tensor through so you can keep chaining downstream without an extra pass.

Encode/save options mirror LTX Oasis: Format auto/mp4/webm/mkv, Codec auto/h264/hevc/vp9/av1, Quality balanced/high/small/custom (custom exposes CRF), Save prefix default video/VideoOasis. auto everything matches stock Save Video's fast path.

Installing it

Part of the pack, so it's the same one-time install:

cd ComfyUI/custom_nodes
git clone https://github.com/NikoDemon80/ComfyUI-Image-Oasis
cd ComfyUI-Image-Oasis
pip install -r requirements.txt

Restart ComfyUI and hard-refresh (Ctrl+F5). ComfyUI Manager lists the pack as "Image Oasis". No extra video pack is needed - encode and player are in-pack. Dependencies are minimal since ComfyUI itself provides the video stack.

Common gotchas

  • HEVC may not play in-browser. The file on disk is fine; the preview pane just can't always decode it. If you see a black player but a good file, that's the codec, not a broken render - drop to h264 for in-node playback.
  • Create Movie wants matching resolution and FPS across clips. Mismatched clips will still concat, but expect re-encodes and possible letterboxing surprises. Keep a run on one resolution.
  • Temp previews die on restart - anything not saved is gone after a full ComfyUI restart. If you think you might want it, hit Save before you shut down.
  • The movie isn't excluded from the next Create Movie - concatenating a movie with more clips is how you build runs longer than the bar holds, but it means you have to delete bar entries you don't want in the next concat. The ✕ button is your friend.

If you're generating video with any VIDEO-emitting node, this is the preview player worth reaching for - especially paired with LTX Oasis, which is how most people meet it.

Categoryvideo

Inputs (2)

NameTypeDefaultDescription
videoVIDEOThe video to preview (and save when you press Save).
video_oasis_uioptSTRING{}—

Outputs (1)

NameTypeDescription
videoVIDEO—