Fix Common Issues & Self-Heal
Videx comes with an integrated diagnostic and repair subsystem. Find your issue below or run videx doctor --fix.
🎬 FFmpeg is Missing / Stream Merging Fails
Auto-FixableVidex requires FFmpeg to merge separate 4K video and high-bitrate audio streams into lossless MP4/MKV containers and embed subtitles.
Quick Fix Command:
videx doctor --fix🪟 'videx' Command Is Not Recognized
PATH SetupIf you just installed Videx, close and reopen your terminal to refresh environment variables, or add the install directory to your system PATH.
# Windows PowerShell refresh:
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","User") + ";" + [System.Environment]::GetEnvironmentVariable("Path","Machine")
videx doctor⏱️ HTTP 429 (Too Many Requests / Rate Limited)
Built-In ResiliencyVidex automatically catches HTTP 429 and 503 errors and applies random-jittered exponential backoff. To throttle connection speed manually:
videx <URL> --concurrent-fragments 2 --retry-sleep 5🔌 Companion Offline / Port 8765 Unreachable
Service CheckVidex Companion binds to loopback 127.0.0.1:8765. Start it manually with:
videx app🎓 Udemy Authentication Required
Zero-Cookie ExportFor the Udemy beta, do not export plaintext cookies when browser handoff is available. Open the authorized course in Chrome or Edge and click the Videx Browser Extension icon to perform a one-use local memory handshake.
Still Need Assistance?
Generate a redacted support bundle before opening an issue. The output contains diagnostics and safe recovery commands, never cookies, passwords, source URLs, signed media URLs, or downloaded files.
videx support --json --output videx-support.jsonThe destination folder must already exist. Review the bundle before attaching it.