-
Notifications
You must be signed in to change notification settings - Fork 15
Troubleshooting: Console and Crash Reports
When something goes wrong, macOS logs are the fastest way to diagnose the problem. Here's how to find and share them.
Console is macOS's built-in log viewer, located at /Applications/Utilities/Console.app.
Easiest way to open it:
- Press ⌘ Space to open Spotlight
- Type
Console - Press Enter
Once Console is open, look in the main log stream for entries containing OpenEmu or OpenEmuHelperApp.
To capture logs as a problem is happening:
- Open Console and note the last line shown.
- Switch to OpenEmu and reproduce the problem.
- Switch back to Console — any new entries are likely relevant.
Select the relevant lines and copy them (⌘A to select all visible, or click + Shift-click to select specific lines).
When OpenEmu or its helper process crashes, macOS generates a crash report. In Console, look in the left sidebar under Crash Reports for files named like:
OpenEmu_2025-03-31-120000_MacBook-Pro.crash
OpenEmuHelperApp_2025-03-31-120000_MacBook-Pro.crash
Click the file, then ⌘A to select all text, and copy it.
Crash reports don't contain sensitive info (passwords, files not related to the crash) — but they may include your computer's hostname and file paths inside your home directory. Review before sharing if you're concerned.
- Short logs (a few lines): Paste directly into the GitHub issue.
- Long logs or crash reports: Paste into GitHub Gist and share the link in your issue.
Always include the log or crash report alongside the other required information described in Troubleshooting: Reporting Problems.