FFmpeg not found
FFmpeg is the video-processing tool the app uses to render MP4s. It is downloaded automatically on first launch and stored in the app’s data directory — it does not need to be installed separately.
Symptom
You see one of these messages:
- “FFmpeg not found”
- “Cannot start render — FFmpeg missing”
- “ffprobe is not available”
Likely causes
| Cause | What happened |
|---|---|
| First-launch download interrupted | The app was closed or lost connectivity before the download completed. |
| Disk full | The app-data directory ran out of space during the download. |
| Permission error | The app couldn’t write to its data directory (rare, usually on Windows with strict folder permissions). |
Fix: relaunch the app
In most cases, simply quit and reopen the app. The setup screen will appear again and resume the download from where it stopped. The app retries automatically if the connection drops — just leave it running until the progress bar completes.
If relaunching doesn’t help
Check available disk space. The rendering engine and AI model together need roughly 2–3 GB free. Free up space and relaunch.
Check folder permissions (Windows). Make sure your user account has write access to %APPDATA%\ai-music-video-generator (or wherever Windows reports the app data directory). If that folder is read-only, the download can’t save.
macOS data directory: ~/Library/Application Support/ai-music-video-generator
If the problem persists after relaunching with enough disk space and correct permissions, contact support.