{"id":46305067,"url":"https://github.com/SamSeenX/ComfyUI_SSStereoscope","last_synced_at":"2026-03-18T07:00:43.103Z","repository":{"id":246706138,"uuid":"821914284","full_name":"SamSeenX/ComfyUI_SSStereoscope","owner":"SamSeenX","description":"Side by Side Stereoscope node for ComfyUI by SamSeen","archived":false,"fork":false,"pushed_at":"2026-03-02T09:52:02.000Z","size":345,"stargazers_count":47,"open_issues_count":1,"forks_count":15,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-03T09:26:28.267Z","etag":null,"topics":["3d","comfyui-custom-node","comfyui-workflow","sbs","stereo-vision","stereoscopic-3d"],"latest_commit_sha":null,"homepage":"https://sbs.samseen.dev/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SamSeenX.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.buymeacoffee.com/samseen"]}},"created_at":"2024-06-29T20:00:54.000Z","updated_at":"2026-03-02T09:52:06.000Z","dependencies_parsed_at":"2024-07-09T01:20:39.515Z","dependency_job_id":"d0acd698-2215-4226-b7db-234d0173a076","html_url":"https://github.com/SamSeenX/ComfyUI_SSStereoscope","commit_stats":null,"previous_names":["mrsamseen/comfyui_ssstereoscope","samseenx/comfyui_ssstereoscope"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/SamSeenX/ComfyUI_SSStereoscope","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamSeenX%2FComfyUI_SSStereoscope","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamSeenX%2FComfyUI_SSStereoscope/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamSeenX%2FComfyUI_SSStereoscope/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamSeenX%2FComfyUI_SSStereoscope/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SamSeenX","download_url":"https://codeload.github.com/SamSeenX/ComfyUI_SSStereoscope/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamSeenX%2FComfyUI_SSStereoscope/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30654901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-18T02:48:56.676Z","status":"ssl_error","status_checked_at":"2026-03-18T02:48:55.747Z","response_time":104,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["3d","comfyui-custom-node","comfyui-workflow","sbs","stereo-vision","stereoscopic-3d"],"created_at":"2026-03-04T12:00:38.869Z","updated_at":"2026-03-18T07:00:43.095Z","avatar_url":"https://github.com/SamSeenX.png","language":"Python","funding_links":["https://www.buymeacoffee.com/samseen","https://buymeacoffee.com/samseen"],"categories":["Workflows pushed in 7 days"],"sub_categories":[],"readme":"# ComfyUI SS Stereoscope\n\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/Platform-ComfyUI-blue.svg)]()\n\n\u003e Transform any 2D image into immersive stereoscopic 3D content in ComfyUI.\n\nThe SideBySide Stereoscope Node is a cutting-edge 2D-to-3D conversion tool designed for ComfyUI. Powered by Depth-Anything (V2 \u0026 V3), it automatically creates high-quality depth maps and generates side-by-side (SBS) 3D images and videos perfect for VR headsets and 3D displays.\n\n## ✨ Features\n\n- 🧠 **AI-Powered Depth** - Uses Depth-Anything (V2 \u0026 V3) for automatic, high-quality depth estimation.\n- 👓 **Stereoscopic Modes** - Supports Parallel and Cross-eyed viewing techniques.\n- 🎥 **Video Support** - Full workflow for converting videos to 3D (upload, process, combine).\n- 🎛️ **Fine Control** - Adjust depth scale, blur radius, and depth inversion.\n- ⚡ **Integrated Workflow** - No external tools needed; handles everything within ComfyUI.\n- 🚀 **Performance Mode** - Optional \"HighSodium Optimization\" for up to 4x faster processing.\n\n## 📸 Demo\n\n![Workflow Example](https://github.com/SamSeenX/ComfyUI_SSStereoscope/assets/8541558/6b972838-07ca-4e64-a3a4-32277ddcf4c7)\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- ComfyUI installed\n- Python \u003e= 3.8\n- **FFmpeg** (Recommended for video support)\n  - The node attempts to use your system's FFmpeg first.\n  - If missing, it will fallback to the `imageio-ffmpeg` binary (included in dependencies).\n  - **Windows Users**: For best performance, install FFmpeg manually from [ffmpeg.org](https://ffmpeg.org/download.html) and ensure it is added to your System PATH.\n\n### Installation\n\n1.  Navigate to your custom nodes directory:\n    ```bash\n    cd ComfyUI/custom_nodes\n    ```\n2.  Clone the repository:\n    ```bash\n    git clone https://github.com/SamSeenX/ComfyUI_SSStereoscope.git\n    ```\n3.  Install dependencies:\n    ```bash\n    pip install -r ComfyUI_SSStereoscope/requirements.txt\n    ```\n4.  Restart ComfyUI.\n\n_(Note: The AI model will download automatically on first use.)_\n\n## 📖 Documentation\n\n### Core Nodes\n\n- **👀 SBS V2**: The main node. Input a 2D image, get a 3D SBS image + depth map.\n  - `depth_scale`: Intensity of the 3D effect.\n  - `mode`: Cross-eyed vs Parallel.\n  - `highsodium_optimization`: Enable vectorized algorithm for faster processing (may produce slightly different results).\n- **👀 SBS V2.1 (External Depth)**: _New in v2.1!_ Uses the fast V2 engine (HighSodium) but accepts your custom Depth Maps.\n  - Fixes \"reducing\" artifacts found in the legacy node.\n  - **Resolution-Relative Scaling**: `depth_scale` (0-100) now maps to **0-20% of image width**. This gives you fine-grained control while preventing output-breaking values.\n    - Scale 10 = 2% width separation.\n    - Scale 50 = 10% width separation.\n    - Scale 100 = 20% width separation (Max).\n- **👀 SBS Video Uploader**: Converts input video to image sequence.\n- **👀 SBS Video Combiner**: Merges processed frames back into a video.\n\n### Workflow Example\n\n1.  **Video Input**: Use `SBS Video Uploader` to load a video.\n2.  **Process**: Connect frames to `SBS V2` node.\n3.  **Output**: Connect results to `SBS Video Combiner` to save the 3D video.\n\n## 🏗️ Project Structure\n\n```\nComfyUI_SSStereoscope/\n├── sbs_v2.py            # Main logic\n├── requirements.txt     # Dependencies\n├── video_utils.py       # Video processing helpers\n└── README.md\n```\n\n## 🤝 Contributing\n\nContributions are welcome!\n\n1. Fork the repository\n2. Create your feature branch\n3. Commit your changes\n4. Push to the branch\n5. Open a Pull Request\n\n### Contributors\n\n- [SamSeen](https://github.com/SamSeenX) - Original Author\n- [HighSodium](https://github.com/HighSodium) - Performance optimization ([PR #16](https://github.com/SamSeenX/ComfyUI_SSStereoscope/pull/16))\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## ☕ Support\n\nIf you find this project useful, please consider supporting me:\n\n- ⭐ Starring this repository\n- 🐛 Reporting issues\n- ☕ [Buy me a coffee](https://buymeacoffee.com/samseen)\n\n---\n\nCreated with ❤️ by [SamSeen](https://buymeacoffee.com/samseen)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSamSeenX%2FComfyUI_SSStereoscope","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSamSeenX%2FComfyUI_SSStereoscope","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSamSeenX%2FComfyUI_SSStereoscope/lists"}