Support

Troubleshooting

Fixes for the setup and runtime issues creators and developers hit most often, straight from the app's own diagnostics and source code.

The desktop app talks to a local Python server at 127.0.0.1:8000. If it hasn't finished starting yet, wait a few seconds and retry. To start it manually for debugging, run "cd application/backend && python app.py" (or "npm run backend" from application/) and confirm GET http://127.0.0.1:8000/health returns { "status": "ok" }.

Still stuck?

Run the built-in diagnostics or open an issue on GitHub.

Open a GitHub Issue

Run the Built-in Diagnostics

With the backend running, open http://127.0.0.1:8000/api/whisper-test in your browser. It checks your Python version, GPU/CUDA availability, FFmpeg install, and runs a live transcription test, reporting exactly what's misconfigured.

Troubleshooting

The app says it can't connect to the backend, or captions never generate

Python setup fails with "ModuleNotFoundError" (whisper, torch, fastapi, etc.)

Rendering fails, or subtitles won't burn into the video

The first transcription hangs or fails to download the AI model

Transcription is slow, or I'm not sure if it's using my GPU

Port 8000 is already in use

"Python was not found" on first launch (Windows)

macOS says Python isn't found even though it's installed

The Linux build fails with missing libraries

Uploading or processing a very large video is slow

Still stuck?

Run the Built-in Diagnostics