Guide
Troubleshooting
Quick checks when hotkeys, capture, or delivery do not behave — light FAQ for self-serve recovery.
Hotkeys do nothing
- Confirm the binding in Settings and that another app has not stolen the shortcut.
- On Linux, try a common X11/Xorg session if Wayland global shortcuts are limited for your desktop (see the session tip in Built for Linux).
- Restart Aspera after remapping; re-test with stealth off first so you can confirm UI feedback.
Capture is blank or incomplete
- Grant screen capture / screen recording permission when the OS prompts.
- Select a tighter region around the code or question text.
- Check that the target window is not hardware-protected or DRM-blocked by the OS.
No AI response
- Verify your API key for Gemini, ChatGPT, or Claude and provider quota.
- Confirm network access from the machine; model calls use your provider accounts.
- Try a simple chat prompt to isolate capture vs model connectivity.
Email or Telegram not arriving
- Re-check delivery settings and test with stealth off during setup.
- Spam folder for email; correct bot/chat linkage for Telegram.
- Confirm analysis completed successfully before blaming the delivery channel.
Stealth or share still shows something unexpected
- Enable stealth before sharing; avoid opening Settings during the share.
- Prefer sharing a single window over the entire desktop when the platform allows it.
- Rely on off-device answers so results never need the shared display.
Still stuck?
Email the founder from the site footer contact — questions get real replies. For product context first, re-read How Aspera works and Getting Started.