ComfyUI Node

Panorama Preview

The node that lets you actually see the panorama you made

By nomadoor·Created 6 months ago·Updated 13 days ago· 162
Panorama Preview
  • erp_image
  • audio
    coverage360
    fps24

    Let's be honest: a flat preview of a 2:1 equirectangular image is almost useless. The whole world is squished into one rectangle, so you can't judge whether the floor meets the walls, whether the horizon is level, or whether anything at the wrap-around seam lines up - which is exactly the thing that's usually broken. Panorama Preview is the "just let me look at it" node from nomadoor's ComfyUI-Panorama-Stickers pack: it drops an interactive viewer onto your canvas so you can drag around inside the 360° scene and inspect it the way a human actually would.

    It exists because the pack's other nodes - Panorama Cutout and Panorama Stickers - are built around the author's FLUX.2 Klein 360° ERP outpaint LoRA, where you're constantly checking whether a generated panorama actually hangs together. You could preview with the default image node, but it just shows the squished rectangle. This one shows you the scene. And since it's a dedicated viewer, it doesn't duplicate the default preview widget in your workflow.

    How it works

    It's the simplest node in the pack, which is kind of the point. There's no image processing beyond what ComfyUI already does - the node hands your ERP tensor to a WebGL-first viewer (switched from the earlier approach in v1.1.0) that lives in the pack's frontend extension. You drag to look around, and the sphere rendering is done on the GPU in your browser, not on the server. If you feed it a video batch - the pack has supported video since v1.3.0 - it encodes an mp4 preview so you get actual playback rather than a frozen frame.

    The inputs

    It's refreshingly thin:

    • erp_image - your equirectangular image, or video batch. Required.
    • coverage - 360 (full sphere, default) or 180 for half-sphere panoramas. Set this to match your image, or the viewer will interpret the projection wrong and things will look stretched.
    • fps - preview playback framerate for video. Defaults to 24. Irrelevant for a still image.
    • audio - optional audio track for video previews. Again: stills don't care.

    And that's it. There are no outputs - this is a terminal, view-only node. That's the whole design. It's the node you drop at the end of a branch just to look, while the real output goes to Save Image.

    Installing it

    Standard pack install, same as its siblings: ComfyUI Manager (search "Panorama Stickers") or clone the repo into custom_nodes:

    cd ComfyUI/custom_nodes
    git clone https://github.com/nomadoor/ComfyUI-Panorama-Stickers
    

    Then restart ComfyUI. No model files, no extra Python dependencies for stills. If you want video playback to encode properly, make sure you have PyAV or another mp4 encoder available - otherwise you'll get a warning in the console and the preview may fall back to static.

    Where people get burned

    First: nothing comes out the other side. People wire this into a graph expecting a preview image output and then hunt for the output slot. There isn't one - the whole point is that the interactive view is the output.

    Second: don't expect it to fix anything. It's a viewer, not a validator. If your seam is misaligned, the viewer will faithfully show you the seam. That's a feature - that's how you notice you need Panorama Seam Prep or a seam-inpaint pass before you consider the job done.

    CategoryPanorama Suite

    Inputs (4)

    NameTypeDefaultDescription
    erp_imageIMAGE
    coverageCOMBO3602 options: 360, 180
    fpsFLOAT241–120Preview playback framerate.
    audiooptAUDIOOptional audio for preview playback.

    Outputs (0)

    No outputs