Back to Knowledge Base

Troubleshooting

Common issues, fixes, and performance tips.

LotusQ isn't typing text into my app

LotusQ uses clipboard paste (Ctrl+V / Cmd+V) to inject text. Check:

  • • Your cursor is in an active text field
  • • The target app allows paste operations
  • • On Linux: ensure xdotool is installed

No beep sound when pressing PTT

Check your audio output settings:

  • • Ensure Beep Volume is above 0 in Settings
  • • On Linux: verify paplay is installed
  • • Check your default audio output device in system settings

Sidecar won't connect (red indicator)

The Python sidecar starts automatically. If it fails to connect:

  • • Restart the app, the sidecar auto-reconnects every 3 seconds
  • • Check if port 3001 is blocked by a firewall
  • • On installed builds: check logs at ~/.config/LotusQ/

Transcription is slow or inaccurate

Try these optimizations:

  • • Switch to the Cloud Engine for fastest results (Pro)
  • • Use a dedicated microphone, built-in laptop mics have more noise
  • • Set only the languages you speak in Settings (fewer languages = faster detection)
  • • For local engine: ensure you have a CUDA-capable GPU

Google Sign-In keeps opening the browser

This is expected. Google OAuth requires a browser for security. After authenticating, the browser redirects tokens back to LotusQ via:

  • • Linux: localhost callback (port 3001)
  • • macOS/Windows: deep link (lotusq://auth/callback)

Dictionary changes aren't syncing

Cloud sync is a Pro feature. If you're on Pro and sync isn't working:

  • • Check your internet connection
  • • Sign out and sign back in to refresh your token
  • • The cloud API URL should be api.lotusq.io

Still stuck? Open the Help menu in the LotusQ app and submit a support ticket.