Skip to guide content

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.