DuckDuckWhale/org.yuzu_emu.yuzu
1
0
Fork 0
mirror of https://github.com/flathub/org.yuzu_emu.yuzu.git synced 2024-12-16 14:37:03 +00:00
Code Issues Packages Projects Releases Wiki Activity
873 Commits 28 Branches 0 Tags 2.3 MiB
Shell 100%
577fa6355c
Go to file
flathubbot 577fa6355c Update 2 modules 
Update 13.1.0.tar.gz to 13.1.1
Update yuzu-mainline.git to mainline-0-1592
2023-10-19 02:19:57 +00:00
.github issue_template: better explanation ... 2022-11-26 18:04:56 -07:00
assets readme: add screenshots to accompany the instructions 2022-07-20 00:11:36 -06:00
shared-modules@096ab6b0be shared-modules: update from upstream 2022-12-28 19:05:42 -07:00
.gitignore CI: log the version bump skip 2022-10-14 23:45:37 -06:00
.gitmodules manifest: add org.yuzu_emu.yuzu 2021-02-28 04:50:22 -07:00
compatibility_list.json manifest: use bundled compatibility list 2022-12-28 18:56:32 -07:00
flathub.json flathub.json: remove architecture restrictions ... 2023-10-08 23:47:42 -06:00
org.yuzu_emu.yuzu.json Update 2 modules 2023-10-19 02:19:57 +00:00
org.yuzu_emu.yuzu.metainfo.xml Update 2 modules 2023-10-19 02:19:57 +00:00
org.yuzu_emu.yuzu.svg icons: pad the svg icon to be a square 2022-07-04 22:07:31 -06:00
README.md Update sdk version for crash reporting steps 2023-09-08 13:13:19 -04:00
yuzu-launcher.sh launcher: dont force xcb on Wayland 2023-10-08 23:38:01 -06:00

README.md

Flatpak for Yuzu Emulator

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.

Reporting Bugs

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.

Obtaining Necessary Information for Bug Reports

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:

Obtaining a debugger trace after the crash

  1. Install debuggers in Flatpak: flatpak install org.kde.Sdk//5.15-22.08
  2. Install debug information for yuzu: flatpak install org.yuzu_emu.yuzu.Debug
  3. Execute this command in your terminal: flatpak-coredumpctl org.yuzu_emu.yuzu -m yuzu --gdb-arguments "--batch -ex 'thread apply all bt'" > /tmp/yuzu-backtrace.log
  4. Please attach the file /tmp/yuzu-backtrace.log file to your report

Obtaining a debugger trace as the crash happens

  1. Install debuggers in Flatpak: flatpak install org.kde.Sdk//5.15-22.08
  2. Install debug information for yuzu: flatpak install org.yuzu_emu.yuzu.Debug
  3. Execute this command in your terminal: flatpak run --devel --command=sh org.yuzu_emu.yuzu
  4. Type gdb /app/bin/yuzu in the coming up prompt and wait for the (gdb) prompt to show up
  5. Type r and hit Enter to launch yuzu under the debugger
  6. Before loading your game:
    • Go to Emulation -> Configure ... menu: yuzu settings 0
    • Choose 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) yuzu settings 1
    • Then go to the Debug tab and check the Enable CPU Debugging checkbox yuzu settings 2 and click the Confirm button at the buttom of the dialog.
  7. Load the game that caused the crash and repeat the steps you think that may have crashed or freezed yuzu
  8. When the crash or freeze happens, switch back to the terminal and type bt at the (gdb) prompt
  9. If gdb asks --Type <RET> for more, q to quit, c to continue without paging--, type c to show all the output
  10. Copy and paste all the output to a new text file, and attach this file to your report
  11. Type q to kill both the debugger and crashed yuzu
  12. (Optional) You might want to undo step (6) to avoid performance penalty after this process