ComfyUI-CorridorKeyWrapper
Custom ComfyUI nodes for CorridorKey, a neural network green screen keyer that solves color unmixing and produces clean alpha channels from footage.
ComfyUI-CorridorKey
Custom ComfyUI nodes for CorridorKey — the neural network green screen keyer by Niko Pueringer and Corridor Crew.
CorridorKey solves the color unmixing problem that traditional keyers struggle with. For every pixel — even highly transparent ones like motion blur or out-of-focus edges — the model predicts the true foreground color and a clean alpha channel, as if the green screen was never there.
Nodes
| Node | Description | |------|-------------| | Load CorridorKey Model | Load the GreenFormer neural network. The model checkpoint (~300MB) is auto-downloaded from HuggingFace on first use. | | CorridorKey Greenscreen | Run inference on green screen footage. Takes an image and a coarse alpha hint, outputs a clean alpha, foreground, RGBA, and composite preview. | | Chroma Key Prepass | Fast chroma key that generates a coarse alpha hint from green/blue screen footage. Designed as input to CorridorKey Greenscreen. | | CorridorKey Composite | Composite a keyed foreground over a background with proper linear-space blending and sRGB output. |
Installation
Via ComfyUI Manager
Search for ComfyUI-CorridorKey in the ComfyUI Manager and install.
Manual
cd ComfyUI/custom_nodes
git clone https://github.com/pixelworldai/ComfyUI-CorridorKey.git
cd ComfyUI-CorridorKey
pip install -r requirements.txt
The CorridorKey model checkpoint is automatically downloaded to ComfyUI/models/corridorkey/ on first use. You can also place a .pth file there manually.
Usage
- Load CorridorKey Model — loads the model onto your GPU
- Chroma Key Prepass — feed in your green screen footage to generate a rough alpha hint (or bring your own from any roto/keying tool)
- CorridorKey Greenscreen — connect the model, your image, and the alpha hint to get a clean key
- CorridorKey Composite (optional) — composite the result over a background
The alpha hint does not need to be precise. CorridorKey was trained on coarse, blurry, eroded masks and excels at filling in fine detail from rough hints.
Credits & Acknowledgements
CorridorKey was created by Niko Pueringer at Corridor Digital. The core model, inference engine, and all neural network architecture are entirely his work. This node pack is a ComfyUI wrapper around the original CorridorKey project.
Join the Corridor Creates Discord to share ideas, results, and contribute to CorridorKey's development.
License
The CorridorKey model and engine are licensed under the Corridor Key Licence (CC BY-NC-SA 4.0 with additional terms). You may use this tool for processing images as part of commercial projects, but you may not repackage and sell the tool itself or offer inference as a paid API service. See the full license for details.