Nodes/Dustin ComfyUI Nodes/Dustin Marble Preview Panorama
ComfyUI Node

Dustin Marble Preview Panorama

The flat, honest look at Marble's 360° panorama

By zihualiu1997·Created 4 months ago·Updated 4 months ago· 1
Dustin Marble Preview Panorama
    • image
    asset_urls_json
    image_url

    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.

    CategoryDustin Nodes/Marble

    Inputs (2)

    NameTypeDefaultDescription
    asset_urls_jsonoptSTRING
    image_urloptSTRING

    Outputs (1)

    NameTypeDescription
    imageIMAGE