CoCoTools_IO

A set of nodes focused on advanced image I/O operations, particularly for EXR file handling.

Features

• Advanced EXR image input with multilayer support
• EXR layer extraction and manipulation
• High-quality image saving with format-specific options
• Standard image format loading with bit depth awareness

Installation for comfyui portable (tested on 0.3.14)

from the python_embeded/ folder

python.exe -m pip install -r ./ComfyUI/custom_nodes/ComfyUI-CoCoTools/requirements.txt

Manual Installation

1. Clone the repository into your ComfyUI custom_nodes directory
2. Install dependencies
3. Restart ComfyUI

Current Nodes

Image I/O

• Image Loader: Load standard image formats (PNG, JPG, WebP, etc.) with proper bit depth handling
• Load EXR: Comprehensive EXR file loading with support for multiple layers, channels, and cryptomatte data
• Load EXR Layer by Name: Extract specific layers from EXR files (similar to Nuke's Shuffle node)
• Cryptomatte Layer: Specialized handling for cryptomatte layers in EXR files
• Image Saver: Save images in various formats with format-specific options (bit depth, compression, etc.)

Image Processing

• Colorspace Converter: Convert between various colorspaces (sRGB, Linear, ACEScg, etc.)
• Z Normalize: Normalize depth maps and other single-channel data

To-Do

IO

• [x] Implement proper EXR loading
• [ ] Implement EXR sequence loader
• [x] Implement EXR saver using OpenImageIO
• [x] Implement multilayer EXR system (render passes, AOVs, embedded images, etc.)
• [x] Add contextual menus based on selected file type in saver
• [ ] Add support for EXR sequences

Future Enhancements

• [x] Add ACES or OCIO color config profiles
• [ ] Create frequency-based image processing tools
• [ ] Restore additional utility nodes (JSON handling, regex, etc.)

Documentation

• [ ] Add more detailed information on each node
• [ ] Add more example workflows
• [ ] Add visual examples in the readme

Registration

• [x] Submit to ComfyUI Registry

Third-Party Libraries and Licensing

This project uses the following third-party libraries:

• Colour Science for Python: Used for colorspace transformations in the Colorspace Converter node. Licensed under the New BSD License.
• OpenColorIO: Used for color space transformations. Licensed under the BSD 3-Clause License.
• ACES Configuration: The ACES OCIO configuration file is provided by the Academy of Motion Picture Arts and Sciences.

For detailed licensing information, please see the THIRD_PARTY_NOTICES.md file.

This project is licensed under the MIT License. The BSD 3-Clause License used by OpenColorIO and the New BSD License used by colour-science are compatible with the MIT License, allowing us to include and use these components within this MIT-licensed project.