⭐ Star Save Panorama JPEG

You generated a 360° panorama - an equirectangular or cylindrical image stitched from a diffusion model - and you saved it with a normal Save Image node. Then you uploaded it to Google Photos or Facebook and got a flat, squashed mess. That's not your generation's fault: those viewers only know it's a panorama because of metadata, and a plain JPEG carries none.

Star Save Panorama JPEG exists to fix exactly that. It's a one-trick node: it takes your IMAGE batch and writes JPEG files with proper Google GPano XMP metadata baked into the file's APP1 segment. Upload those to Google Photos, Facebook 360, or any viewer that understands the GPano spec and you'll get a pannable cylindrical panorama instead of a wide strip. For the low-effort end of the "I made a 360 world" workflow, this is the save node you want.

How it works

Under the hood it's unglamorous but correct. The node encodes each image to JPEG at a fixed quality of 95, then injects an XMP block carrying the fields panorama viewers look for - ProjectionType="cylindrical", CroppedAreaLeftPixels, FullPanoWidthPixels, FullPanoHeightPixels, UsePanoramaViewer="True" - as an APP1 marker right after the JPEG header. Viewers read that and turn on their panorama mode.

One thing worth knowing: it's hardcoded to cylindrical projection. That's right for horizontal panoramas and most stitched diffusion outputs, but if you're working with a true equirectangular (2:1) image for VR-style viewing you may want to check how the target viewer handles the projection type.

The inputs

There are only two, which is the appeal:

• images - your panorama batch.
• filename_prefix - prefix for the saved files, default "ComfyUI".

That's it. It's an output node, so there are no output sockets - files land in ComfyUI's output folder with the usual counter-based naming, one .jpg per image in the batch.

Installing it

This is part of the big StarNodes pack, so you get it with the rest of the toolbox:

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

Then restart ComfyUI. Or skip all that and use ComfyUI Manager - search for "Starnodes" and install. Find the node by double-clicking the canvas and typing star.

Gotchas

The main trap is expectations: this node writes panorama metadata, it doesn't do any of the fun stuff. If you want depth-map-based stereoscopic 3D output, grab the sibling Star Save Panorama JPG+ instead. And because quality is pinned at 95, don't expect tiny files from big panoramas - you can run the output through a compressor later if you need it small. If you're testing viewers, keep in mind the cylindrical projection assumption above; most people only notice when they switch to a fish-eye source and the pan stops behaving.