User troubleshooting
Verification does not unlock
Section titled “Verification does not unlock”- Allow JavaScript and requests to Cloudflare’s Turnstile service.
- Disable an over-aggressive content blocker for the page, then use Retry verification.
- Check the device clock and network. A failed Siteverify service returns a temporary-unavailable message.
- If the widget reports an expired or failed check, complete the reset widget again.
The session expired
Section titled “The session expired”The default API session lasts 12 hours; an operator can configure 60 seconds through 24 hours. The app detects the expiry time and locks the form. Verify again. Switching API instances also clears the current session because sessions belong to one API origin.
A URL is unsupported
Section titled “A URL is unsupported”Use a complete public HTTP(S) post, Reel, Short, track, or playlist URL from the platform matrix. Homepage, profile, login-only, malformed, and unrecognized URLs may be rejected. Short redirect URLs must resolve successfully for their module.
Media is unavailable
Section titled “Media is unavailable”The post may be private, deleted, region-restricted, age-gated, rate-limited, or changed upstream. Try the original URL in a normal browser, retry later, or ask the instance operator to inspect /health and module logs. Cached URLs can also disappear after size-based eviction; process the source URL again to rebuild them.
Audio conversion fails
Section titled “Audio conversion fails”Keep the page open while the ~31 MB FFmpeg engine loads, ensure WebAssembly and workers are allowed, and try a current desktop browser if a memory-limited mobile browser fails. “No audio track” is expected for silent media and automatically returns to Media mode.
A custom instance is rejected
Section titled “A custom instance is rejected”Enter only an origin such as https://api.example.com—no path, query, fragment, or credentials. Production requires HTTPS. The origin must expose /web/identity with a valid, unexpired project-issued certificate whose origin matches exactly, and it must allow that identity response through CORS.