Nodes/ComfyUI_StarNodes/⭐ Star 360 Parallax Viewer Pro
ComfyUI Node

⭐ Star 360 Parallax Viewer Pro

Turn your 360° panorama into a parallax video loop, frames and all

By Starnodes2024·Created 2 years ago·Updated 2 days ago· 106
⭐ Star 360 Parallax Viewer Pro
  • image
  • depth_map
  • overlay_image
  • overlay_mask
  • frames
layoutTop/Bottom
create_video_framesfalse
resolutionFull HD (1920x1080)
ratio16:9
custom_ratio21:9
framerate30
directionRight to Left
num_loops1
zoom1.0
speed30
overlay_effectNone
overlay_opacity100

The plain ⭐ Star 360 Parallax Viewer is for looking. Star 360 Parallax Viewer Pro is for producing: it adds the video side of the family. Beyond the same interactive 360° panorama with parallax, it can render the camera sweep as an actual image batch - frames you can hand to a video combine/save node to get a smooth looping pan across your panorama. Think "360 world showcase reel" rather than "check my seam."

That's the real reason to choose Pro over the base viewer. If your deliverable is a short cinematic pan over a generated environment - a city at dusk, an interior, a landscape - this node does the camera work and dumps frames at a resolution and framerate you pick, so you don't hand-roll a slow pan in post.

How it works

Connect your panorama IMAGE and (optionally) a depth_map for real parallax, then set create_video_frames to true. The node renders the sweep at your chosen resolution (HD 1280x720 or Full HD 1920x1080), ratio (16 presets plus a custom_ratio string like 21:9), framerate (24–60), direction, num_loops and speed, and outputs the frames as one IMAGE batch. The zoom control (0.1–5) plus the overlay options - overlay_effect (None/Black/White/Blur/Overlay) with overlay_opacity, plus optional overlay_image and overlay_mask inputs - let you grade the look in-node instead of in an editor.

Inputs that matter

  • create_video_frames - the master switch between "just view" and "render frames."
  • layout - Mono, SBS or Top/Bottom; must match how your stereo content is stored.
  • resolution / ratio / framerate / speed / num_loops - the video output's shape and motion.
  • zoom / overlay_effect / overlay_image / overlay_mask - framing and grading.
  • depth_map - optional, drives the parallax separation.

Output: frames (IMAGE), a batch you feed into a video combine/save node (the pack's own ⭐ Star Video Compressor or any video saver).

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, search star. This one leans on opencv-python from the requirements list for the rendering, so run the full pip install -r requirements.txt rather than skipping it.

Where people get burned

Forgetting to flip create_video_frames and then wondering why there's no frames output is the classic - with it off, the node behaves like the base viewer. Layout mismatch is the second (Top/Bottom stereo treated as mono looks broken - match the dropdown to your image). And the overlay tools are finicky: an overlay_effect of Overlay wants an actual overlay_image connected, otherwise you get an effect with nothing to show. Start with speed modest (30 is the default) - extreme speeds make the pan look juddery regardless of framerate.

Category⭐StarNodes/Image And Latent

Inputs (16)

NameTypeDefaultDescription
imageIMAGE
layoutCOMBOTop/Bottom3 options: Mono, SBS, Top/Bottom
create_video_framesBOOLEANfalse
resolutionCOMBOFull HD (1920x1080)2 options: HD (1280x720), Full HD (1920x1080)
ratioCOMBO16:916 options: custom, 1:1, 1:2, 3:4, 2:3, 5:7, +10
custom_ratioSTRING21:9
framerateCOMBO305 options: 24, 25, 30, 50, 60
directionCOMBORight to Left2 options: Right to Left, Left to Right
num_loopsINT11–100
zoomFLOAT1.00.1–5
speedFLOAT301–360
overlay_effectCOMBONone5 options: None, Black, White, Blur, Overlay
overlay_opacityINT1000–100
depth_mapoptIMAGE
overlay_imageoptIMAGE
overlay_maskoptMASK

Outputs (1)

NameTypeDescription
framesIMAGE