⭐ Star 360 Parallax Viewer

Generating 360° panoramas with a diffusion model is easy. Looking at the result is the problem - a flattened equirectangular image looks like a weirdly stretched smear, and you can't tell whether the horizon matches at the seam. Star 360 Parallax Viewer fixes the preview side: it renders the panorama as an interactive 360° sphere with a parallax effect, so you can look around it with your mouse inside ComfyUI, exactly like you're turning your head in Street View.

The pack's panorama tools are a deliberate little ecosystem - a 360 Parallax Viewer, a Pro version that exports frames for video, and JPEG savers that embed proper XMP panorama metadata. This one is the pure viewing/checking tool: you hook an image up, you inspect it, you iterate. It's the node you want attached to the end of a panorama generation workflow so you can validate before you save.

How it works

It takes an IMAGE, writes it to ComfyUI's temp folder, and launches an interactive viewer with mouse-drag look-around and parallax. The layout dropdown is the important bit, because it's about how your stereo content is stored:

• Mono - a single flat panorama.
• SBS (side-by-side) - left eye and right eye images side by side in one frame.
• Top/Bottom - stereo pair stacked vertically. Default, and the common layout for AI-generated 360 video.

There's also an optional depth_map input - feed it a depth image and the parallax gets real 3D separation instead of just rotation, which is where "parallax" in the name comes from.

No outputs - this is an output node whose entire job is to show you the image.

Install

Part of the Starnodes2024/ComfyUI_StarNodes pack:

cd ComfyUI/custom_nodes
git clone https://github.com/Starnodes2024/ComfyUI_StarNodes
cd ComfyUI_StarNodes
pip install -r requirements.txt

Restart and search star. The base viewer needs nothing special; the Pro and save-side tools pull in opencv-python from the same requirements file.

Where people get burned

The biggest trap is layout mismatches: feeding a flat Mono panorama in while layout is set to Top/Bottom makes the viewer treat the top and bottom halves as two different eyes - everything looks doubled and broken, and it's not the image's fault. Check the layout. Second, the optional depth map only does its thing when the parallax effect can use it; connect it and expect the depth to drive the 3D, not just subtly tweak it. And because the viewer stages files in the temp directory, be ready for it to not persist after a full restart - it's a look tool, not an archive.