Extensions/ComfyUI-ACES-IO
ComfyUI Extension

ComfyUI-ACES-IO

Professional OpenColorIO / ACES color-management nodes for ComfyUI. Mirrors Nuke's OCIO node set with ACES 2.0, 1.3, and 1.2 support, EXR sequence loading, animated…

By BISAM20·Created 5 months ago·Updated 5 months ago· 8
BISAM20/ComfyUI-ACES-IO
Nodes13
On cloudLocal install
CategoryACES IO/Transform, ACES IO/Config
Stars8
Updated5 months ago

Nodes (13)

ACES IO — ColorSpace (OCIOColorSpace)
ACES IO/Transform
ACES IO — Config Loader
ACES IO/Config
ACES IO — Display Transform (OCIODisplay)
ACES IO/Transform
ACES IO — EXR Loader
ACES IO/EXR
ACES IO — EXR Saver
ACES IO/EXR
ACES IO — File LUT (OCIOFileTransform)
ACES IO/LUT
ACES IO — Config Info
ACES IO/Utility
ACES IO — Log Convert (OCIOLogConvert)
ACES IO/Transform
ACES IO — Look Transform (OCIOLookTransform)
ACES IO/Transform
ACES IO — Video Loader (MOV/ProRes)
ACES IO/EXR
ACES IO — Preview
ACES IO
ACES IO — Video Saver
ACES IO/EXR
ACES IO — Viewer (Nuke Viewer)
ACES IO/Viewer
Readme

ComfyUI-ACES-IO

Professional OpenColorIO / ACES color-management nodes for ComfyUI, mirroring Nuke's OCIO node set. Supports ACES 2.0, ACES 1.3, and ACES 1.2 — with Nuke-style colorspace pickers, EXR sequence read/write, animated preview, ProRes MOV export, and video output.

What's New in v1.3

  • OCIODisplay node — bake a Display View Transform into image data with a one-click Invert toggle (display → scene-linear roundtrip)
  • EXR Loader color transforms — optional ocio_config input + colorspace / output_transform convert on load, mirroring Nuke's Read node
  • EXR Saver color transforms — optional ocio_config input + input_transform / colorspace convert before write, mirroring Nuke's Write node
  • ProRes MOV export — Video Saver now supports ProRes 422, 422 HQ, 4444, and 4444 XQ via PyAV (10-bit; alpha preserved for 4444)
  • ACES 1.2 always in dropdown — no longer requires a pre-existing download; auto-fetches the config (~130 MB) on first use

Features

  • Full OCIO pipeline — every node mirrors its Nuke counterpart
  • ACES 2.0 & 1.3 built-in — no download needed (bundled with PyOpenColorIO 2.3+)
  • ACES 1.2 support — always in the preset dropdown; auto-downloads on first use
  • Nuke-style colorspace picker — tabbed family browser with live search (ACES / Display / Input/ARRI / Input/Sony / Utility …)
  • EXR Loader (Nuke Read node) — auto-detects full sequences from any single frame; supports render.0001.exr, render_0001.exr, ####, %04d; all / range / single frame modes; error / black / hold missing-frame policy; optional color transform on load
  • EXR Saver (Nuke Write node) — full 16f / 32f EXR with ZIP, PIZ, DWAA and all standard codecs; optional color transform before write
  • Animated preview — sequence loads play back as animated WebP directly in the node
  • Video Loader — loads .mov, .mp4, .mxf and other formats; full ProRes support via PyAV
  • Video Saver — export IMAGE batches to MP4 (H.264), MOV ProRes (422 / 422 HQ / 4444 / 4444 XQ), Animated WebP, or Animated GIF
  • Cache bypass — every node re-executes on each queue run so colorspace changes always take effect

Nodes

| Node | Nuke equivalent | Category | |------|----------------|----------| | ACES IO — Config Loader | Project Settings → OCIO | ACES IO/Config | | ACES IO — ColorSpace | OCIOColorSpace | ACES IO/Transform | | ACES IO — Display Transform | OCIODisplay | ACES IO/Transform | | ACES IO — Viewer | Nuke Viewer (LegacyViewingPipeline) | ACES IO/Viewer | | ACES IO — Look Transform | OCIOLookTransform | ACES IO/Transform | | ACES IO — File LUT | OCIOFileTransform | ACES IO/LUT | | ACES IO — Log Convert | OCIOLogConvert | ACES IO/Transform | | ACES IO — Config Info | — (utility) | ACES IO/Utility | | ACES IO — EXR Loader | Read node | ACES IO/EXR | | ACES IO — EXR Saver | Write node | ACES IO/EXR | | ACES IO — Video Loader | — (MOV/ProRes/MP4 input) | ACES IO/EXR | | ACES IO — Video Saver | — (MP4 / ProRes / WebP / GIF export) | ACES IO/EXR | | ACES IO — Preview | PreviewImage | ACES IO |

Installation

Via ComfyUI Manager (recommended)

  1. Open ComfyUI Manager → Install Custom Nodes
  2. Search for ComfyUI-ACES-IO
  3. Click Install and restart ComfyUI

Manual

cd ComfyUI/custom_nodes
git clone https://github.com/BISAM20/ComfyUI-ACES-IO
cd ComfyUI-ACES-IO
pip install -r requirements.txt

Then restart ComfyUI.

Dependencies

