Install EZ-CorridorKey
EZ-CorridorKey is the free desktop app for CorridorKey, the AI chroma keyer by Corridor Digital. The installer handles the Python runtime, GPU libraries, and models, so you never touch a terminal. It runs on Windows, macOS, and Linux, and keys well on an 8 GB NVIDIA card.
THREE WAYS TO INSTALL
- Desktop installer (easiest)
Download the installer from Gumroad and run it. Windows gets a full installer plus a portable exe. macOS gets a signed, notarized .pkg. It bundles the managed Python runtime, GPU libraries, and AI models, so there is nothing else to set up. Open the app and import a clip. No Git, no command line.
- From source (git clone)
For the newest build, or on Linux, install Git, clone the repository, and run the installer for your platform. The script provisions managed Python, the correct PyTorch backend for your GPU, FFmpeg, and the model checkpoints, then you launch with the start script.
git clone https://github.com/edenaion/EZ-CorridorKey # Windows: double-click 1-install.bat # macOS / Linux: chmod +x 1-install.sh && ./1-install.sh # then launch: 2-start.bat (Windows) ./2-start.sh (macOS, Linux) - Docker (Linux / cloud)
For Linux servers or a remote GPU, run EZ-CorridorKey in Docker with browser-based access over noVNC. The docker/README.md in the GitHub repository has the setup. The installer above is the recommended path on Windows and macOS.
DOWNLOAD SAFELY
Get EZ-CorridorKey only from this site, the GitHub releases page, or Gumroad. Windows builds are code-signed by EZscape Ventures LLC and macOS builds are Apple-notarized, so your system can verify them. Download pages that are not one of these three are unverified and may bundle malware. Report a lookalike in the EZSCAPE Discord.
INSTALL FAQ
How do I run CorridorKey without Python?
EZ-CorridorKey bundles a managed Python runtime, GPU libraries, and the AI models inside its Windows and macOS installers. You download it from Gumroad, run the installer, and open the app. There is no pip, no virtual environment, and no command line. The original CorridorKey command-line script still ships for advanced users who want it.
Does CorridorKey work on 8 GB VRAM?
Yes. EZ-CorridorKey detects your available VRAM and switches to a low-VRAM tiled mode below 12 GB. It keeps VRAM use to around 6 GB, so an 8 GB NVIDIA card handles most clips. Cards with 12 GB or more unlock the faster full-frame mode automatically.
Is there a CorridorKey Mac version?
Yes. EZ-CorridorKey runs on Apple Silicon, M1 and newer, with a built-in MLX engine that is about twice as fast as PyTorch MPS. Download the macOS installer from Gumroad, or build from source on GitHub for the latest release. Alpha generators run slower on Mac, so importing premade mattes is recommended there.
Is EZ-CorridorKey free?
Yes, EZ-CorridorKey is free forever, under the CC BY-NC-SA 4.0 license, the same terms as Corridor Digital's original CorridorKey. There is no account, no subscription, and no telemetry. Your footage stays on your machine. Donations through Gumroad, Patreon, or Ko-fi are optional and fund continued development.
Where do I download EZ-CorridorKey safely?
Only from this site, the GitHub releases page, and Gumroad. Windows installers are code-signed by EZscape Ventures LLC and macOS builds are Apple-notarized, so your system can verify them. Avoid mirror or lookalike download pages, they are unverified and may bundle malware. When unsure, start from ezcorridorkey.com.
How is EZ-CorridorKey different from cloud keyers like blace.ai?
EZ-CorridorKey runs entirely on your own computer, so footage never uploads and there are no per-minute cloud fees. It wraps Corridor Digital's CorridorKey model with four alpha generators and production EXR, ProRes, and VP9 export. Cloud keyers trade privacy and ongoing cost for not needing a local GPU.
Still stuck? The full README on GitHub covers every option, or watch the install walkthrough. Back to the home page.