Troubleshooting Common OnDesktopOverlay Issues Quickly

Troubleshooting Common OnDesktopOverlay Issues Quickly

1. Overlay not appearing

• Restart the app: Close OnDesktopOverlay and relaunch.
• Check permissions: Ensure screen overlay, accessibility, and/or display capture permissions are granted in OS settings.
• Graphics driver: Update GPU drivers (NVIDIA/AMD/Intel).
• Conflict: Quit other overlay apps (screen recorders, game overlays, virtual desktops).

2. Overlay flickers or is laggy

• Hardware acceleration: Toggle hardware acceleration in OnDesktopOverlay settings.
• Frame rate: Lower overlay refresh rate or animations.
• Resource usage: Close CPU/GPU-heavy apps; check Task Manager/Activity Monitor.
• Driver update: Update graphics drivers.

3. Clicks pass through the overlay (not receiving input)

• Input mode: Switch between “click-through” and “interactive” modes in settings.
• Window focus: Set overlay to stay on top and accept focus.
• Accessibility/input permissions: Re-grant input/accessibility permissions if required.

4. Overlay appears behind windows or fullscreen apps

• Always-on-top: Enable “always on top” or “overlay level” setting.
• Fullscreen handling: Allow overlay in fullscreen apps or enable exclusive overlay support.
• Multiple monitors: Verify display assignment and position for each monitor.

5. Visual artifacts or incorrect scaling

• DPI scaling: Match app scaling to system DPI or enable “per-monitor DPI aware” option.
• Resolution mismatch: Ensure overlay resolution matches display; restart after resolution changes.
• Theme/skin issues: Revert to default theme to test.

6. Audio or notification issues (if overlay includes controls)

• Audio focus: Ensure overlay is permitted to control audio in system settings.
• Notification access: Grant notification access if required.

7. Extension or plugin problems

• Disable plugins: Turn off third-party plugins/extensions, then re-enable one at a time to find the culprit.
• Compatibility: Check plugin versions for compatibility with current app build.

8. Crashes or failure to load

• Logs: Enable or view logs to identify errors.
• Reinstall: Backup settings, uninstall, reinstall latest version.
• Roll back: If issue started after update, try previous stable version.

9. Licensing or activation errors

• Clock & region: Verify system date/time and region settings.
• License file: Reapply license key or sign in again.
• Network: Check firewall/proxy for blocked activation endpoints.

10. When to contact support

• Collect: app version, OS/build, GPU model, recent changes, and log files.
• Provide these with a clear reproduction step and screenshots/video of the issue.

Quick checklist (try in order): restart app → check permissions → update drivers → disable conflicting apps → review settings → reinstall.