| Package | Purpose | |---------|---------| | PyOpenColorIO >= 2.3.0 | Core OCIO processing + built-in ACES configs | | numpy | Image array operations | | Pillow | Preview thumbnails, animated WebP / GIF export | | opencv-python | MP4 video export + EXR fallback if OpenEXR is unavailable | | OpenEXR (optional) | Full EXR read/write with all compression codecs | | av (PyAV) (optional) | Video input (MOV/MP4/MXF) + ProRes MOV export |

PyOpenColorIO, numpy, Pillow, and opencv-python install automatically via pip install -r requirements.txt. For full EXR compression support and ProRes export:

pip install openexr av

Quick Start

Basic ACES workflow

Load Image  →  Config Loader  →  ColorSpace (sRGB → ACEScg)
                                       ↓
                               [your nodes]
                                       ↓
                               Viewer (ACEScg → sRGB Display)  →  Preview

EXR sequence workflow

EXR Loader  →  ColorSpace (scene-linear → ACEScg)  →  Viewer  →  Video Saver

The EXR Loader outputs a [B, H, W, C] float32 batch tensor — one item per frame. Set frame_mode = all to load everything on disk automatically (no manual range needed).

Colorspace picker

Every colorspace, display, and view input has a Browse button that opens a Nuke-style dialog:

  • Top tabs — family groups (ACES, Display, Input, Utility, All)
  • Sub-tabs — camera manufacturers (ARRI, Sony, RED, Canon …)
  • Live search — type anywhere to filter across all colorspaces

Display Transform Node (OCIODisplay)

ACES IO — Display Transform bakes a Display View Transform into the image data — unlike the Viewer node which is for preview only.

| Input | Description | |---|---| | input_colorspace | Source colorspace (e.g. ACEScg) | | display | Target display device (e.g. sRGB - Display) | | view | View transform (e.g. ACES 2.0 - SDR 100 nits (Rec.709)) | | invert | Reverses the transform — display-referred → input colorspace (scene-linear roundtrip) |

The invert toggle maps directly to Nuke's OCIODisplay invert knob, running the full display pipeline in reverse via TRANSFORM_DIR_INVERSE.

EXR Loader — Color Transforms

Connect an ocio_config to apply a color transform on load:

| Input | Description | |---|---| | colorspace | Color space the EXR file is stored as (file/camera space) | | output_transform | Color space to deliver downstream (working/pipe space) |

When ocio_config is disconnected both fields are ignored and pixels pass through unchanged — mirrors Nuke's Read node behaviour.

EXR Saver — Color Transforms

Connect an ocio_config to apply a color transform before writing:

| Input | Description | |---|---| | input_transform | Color space of the incoming image (working/pipe space) | | colorspace | Color space to store in the EXR file |

When ocio_config is disconnected both fields are ignored — mirrors Nuke's Write node behaviour.

EXR Loader — Frame Modes

| frame_mode | Behaviour | |---|---| | all (default) | Auto-detects every frame on disk from any single file or pattern | | range | Loads first_frame … last_frame inclusive | | single | Loads exactly the frame number specified by first_frame |

Supported naming conventions

| Pattern | Example | |---|---| | Dot-separated | render.0001.exr | | Underscore-separated | render_0001.exr | | Hyphen-separated | render-0001.exr | | Frame-only | 0001.exr | | With version token | shot_v01_beauty_0042.exr → uses 0042 as frame | | Nuke hash | render.####.exr | | Printf | render.%04d.exr |

Missing frames policy

| Option | Behaviour | |---|---| | error (default) | Raises an exception — matches Nuke default | | black | Substitutes a black frame | | hold | Repeats the last successfully loaded frame |

Video Saver

Export any IMAGE batch to a video file directly from your graph:

| Format | Notes | |---|---| | MP4 (H.264) | Standard video via OpenCV — plays in any media player | | MOV ProRes 422 | Apple ProRes 422 — 10-bit YUV 4:2:2 via PyAV | | MOV ProRes 422 HQ | Apple ProRes 422 HQ — higher bitrate 10-bit via PyAV | | MOV ProRes 4444 | Apple ProRes 4444 — 10-bit 4:4:4, alpha channel preserved via PyAV | | MOV ProRes 4444 XQ | Apple ProRes 4444 XQ — highest quality + alpha via PyAV | | Animated WebP | High-quality, plays in browsers and most modern viewers | | Animated GIF | Universal compatibility; 256-colour limit |

The node passes the IMAGE tensor through unchanged so it can sit anywhere in a graph without interrupting the flow.

Supported ACES Configs

| Preset | OCIO version | Notes | |--------|-------------|-------| | ACES 2.0 CG | 2.5 | Recommended for CG work | | ACES 2.0 Studio | 2.5 | Recommended for live-action / studio | | ACES 1.3 CG | 2.1 / 2.3 / 2.4 | Legacy, three OCIO versions | | ACES 1.3 Studio | 2.1 / 2.3 / 2.4 | Legacy, three OCIO versions | | ACES 1.2 | v1 (colour-science) | Auto-downloads on first use (~130 MB) | | Custom path | any | Point to your own .ocio / .ocioz file |

ACES 1.2 config can also be downloaded manually from colour-science/OpenColorIO-Configs.

License

MIT — see LICENSE

The ACES configs bundled within PyOpenColorIO are released under the Academy Software Foundation (ASWF) open-source license. The ACES 1.2 config is released by colour-science under the BSD license.