◎ Radiance v2.3.3 — Professional VFX & HDR Suite for ComfyUI

Radiance is a professional, VFX-grade 32-bit float color science suite for ComfyUI. Built for film colorists and VFX artists who require absolute precision in their AI-assisted workflows.

Installation · Getting Started · Node Reference · Quick Start · Viewer Shortcuts · Documentation · Support

</div>

◎ What's New - v2.3.3

[!IMPORTANT] Native 32-Bit Scene-Linear Engine
Unlike standard ComfyUI nodes that clamp to 8-bit, Radiance preserves full IEEE 754 floating-point precision across the entire chain. Zero banding. Zero data loss.

Smart Overwrite Protection — Radiance Write and EXR Save now feature automated index detection to prevent accidental file destruction.
Universal Digital Cinema I/O — Consolidated Video, Image Sequence, and Single Image handling into a high-performance unified pipeline.
Robust Pipeline Validation — Enhanced null-safety and input checking for high-load production environments.
Terminal HUD & Live REPL — Nuke-style Python interaction directly inside the viewer for real-time data inspection.
Interactive Mask Editor — Non-destructive brush masking in ◎ Radiance Load Image.
◎ Radiance Grade Match — Shot-to-shot color statistics transfer using CIE L*a*b* mean/std math.

<a name="getting-started"></a>◎ Getting Started

Radiance Workspace

The Radiance Workspace node is the command center for your production. It handles project paths, versioning, and state management, ensuring that all 32-bit data is tracked correctly across your workflow.

Add the Workspace Node: Right-click > Radiance > Project > Radiance Workspace.
Set your Project Path: Point it to your production directory.
Connect to Viewer: Link the workspace output to the Radiance Viewer to enable live telemetry and Python REPL.

<a name="node-reference"></a>◎ Node Reference (79 Professional Nodes)

The suite is organized into 11 specialized production zones to mirror industry-standard VFX software topology.

<details> <summary>◎ Project, Metadata & DNA (8 Nodes)</summary>

</details> <details> <summary>◎ Production I/O & Loaders (10 Nodes)</summary>

</details> <details> <summary>◎ HDR Imaging & Color Science (23 Nodes)</summary>

</details> <details> <summary>◎ VFX Grading & Analysis (15 Nodes)</summary>

</details> <details> <summary>◎ AI Vision & Temporal (15 Nodes)</summary>

</details>

<a name="quick-start"></a>◎ Quick Start Workflows

Basic Radiance Workflow

<a name="installation"></a>◎ Installation

Option 1: ComfyUI Manager

Open ComfyUI Manager
Search for Radiance
Click Install

Option 2: Manual (Git)

cd ComfyUI/custom_nodes
git clone https://github.com/fxtdstudios/radiance.git
cd radiance
pip install -r requirements_windows.txt  # Or linux/mac_silicon

[!TIP] Linux/macOS Users: Ensure you have libopenexr-dev installed via your package manager before running the requirements install.

<a name="viewer-shortcuts"></a>◎ Professional Keyboard Shortcuts

Radiance Pro Viewer
Radiance Shortcuts

Radiance is designed for a keyboard-driven VFX workflow. Use these shortcuts to monitor, grade, and navigate your shots with industry-standard precision.

◎ Navigation & Playback

| Key | Action | | :--- | :--- | | Space | Toggle Playback | | ← / → | Previous / Next Frame | | F | Fit to View | | 1 | 1:1 Pixel Zoom | | Shift + Drag | Pan Image | | Esc | Exit Fullscreen / Close Panels |

◎ Channel Monitoring

| Key | Action | | :--- | :--- | | C | RGB (Color) View | | R | Red Channel | | G | Green Channel | | B | Blue Channel | | L | Luma Channel | | Shift + A | Alpha Channel |

◎ Analysis & Scopes

| Key | Action | | :--- | :--- | | W | Toggle Waveform (HDR-Aware) | | M | Toggle Waveform Parade Mode | | V | Toggle Vectorscope (w/ Skin Tone Line) | | S | Cycle Safe Area Overlays | | Shift + G | Cycle Grid Modes | | A | Cycle A|B Compare Modes |

◎ Community & Support

Radiance is backed by a professional team of VFX Technical Directors. Engage with us through our official channels:

◎ Official Discord Server

Production Workflows: Access exclusive .rad templates and cinema-grade JSON presets.
Direct Engineer Support: Real-time troubleshooting and feature requests.
Showcase: share your work and get feedback from industry veterans.
Beta Access: Test experimental HDR and temporal nodes before public release.

Join the FXTD Studios Discord

◎ Technical Resources

Documentation: radiance.fxtd.org
Issue Tracker: GitHub Issues
Official Site: fxtd.org

◎ License & Credits

License: GPL-3.0
Authors: Created by the FXTD Studios team.
Technology: Built on OpenColorIO v2.2, OpenEXR, and Colour-Science.
Special Thanks: The ComfyUI community for pushing the boundaries of AI generation.

◎ References

Reinhard, E., Ashikhmin, M., Gooch, B., Shirley, P. Color Transfer between Images. IEEE CGA, 2001.
Hable, J. Filmic Tonemapping Operators. GDC 2010.
Hill, S. HDR Color in Call of Duty. SIGGRAPH 2014.
Academy of Motion Picture Arts and Sciences. ACES 2.0 Reference Rendering Transform. 2024.
Sobotka, T. AgX: A Minimal Color Transform. Blender Institute, 2023.
Magnor, M. et al. Digital Video Processing for Engineers. Morgan & Claypool, 2012.
OpenColorIO Contributors. OpenColorIO v2 Architecture. ASWF, 2023.
Colour-Science for Python. https://www.colour-science.org/. 2024.
Narkowicz, K. ACES Filmic Tone Mapping Curve. Blog, 2016.
ITU-R BT.1203. Subjective Picture Quality Assessment for Digital Cable Television Systems. ITU, 1994.

↑ Back to top

Radiance

Install / Use

README