Docs
Cucolori

Troubleshooting

Solutions for common Cucolori issues.

Plugin Not Appearing

DaVinci Resolve

  1. Close Resolve completely
  2. Run the installer again
  3. Open Resolve
  4. Look in Effects Library > OpenFX > EZSCAPE > Cucolori

After Effects

  1. Close After Effects before running the installer
  2. Look in Effect > EZSCAPE > Cucolori
  3. If missing, check that the plugin is in the correct directory:
    • Windows: C:\Program Files\Adobe\Common\Plug-ins\7.0\MediaCore\Cucolori\
    • macOS: /Library/Application Support/Adobe/Common/Plug-ins/7.0/MediaCore/Cucolori/

Final Cut Pro

  1. Close Final Cut Pro before running the installer
  2. Look in Effects browser (Command-5) > Video > EZSCAPE > Cucolori
  3. If missing, check that the plugin is at /Library/Plug-Ins/FxPlug/Cucolori.fxplug

Cucolori runs best on NVIDIA RTX 2060 or newer, AMD equivalent, or Apple Silicon (M1+). It may work on older GPUs with reduced performance.

Performance

Plugin is slow or dropping frames

  • Performance depends on your GPU, resolution, and which layers are enabled.
  • Disable the layer you're not using. Each active layer adds to render time.
  • The gobo layer is more demanding than the frame layer due to the 4K texture sampling.
  • Make sure your GPU drivers are up to date.

Preview looks different from render

  • Some hosts render at reduced resolution during playback. The final render will match what you see at full quality.

Presets

My saved looks disappeared

  • User presets are stored on your machine in a shared folder (%APPDATA%\Ezscape\Cucolori\presets\ on Windows, ~/Library/Application Support/Ezscape/Cucolori/presets/ on macOS). They persist across all projects.
  • If you moved to a new machine or reinstalled your OS, your saved looks won't carry over automatically. Copy the presets folder to transfer them.

Preset looks different than expected

  • Presets set all parameters. If you've modified settings after loading a preset, those changes override it.
  • Use "None" to return to factory defaults before loading a preset.

License Issues

Watermark visible after activation

  1. Click Refresh Status in the License section
  2. Close and reopen the host application
  3. If the issue persists, close the host app and reinstall

"Activation failed" error

  • Verify your email and license key match your purchase confirmation
  • Ensure you have an internet connection
  • Make sure you're using the correct key for your host app (DVR key for Resolve, AE key for After Effects, FCP key for Final Cut Pro)

Still Stuck?