{"id":24837863,"url":"https://github.com/ProGamerGov/ComfyUI_pytorch360convert","last_synced_at":"2025-10-14T11:32:32.350Z","repository":{"id":274553221,"uuid":"922673360","full_name":"ProGamerGov/ComfyUI_pytorch360convert","owner":"ProGamerGov","description":"Custom ComfyUI nodes using pytorch360convert","archived":false,"fork":false,"pushed_at":"2025-08-29T01:57:58.000Z","size":428,"stargazers_count":16,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-29T05:16:54.535Z","etag":null,"topics":["180","180-degree","360","360-degree","circular-padding","comfyui","comfyui-nodes","equirectangular","hdri","image-sphere","monoscopic","photo-sphere","spherical-photo","stereo-image","stereo-vision","vr"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ProGamerGov.png","metadata":{"files":{"readme":"ReadMe.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-26T20:10:44.000Z","updated_at":"2025-08-29T01:58:01.000Z","dependencies_parsed_at":"2025-01-28T01:36:38.302Z","dependency_job_id":"a1e1b8f8-4bc7-415d-b86d-bf57631889cc","html_url":"https://github.com/ProGamerGov/ComfyUI_pytorch360convert","commit_stats":null,"previous_names":["progamergov/comfyui_pytorch360convert"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ProGamerGov/ComfyUI_pytorch360convert","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProGamerGov%2FComfyUI_pytorch360convert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProGamerGov%2FComfyUI_pytorch360convert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProGamerGov%2FComfyUI_pytorch360convert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProGamerGov%2FComfyUI_pytorch360convert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ProGamerGov","download_url":"https://codeload.github.com/ProGamerGov/ComfyUI_pytorch360convert/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ProGamerGov%2FComfyUI_pytorch360convert/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019089,"owners_count":26086516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["180","180-degree","360","360-degree","circular-padding","comfyui","comfyui-nodes","equirectangular","hdri","image-sphere","monoscopic","photo-sphere","spherical-photo","stereo-image","stereo-vision","vr"],"created_at":"2025-01-31T06:02:17.253Z","updated_at":"2025-10-14T11:32:32.344Z","avatar_url":"https://github.com/ProGamerGov.png","language":"Python","funding_links":[],"categories":["Workflows (3395) sorted by GitHub Stars","All Workflows Sorted by GitHub Stars"],"sub_categories":[],"readme":"# 📷 PyTorch 360° Image Conversion Toolkit for ComfyUI\n\n## Overview\n\nThis project implements the functions from [pytorch360convert](https://github.com/ProGamerGov/pytorch360convert) as custom [ComfyUI](https://github.com/comfyanonymous/ComfyUI) nodes, along with a few additional useful functions for working with equirectangular 360 images and cubemaps.\n\nThe pytorch360convert library provides powerful and differentiable image transformation utilities for converting between different panoramic image formats like Equirectangular (360°) Images, Cubemap Representations, and Perspective Projections.\n\n| E2C -\u003e C2E | E2C -\u003e Split -\u003e Rebuild -\u003e C2E |\n| :---: | :----: |\n| ![](example_workflows/example_basic_equi2cubemap2equi.png) | ![](example_workflows/example_basic_equi2cubemap2split2equi.png) |\n\n\n## 🔧 Requirements\n\n- [pytorch360convert](https://github.com/ProGamerGov/pytorch360convert)\n\n\n## 📦 Installation\n\nIf the provided installation information below is not enough, then please see here for more details on installing custom ComfyUI nodes: https://www.comflowy.com/advanced/how-to-install-comfyui-extension\n\n### ComfyUI Manager install\n\nIf [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager) is installed, then you can download via pasting in the github link to this repo, or via the built-in install menu.\n\n### Installation for portable ComfyUI\n\n#### Basic install\n\nDownload this repo as a zip file and then unzip it inside the ComfyUI custom_nodes directory. \n\nThen install the dependency:\n\n```\npython -m pip install pytorch360convert\n```\n\n#### git install\n\nIf using Windows, you can install git from here: https://git-scm.com/download/win if you have not done so already and wish to use Git. Then navigate to the custom nodes directory and then run:\n\n```\ngit clone https://github.com/ProGamerGov/ComfyUI_pytorch360convert --recursive\n```\n\nThen install the dependency for Linux and MacOS:\n\n```\npython -m pip install pytorch360convert\n```\n\nOr for Windows:\n\n```\npath/to/python.exe -m pip install pytorch360convert\n```\n\n#### ComfyUI registry install\n\n```\ncomfy node registry-install comfyui-pytorch360convert\n```\n\n\n## 💡 Usage Examples\n\nSee the provided workflow files in the `examples` directory for examples of how to use each new node.\n\n\n## 📚 Nodes\n\nThe custom nodes added by this project are available under the 'pytorch360convert' heading in the node selection tab.\n\n### Equirectangular to Cubemap (E2C)\n\nThe E2C node converts equirectangular images into cubemaps. For more information see the pytorch360convert repo [here](https://github.com/ProGamerGov/pytorch360convert?tab=readme-ov-file#-basic-functions).\n\n### Cubemap to Equirectangular (C2E)\n\nThe C2E node converts cubemaps into equirectangular images. For more information see the pytorch360convert repo [here](https://github.com/ProGamerGov/pytorch360convert?tab=readme-ov-file#-basic-functions).\n\n### Equirectangular to Perspective (E2P)\n\nThe E2P node converts equirectangular images into perspective images. For more information see the pytorch360convert repo [here](https://github.com/ProGamerGov/pytorch360convert?tab=readme-ov-file#-basic-functions).\n\n### Equirectangular to Equirectangular (E2E)\n\nThe E2E node rotates an equirectangular image along one or more axes (roll, pitch, and yaw) to produce a horizontal shift, vertical shift, or to roll the image. For more information see the pytorch360convert repo [here](https://github.com/ProGamerGov/pytorch360convert?tab=readme-ov-file#-basic-functions).\n\n### Roll Image Axes\n\nThe Roll Image node rolls an image along the height dimension (y axis) or the width dimension (x axis). This can help make artifacts like seams more accessible. Note that y axis rotations are not correct for final equirectangular outputs. Use the E2E node instead for y axis rotations.\n\nIf you set 'roll_x_by_50_percent' to True, then any x and y axis values are ignored, and the image is shifted horizontally to be 50%. This is equivalent to a 180 degree rotation on an equirectangular image.\n\n### Roll Mask Axes\n\nThe Roll Mask node rolls an mask along the height dimension (y axis) or the width dimension (x axis). This can help make artifacts like seams more accessible. Note that y axis rotations are not correct for final equirectangular outputs. Use the E2E node instead for y axis rotations.\n\nIf you set 'roll_x_by_50_percent' to True, then any x and y axis values are ignored, and the image is shifted horizontally to be 50%. This is equivalent to a 180 degree rotation on an equirectangular image.\n\n### Crop Image with Coords \u0026 Paste Image with Coords\n\nThese two nodes allow you to crop a section of an image out to make things like in-painting faster and more memory efficient, before pasting the cropped section back into the original image.\n\nBy default, the cropping node center crops images according to the provided crop_h and crop_w values. If crop_h2 and crop_w2 are used, then the image will be cropped according to `[..., crop_h:crop_h2, crop_w:crop_w2, ...]`.\n\n### Masked Diff C2E\n\nThis is an experimental node for only pasting the modified parts of face images to the original equirectangular image. This is meant to help lessen the loss of image quality caused by converting between equirectangular and cubemap formats.\n\n### Pad 180 to 360 Equirectangular\n\nThis node pads a given 180 degree equirectangular image, so that it becomes a 360 degree equirectangular image.\n\n### Crop 360 to 180 Equirectangular\n\nThis node crops a 360 degree equirectangular image into a 180 degree equirectangular image.\n\n### Crop Stereo to Monoscopic\n\nThis node allows you to horizontally or vertically crop a 360 degree equirectangular image that is in stereo format or 3D format, into two separate monoscopic images.\n\n### Merge Monoscopic into Stereo\n\nThis node allows you to combine two separate monoscopic 360 degree images into a single stereo or 3D image.\n\n### Apply Circular Padding Model\n\nThis node allows you to apply circular padding to the x-axis of all Conv2d layers in a model. This can help with reducing the seam where the left and right sides of the image connect.\n\n### Apply Circular Padding VAE\n\nThis node allows you to apply circular padding to the x-axis of all the Conv2d layers in a VAE. This can help with reducing the seam where the left and right sides of the image connect.\n\n### Equirectangular to Face (E2Face)\n\nThis node allows you to get a single face from an equirectangular image.\n\n### Face to Equirectangular (Face2E)\n\nThis node allows you to create an equirectangular image from a single face.\n\n### Create Pole Mask\n\nThis node allows you to create a circle shaped mask in the center of a face tensor if set the 'face' mode. If set to equirectangular mode, It creates a circle shaped center mask in the Up face and the Down face, and then builds those faces into an equirectangular output. Optional feathering can be be applies at the boundaries between the hard mask and the background.\n\n### Create Seam Mask\n\nThis node allows you to create a vertical mask in the center of an equirectangular image that extends from top to bottom, and has a user specified width. When combined with the 'Roll Image Axes' node and 'roll_x_by_50_percent' set to True, you can move the seam/border of your equirectangular image to the center. Then you can use the mask to perform inpainting and masked compositing to erase any visible boundaries. Optional feathering can be be applies at the boundaries between the hard mask and the background.\n\n### Panorama Viewer\n\nFor viewing 360 images inside ComfyUI, see the [github.com/ProGamerGov/ComfyUI_preview360panorama](https://github.com/ProGamerGov/ComfyUI_preview360panorama) custom node.\n\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n\n## 🔬 Citation\n\nIf you use this library in your research or project, please refer to the included [CITATION.cff](CITATION.cff) file or cite it as follows:\n\n### BibTeX\n```bibtex\n@software{Egan_ComfyUI_pytorch360convert_2025,\n  author = {Egan, Ben},\n  license = {MIT},\n  month = jan,\n  title = {{ComfyUI\\_pytorch360convert}},\n  url = {https://github.com/ProGamerGov/ComfyUI_pytorch360convert},\n  year = {2025}\n}\n```\n\n### APA Style\n```\nEgan, B. (2025). ComfyUI_pytorch360convert [Computer software]. https://github.com/ProGamerGov/ComfyUI_pytorch360convert\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FProGamerGov%2FComfyUI_pytorch360convert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FProGamerGov%2FComfyUI_pytorch360convert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FProGamerGov%2FComfyUI_pytorch360convert/lists"}