Troubleshooting: Reporting problems

Overview

• Only the latest version of OpenEmu is supported.
• OpenEmu running on non-Apple hardware aka "Hackintosh" is strictly unsupported.
• OpenEmu running on a "patched" macOS version for obsolete Mac hardware is unsupported.
• Usage of experimental and WIP core ports are strictly unsupported and have no ETA.
• Read the User guide first — it may address your question or problem.

Reporting Issues and Required Information

• Search the issues before opening a new one.
• Do not open a duplicate issue if one or similar already exists. You can reply in closed issues, unless locked.
• Do not comment with useless "+1", "👍", "me too", "bump" or "any update?" in issues — only add useful information.
• Do not follow tutorials found on YouTube as they are often wrong.
• Do not post links or refer to copyright infringing ROM download sites.
• Be as detailed and specific as possible, with exact steps to replicate a problem. Learn more here and here.
• Include Console and crash logs, macOS and OpenEmu version, hardware information, ROM/game filenames, etc.

Common Problems

• If keyboard and/or gamepad are not working, read the guide on input troubleshooting for a solution.
• Closely follow the CD and M3U guide for importing CD-based games — no additional help beyond the guides will be offered.
• NDS games (especially Pokemon) may have unsolvable problems related to AP patches or DeSmuME's JIT dynarec. Alternatively, try standalone DeSmuME that has the JIT dynarec off by default which may improve compatibility.
• Arcade/MAME is unsupported because it is an experimental core port and has inherent usability and maintainability issues. It is recommended to use the official standalone version and to read this helpful MAME ROMs tutorial.
• Cheat code support is not available for all systems, as noted in the cheat codes guide.