GRIMASA
DownloadLog in
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.