Docs
Ditheron

Troubleshooting

Solutions for common issues with Ditheron.

Plugin Not Appearing

DaVinci Resolve:

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

After Effects:

  1. Close After Effects completely
  2. Run the installer again
  3. Open After Effects
  4. Look in: Effect > EZSCAPE > Ditheron

Final Cut Pro:

  1. Close Final Cut Pro completely
  2. Run the macOS installer again
  3. Open Final Cut Pro
  4. Look in: Effects browser (Command-5) > Video > EZSCAPE > Ditheron

Always close your host application before running the installer.

Performance Issues

Slow playback:

  • Ditheron runs best on NVIDIA RTX 2060 or newer, AMD equivalent, or Apple Silicon (M1+). May work on older GPUs with reduced performance.
  • If playback is slow, check that your GPU drivers are up to date.
  • Glow adds processing overhead. Disable it while editing, enable for final render.
  • Higher Scale values are actually faster (fewer calculations per pixel).
  • Downscale can improve performance since the dithering operates on a smaller image.

DaVinci Resolve: Use Resolve's Smart Cache (Playback > Render Cache > Smart) to cache Ditheron's output for smooth playback.

After Effects: Pre-render Ditheron layers or use AE's Disk Cache.

Final Cut Pro: Use background render (Preferences > Playback > Background Render) to cache Ditheron output.

Presets Not Saving

  • Make sure you've typed a name in the Preset Name field before clicking Save
  • Preset slots are limited to 300. If all slots are full, delete one to make room.
  • User presets are stored on your machine (%APPDATA%\Ditheron\presets\ on Windows, ~/Library/Application Support/Ditheron/presets/ on macOS). They persist across all projects but don't transfer between machines automatically.

Custom Palette Import Not Working

  • Hex codes should start with # (e.g. #FF0000)
  • Separate multiple colors with commas, spaces, or dashes
  • Coolors.co URLs should be the full URL (e.g. https://coolors.co/264653-2a9d8f-e9c46a)
  • Maximum 5 colors. Extra colors are ignored.

License Issues

See the Activation page for detailed troubleshooting.

Image Looks Wrong After Applying

  • Check the Adjustments section — Brightness, Contrast, or Gamma may have been changed from defaults
  • Check if Invert is enabled
  • Make sure Strength isn't at 0% (which would show the original image)
  • Try resetting to a built-in preset to start from known-good values

Colors Look Different Than Expected

  • Enable Color must be turned on for palette mapping to work
  • Palette Mode must be set to match what you want (Preset vs Custom)
  • Color Depth at high values (16-32) with a limited palette can look washed out — try lower values (2-4) for bolder results
  • Saturation in the Adjustments section affects the input before palette mapping

Still Need Help?