🌎 360° Panorama Image Viewer for ComfyUI

A custom ComfyUI node for interactive 360° panorama image previews. Easily inspect equirectangular projections in their proper spherical form to verify seams and distortions.

✨ Features

• Interactive 360° panorama viewer
• Adjustable resolution settings
• Intuitive mouse controls

🎮 Usage

Once installed, the viewer node is available as "Preview 360 Panorama" under the 'pytorch360convert' category.

<video src="https://github.com/user-attachments/assets/7b6a6957-3dfa-4bd9-9a81-1861fcd23cc7"></video>

Basic Setup

1. Add the "Preview 360 Panorama" node to your workflow
2. Connect an equirectangular image to the node's input
3. Run your workflow to view the image

Controls

• Pan View: Left-click and drag to look around
• Zoom: Use the mouse scroll wheel
• Resolution: Set max_width to -1 for full resolution (may increase load times)

📦 Installation

Quick Install Options

1. ComfyUI Manager (Recommended)

   • If you have ComfyUI-Manager installed:
     • Either paste this repo's GitHub URL
     • Or find it in the built-in install menu

2. ComfyUI Registry

Using comfy-cli, you can download this project from the comfy registry, like this:

comfy node registry-install comfyui-preview360panorama

Manual Installation

Option 1: Using Git

1. Install Git (Windows download) if you have not done so already
2. Navigate to your ComfyUI's custom_nodes directory
3. Clone the repository:

   git clone https://github.com/ProGamerGov/ComfyUI_preview360panorama --recursive
   

4. Run the installer:

   python ComfyUI_preview360panorama/install.py
   

Option 2: Direct Download

1. Download this repository as a ZIP file
2. Extract it to your ComfyUI's custom_nodes directory
3. Download required Three.js files from cdnjs or mrdoob/three.js:
   • three.core.min.js
   • three.module.min.js
4. Place both files in: custom_nodes/ComfyUI_preview360panorama/js/lib

Directory Structure

The project directory should look like this if installation was successful.

custom_nodes/
└── ComfyUI_preview360panorama/
    ├── __init__.py
    ├── js/
    │   ├── pano_viewer.js
    │   └── lib/
    │       ├── three.core.min.js
    │       └── three.module.min.js
    └── nodes.py

Need more help? Check out the detailed guide on installing ComfyUI extensions.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🔬 Citation

If you use this library in your research or project, please refer to the included CITATION.cff file or cite it as follows:

BibTeX

@misc{egan2025preview360panorama,
  title={Preview 360 Panorama},
  author={Egan, Ben},
  year={2025},
  publisher={GitHub},
  howpublished={\url{https://github.com/ProGamerGov/ComfyUI_preview360panorama}}
}

APA Style

Egan, B. (2025). Preview 360 Panorama [Computer software]. GitHub. https://github.com/ProGamerGov/ComfyUI_preview360panorama

🌐 Related

For editing 360 images inside ComfyUI, see the ComfyUI_pytorch360convert custom nodes.