Troubleshoot
Quick checks for “won’t open”. Keys, firmware, and games: see the project wiki.
App will not start (Windows)
- Install the .NET Desktop Runtime named in the error (from Microsoft).
- Allow the app in Windows Security if quarantined.
- SmartScreen: More info → Run anyway (files from the official release page only).
Broke after an update
On Canary or Stable, open an older tag, re-download the same platform asset. Data paths: File → Open Ryujinx Folder when a build runs. Back up first.
Wrong asset
x64 and ARM64 differ. Re-download a matching asset. Install steps.
Graphics / sound / input
In the app, try another graphics API (Vulkan vs OpenGL) and check Options. For full docs: