07 · Troubleshooting
Troubleshooting
Fixes for the most common problems. If yours is not covered, the FAQ and support links are at the bottom of the page.
Common issues
The engine crashed mid-job
The app recovers on its own where it can. For disk-backed Regenerate jobs a banner appears (Recovering Regenerate job after engine crash…) while the engine restarts and the job resumes from its checkpoint. If a job was not resumable it is marked failed; restart the engine from Activity and run it again. Repeated crashes on the same clip usually mean memory pressure; see below.
Engine won't start, or shows 'License Invalid'
The engine validates the license on startup and shuts down if validation fails. Click the license pill for the reason. Fixes, in order: Refresh License from the pill; re-activate from Settings → License Management → Generate License; and if you see a maximum active licenses error, revoke an unused device on your account page and try again.
A job failed immediately
Usually a missing engine: the pipeline needs a model family you have not built, and the submit error names it, for example No Refocus engine is installed. Build one in the Model Library first. Build the engine, or switch the preset to one that matches what you have installed.
Jobs are much slower when the app is visible
Expected on Apple Silicon: the UI and inference share the GPU. Enable Settings → Application → Minimize while upscaling or use the compact-view button in the top bar.
Out-of-memory, or the system slows down on big jobs
Regenerate passes hold significant state per tile, and high-resolution depth generation uses a lot of memory. Close other GPU-heavy apps; prefer Regenerate-Q over Regenerate for long or large clips; keep disk-backed state on; and for depth maps use Preview (fast) or a smaller model size unless you need full resolution.
Model downloads fail or the weight catalog won't load
The Model Library needs your software key to reach the weight catalog. If it reports a catalog error, re-save the key under Settings → License Management, then click the refresh icon on the family page. Interrupted downloads are safe to retry.
Output plays with a watermark
The free tier watermarks output. After you purchase or redeem a code, the app picks up the new license automatically (or via Refresh License) and subsequent jobs render without the watermark.
Preview playback looks wrong in the app
Open Settings → Third Party Libraries → MPV Player and switch the video output to Software (Recommended for macOS). Preview settings never affect the rendered output.
Useful habits
Test on a slice first. Use Edit video on the Enhance Source step to clip a few representative seconds, settle on a preset, then run the full clip.
Judge with Compare. The wipe view against the source shows differences more clearly than watching the output alone.
Fix regions, not whole jobs. When one area needs work, use Refine's Reprocess to mask the problem, fix the patch, and blend it back. See the worked example.
Keep intermediate stages. The _stage1 outputs let you Mix generative detail back toward the cleaner pass later, for example on a face.
Still stuck?