Dustin Marble Preview Panorama
The flat, honest look at Marble's 360° panorama
- image
Every world Marble generates comes with an equirectangular panorama - the 2:1 flat image that shows the entire 360° view in one frame. It's the most useful single asset the API hands back: one picture that tells you what the whole world actually looks like, which is a much better quality check than the thumbnail. Dustin Marble Preview Pano is the node that fetches that pano_url from your generation results and shows it in the ComfyUI preview panel. Flat, all at once, no interaction needed.
Why this over the 360 viewer?
The pack ships two ways to look at a panorama, and they serve different moments. This node shows the raw equirectangular image as a flat preview. The Pano 360 Viewer embeds an interactive viewer where you drag to look around. The README's own framing: use Preview Panorama for a quick flat preview, use the 360 Viewer for interactive look-around. The flat one is faster to parse, costs nothing to interact with, and - because it returns the IMAGE tensor - lets you actually do something with the panorama rather than just admire it.
What it does
Same shape as the thumbnail preview node: give it asset_urls_json (from any generate node - this is the recommended input) or a direct image_url pointing at the panorama, and it resolves the pano URL, downloads it server-side (avoiding CORS with Marble's CDN), converts to an IMAGE tensor, and shows it in the preview panel. It also accepts the full world_json as asset_urls_json, since the URL resolver digs through nested assets structures to find the panorama either way.
The output and one fair warning
image is a ComfyUI IMAGE tensor, and it's an output node, so you get the preview and a wireable result - save the panorama, feed it onward, whatever. The fair warning: equirectangular panoramas are very wide. A Marble pano is typically a large 2:1 image, and the README says so explicitly - "panoramas can be very wide." Downstream nodes that assume square-ish inputs will behave oddly; if you're processing the tensor, plan for the aspect ratio.
Install
cd ComfyUI/custom_nodes
git clone https://github.com/zihualiu1997/dustin-comfyui-nodes
Restart ComfyUI, or install "dustin-comfyui-nodes" via ComfyUI Manager. No API key needed - like the thumbnail preview, this node only downloads a public URL, it doesn't call the generation API. requests comes with the pack. The one real requirement: feed it asset_urls_json from a generation that actually finished, or a real pano_url.
Inputs (2)
| Name | Type | Default | Description |
|---|---|---|---|
| asset_urls_jsonopt | STRING | — | |
| image_urlopt | STRING | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| image | IMAGE | — |