Skip to content
AI Music Video Generator

App won't start

“App is damaged and can’t be opened” (macOS)

This happens because macOS doesn’t recognize the app’s signature.

Fix:

  1. In Finder, right-click AI Music Video Generator.
  2. Choose Open.
  3. Click Open again in the dialog.

You only need to do this the first time.

If that doesn’t work:

Terminal window
xattr -d com.apple.quarantine /Applications/Music\ Video\ Generator.app

“Windows protected your PC” (Windows)

SmartScreen blocks unsigned apps.

Fix:

  1. Click More info.
  2. Click Run anyway.

App opens but shows a blank window

The bundled backend server may have failed to start.

Try:

  1. Quit the app completely.
  2. Restart it.
  3. If still blank, look for server.log in the app data folder (see file locations) for errors.

The app is stuck on the loading screen

On launch, a brief loading screen appears while the rendering engine starts and asset checks run. In most cases it clears in a few seconds.

If the loading screen persists for more than about 15 seconds, it switches to an error state with two buttons:

  • Restart Server — tells the app to restart the rendering engine and starts a fresh 15-second window.
  • View Logs — opens the app’s log folder so you can inspect startup errors (look for server.log; see file locations).

Recommended steps: click Restart Server first. If the loading screen comes back after the restart, click View Logs and check server.log for recent error messages, then open an issue with the relevant lines.

The app monitors the bundled backend with a lightweight heartbeat. If nothing comes back for about 20 seconds, you’ll see a red banner across the top of the window.

The app automatically attempts to restart the backend up to twice per session. If both automatic attempts fail, click Restart in the banner to try again manually, or View Logs to see what happened.

If the banner keeps reappearing, the backend is probably crashing on something specific — View Logs and check server.log for the error, or file an issue.

App crashes on launch

If the app opens and immediately quits:

  1. On macOS, check Console.app for a crash report filed under “AI Music Video Generator.”
  2. On Windows, check Event Viewer → Windows Logs → Application for error entries.
  3. Open an issue and include the crash log.

”Rendering engine still installing” message

On first launch the app downloads ffmpeg and ffprobe in the background — these are the tools that actually encode your videos. You can watch progress in the download bar at the bottom-left of any tab.

  • On a typical cable or broadband connection the download takes about 30 seconds.
  • The Render button and the audio analyze step stay disabled until both binaries are ready.
  • You can open Settings or browse the Library while the download runs; only Create and Queue are gated.

Once the bar disappears and the “Rendering engine still installing” message clears, everything is unlocked automatically. No restart needed.

Rendering engine install failed — click Retry

If the download bar shows an error message instead of a progress bar, the install has failed.

Common causes and fixes:

  • Not enough disk space — ffmpeg and ffprobe together need about 100 MB free. Free up space and click Retry in the download bar; no reinstall required.
  • No internet connection at launch — the app retries automatically once the connection comes back, but if it doesn’t, click Retry to trigger a fresh attempt.
  • Firewall or proxy blocking the download — allow the app to reach r2.ashworthhub.com on port 443 and click Retry.

If Retry does not help after two or three attempts, try reinstalling the app (see below).

”Not enough free space” during install

If the install banner shows a message like “Not enough free space — need 2.2 GB, only 0.5 GB available”, the installer has paused and is polling for free space. Delete files elsewhere on the same drive; the installer will detect the change within a few seconds and resume automatically. No restart needed.

Still can’t get it to start?

Try reinstalling:

  1. Quit the app.
  2. Delete it from Applications (macOS) or uninstall it via Settings → Apps (Windows).
  3. Re-download and install the latest version.

Your videos and settings are preserved — they live in the app data folder, not inside the app itself.