Fix errors when starting or installing LTX Desktop
If LTX Desktop fails to open or shows an error during install or launch, the cause usually depends on your operating system. Follow the steps for your platform below.
macOS: "App can't be opened" or security warning
macOS may block LTX Desktop because it was downloaded from the internet rather than the Mac App Store.
- Open System Settings > Privacy & Security.
- Scroll to the Security section.
- Click Open Anyway next to the LTX Desktop message.
- Confirm in the dialog that appears.
If you don't see the option, right-click the app in Finder, select Open, then confirm in the prompt.
macOS: App opens but nothing happens
If the app launches but generation never starts and no error appears, this may be related to a missing ffmpeg dependency. Update to the latest release from the releases page — this was fixed in v1.0.5 for many cases.
Windows: SmartScreen blocks the installer
- Click More info in the SmartScreen dialog.
- Click Run anyway.
This is expected for newly released software that hasn't yet built up enough reputation with Windows Defender.
Windows: App won't start after install
Try running LTX Desktop as administrator:
- Right-click the LTX Desktop shortcut or
.exe. - Select Run as administrator.
App shows no error but immediately closes
Check your logs for a specific error message that didn't surface in the UI:
-
Windows:
%LOCALAPPDATA%\LTXDesktop\logs\session_*.log -
macOS:
~/Library/Application Support/LTXDesktop/logs/session_*.log - In-app: Help > View Logs
If you see a Python backend exited with code 1 error specifically, see Fix "Python backend exited with code 1". For other persistent issues, report them on the GitHub issues page with your logs attached.