Yuzu is an experimental Nintendo Switch emulator. For more information, please visit our website.
To install the Flatpak version of Yuzu Emulator, please visit https://flathub.org/apps/details/org.yuzu_emu.yuzu.
For issues with basic functionality and usage, please use our Community Forum or join our Discord channel.
If you encounter any crashes or stability issues, please report them in the issues section of this repository.
When reporting, make sure to select the appropriate template and follow the instructions in the template.
Since Yuzu is a complex piece of software, it's very difficult to pinpoint a specific issue. Providing necessary contextual information will help us determine the root cause of the problem you are experiencing.
Usually, yuzu's own log file will reveal the issue. Please see How to obtain the log file for information on how to collect the log file from your system.
Sometimes, yuzu's own log file is insufficient to determine the cause, especially if you are reporting a crash or a freeze. Ideally, we will able to reproduce the issue on our own machines. But there are times when we can't reproduce the crash or freeze on our own machines due to hardware differences. This would require you to provide a debugger trace. Obtaining a debugger trace is a bit complicated, so please bear with us:
flatpak install org.kde.Sdk//5.15-23.08
flatpak install org.yuzu_emu.yuzu.Debug
flatpak-coredumpctl org.yuzu_emu.yuzu -m yuzu --gdb-arguments "--batch -ex 'thread apply all bt'" > /tmp/yuzu-backtrace.log
/tmp/yuzu-backtrace.log
file to your reportflatpak install org.kde.Sdk//5.15-23.08
flatpak install org.yuzu_emu.yuzu.Debug
flatpak run --devel --command=sh org.yuzu_emu.yuzu
gdb /app/bin/yuzu
in the coming up prompt and wait for the (gdb)
prompt to show upEmulation
-> Configure ...
menu: General
on the left-sidebar, then choose Debug
tab on the right panel. And then, select the CPU
tab on the second-level panel, you will see the Toggle CPU optimizations
options. Please uncheck both the Enable Host MMU Emulation (general memory instructions) and Enable Host MMU Emulation (exclusive memory instructions) checkboxes (as those would interfere with the debugger) Debug
tab and check the Enable CPU Debugging
checkbox Confirm
button at the buttom of the dialog.bt
at the (gdb)
promptgdb
asks --Type <RET> for more, q to quit, c to continue without paging--
, type c to show all the output