One-click neural keying powered by CorridorKey by Niko Pueringer / Corridor Digital
Plugin by Roberto Lopez / StuntWorks
Which version should I download? For a verified, tested build use the latest release tag (currently
v0.7.0). Themainbranch is active development and may include unfinished work.
Real stunt/action greenscreen clips for testing are attached to the v0.7.0 release.
Important: These are intentionally difficult shots — fast action, motion blur, and suboptimal lighting — chosen to stress-test the plugin on worst-case material. Results on well-lit production greenscreen will be significantly cleaner.
| Before | Keyed | Composite |
|---|---|---|
 |
 |
 |
| DaVinci Resolve | Premiere Pro |
|---|---|
 |
 |
Drop green screen footage in your editor. Click one button. Get a clean key.
- AI-powered green/blue screen removal — no manual color picking
- Works inside Resolve, After Effects, and Premiere Pro
- SAM2 Garbage Matte — click points on the live preview to draw a precision foreground boundary; the AI mask is applied to the render so background garbage never bleeds through
- Live preview viewer — see your key in a floating window, drag sliders to update in real time
- Batch process entire clips or frame ranges
- Adjustable despill, edge refinement, and despeckle
- Output saves to your project folder automatically
| Requirement | Details |
|---|---|
| CorridorKey Engine | Install from GitHub with Python venv |
| GPU | NVIDIA with CUDA, 8GB+ VRAM recommended |
| Editor | Resolve Studio 18+, After Effects 2020+, or Premiere Pro 2020+ |
git clone https://github.com/stuntworks/CorridorKey-StuntWorks.git
cd CorridorKey-StuntWorks
python install.py| Flag | What it does |
|---|---|
--all |
Install to all detected apps |
--resolve |
Resolve only |
--adobe |
AE + Premiere only |
--uninstall |
Remove from all apps |
Set
CORRIDORKEY_ROOTenvironment variable if your CorridorKey install isn't in a sibling directory.
Open: Workspace > Scripts > CorridorKey
- Preferences > System > General > External scripting: Local
- Restart Resolve
| Step | Action |
|---|---|
| 1 | Put green screen footage on Track 1 |
| 2 | Open the CorridorKey panel |
| 3 | Pick screen type, adjust despill and refiner |
| 4 | SHOW PREVIEW — opens a live preview window; drag sliders to update in real time |
| 5 | (Optional) SAM2 Garbage Matte — in the preview window, left-click foreground points (green dots), right-click background points (red dots), then click Apply SAM2. The AI draws a clean boundary. Click Clear to reset. |
| 6 | PROCESS FRAME — keys the current frame using your settings + SAM2 mask if set; places result on Track 2 |
| 7 | PROCESS ALL — keys the entire clip; sequence lands on Track 2 |
Disable source clip checkbox: when checked, Track 1 is hidden after processing so you see the keyed result immediately. Uncheck it if you want to keep the source visible for comparison.
Output saves to a CorridorKey folder next to your project.
Open: Window > Extensions > CorridorKey
| Step | Action |
|---|---|
| 1 | Select the green screen layer in your comp |
| 2 | Pick screen type, adjust despill and refiner |
| 3 | PREVIEW FRAME (LIVE) — opens a floating preview window; drag sliders to update in real time |
| 4 | (Optional) SAM2 Garbage Matte — in the preview window, left-click foreground points, right-click background points, then click Apply SAM2. The AI draws a clean boundary used when you commit. |
| 5 | KEY CURRENT FRAME — keys the frame using your settings + SAM2 mask if set; imports above your layer |
| 6 | PROCESS WORK AREA — key all frames in work area (B/N to set range) |
Output saves to a CorridorKey folder next to your project.
Note: Batch processing runs in one shot — AE will freeze while processing, then come back with all frames ready.
Open: Window > Extensions > CorridorKey
| Step | Action |
|---|---|
| 1 | Put green screen footage on V1 |
| 2 | Move playhead to the frame you want |
| 3 | Pick screen type, adjust despill and refiner |
| 4 | PREVIEW FRAME (LIVE) — opens a floating preview window; drag sliders to update in real time |
| 5 | (Optional) SAM2 Garbage Matte — in the preview window, left-click foreground points, right-click background points, then click Apply SAM2. The AI draws a clean boundary used when you commit. |
| 6 | KEY CURRENT FRAME — keys the frame using your settings + SAM2 mask if set; places on V2 |
| 7 | PROCESS IN/OUT RANGE — set I/O points, batch key all frames |
Output saves to a CorridorKey folder next to your project.
| Option | What it does |
|---|---|
| Add keyed clip to timeline | Uncheck for complex timelines — files go to bin only |
| Output Folder | Defaults to project folder. Click Browse to change. |
Note: Keyed files appear in a "CorridorKey" bin in your project panel. You need V1 + V2 tracks for auto-placement.
Editing this plugin? Read these first, in order:
- ALIGNMENT.md — canonical reference for Premiere Pro frame
alignment. Before touching
ppro_getFrameInfo,ppro_importFrame, or any batch frame math, read this. Same alignment was broken and re-fixed four times in three days; the doc exists so it stops happening. Includes a mandatory pre-commit smoke test. - INSTALL.md — full install walkthrough for end users.
Rebuild the engine venv: setup.bat (Windows) or ./setup.sh (macOS / Linux).
If this saves you time, consider buying me a coffee: https://ko-fi.com/stuntworks
CorridorKey AI Engine — Niko Pueringer / Corridor Digital
Plugin — Roberto Lopez / StuntWorks
Free and open source under CC-BY-NC-SA-4.0