⭐ Star 360 Parallax Viewer Pro
Turn your 360° panorama into a parallax video loop, frames and all
- image
- depth_map
- overlay_image
- overlay_mask
- frames
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,SBSorTop/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.
Inputs (16)
| Name | Type | Default | Description |
|---|---|---|---|
| image | IMAGE | — | |
| layout | COMBO | Top/Bottom | 3 options: Mono, SBS, Top/Bottom |
| create_video_frames | BOOLEAN | false | — |
| resolution | COMBO | Full HD (1920x1080) | 2 options: HD (1280x720), Full HD (1920x1080) |
| ratio | COMBO | 16:9 | 16 options: custom, 1:1, 1:2, 3:4, 2:3, 5:7, +10 |
| custom_ratio | STRING | 21:9 | — |
| framerate | COMBO | 30 | 5 options: 24, 25, 30, 50, 60 |
| direction | COMBO | Right to Left | 2 options: Right to Left, Left to Right |
| num_loops | INT | 11–100 | — |
| zoom | FLOAT | 1.00.1–5 | — |
| speed | FLOAT | 301–360 | — |
| overlay_effect | COMBO | None | 5 options: None, Black, White, Blur, Overlay |
| overlay_opacity | INT | 1000–100 | — |
| depth_mapopt | IMAGE | — | |
| overlay_imageopt | IMAGE | — | |
| overlay_maskopt | MASK | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| frames | IMAGE | — |