App Installation & Setup Issues

B. App Launch Failure & File Path

• Action (Mac Users): Ensure the app file was moved from the 'Downloads' folder to the main 'Applications' folder before launching.

C. System Permissions Check (The Non-Admin Gate)

• Action: If the app launches but voice commands fail, try the System Permissions Check outlined in 🎙️ Merlyn Doesn't Hear Me (Voice Commands).

• Antivirus Blocking: Temporarily disable local antivirus. If this works, contact your IT Admin to whitelist the Merlyn app.

D. Display & Browser Configuration Issues

1. Overlay on Wrong Screen: Open the overlay, click the Account icon (👤), and select "Change Main Screen" to manually select the desired display.

2. Merlyn Opens Wrong Browser: Ensure Google Chrome is set as your default system browser.

E. Installation Failure & Fallback Order (Admin Escalation)

If the standard install fails, follow this order:

1. Standard Installer (Try again)

2. MSIX Installer

3. Microsoft Store

4. ZIP Installation (Last Resort): ⚠️ Warning: This method will not automatically update.

F. Final Escalation: Clean Reinstall

• If all installation methods fail, contact your IT Admin to perform a clean reinstallation. Direct them to the How do I manually update my Merlyn desktop app? article.

🛑 Still Stuck? Contact Merlyn Support

• Email log files and confirmation of steps completed to:
  mattwoodward@merlyn.org