DOCSTroubleshooting
When it breaks.
Common issues we've seen, with the fix that usually works. If none of these help, ping us on Discord.
App won't sign in
- Check that your subscription is active in /app on the website
- Sign out fully (File → Sign out) and sign in again
- If using OAuth, try email/password as a fallback
- If still stuck, regenerate your password via /reset
AI not speaking
- Check the credit balance in the top bar — if it shows 0, top up or wait for the next cycle
- If BYOK, verify your provider key is still valid in Settings → Providers
- Check audio output device in Settings → Audio
- Try the Test button in the character preview
Lip sync looks off
- Make sure Live Link is connected (Window → Live Link in Unreal)
- Re-bind the MetaHuman face to the Live Link source
- Reduce video output frame rate in OBS if your machine is struggling
OBS doesn't trigger scene switches
- Verify OBS WebSocket is enabled (Tools → WebSocket Server Settings)
- Reconnect from GRIMASA's Integrations panel
- Check that scene names in your event triggers match exactly (case-sensitive)
Auto-update fails
- Check your firewall — let GRIMASA through
- Manually download the latest installer from /download
- Run the installer; it preserves your settings and characters
Still stuck? Open Discord and post in #troubleshooting with your OS version and a copy of the latest log file from the in-app Diagnostics → Open log folder.