Wiki/wiki-rtd/docs/wiki_configurator/ponzu.md

53 lines
2.2 KiB
Markdown
Raw Normal View History

2024-03-09 18:49:31 +00:00
# Guide: Ponzu (Legacy AppImage Loader)
2024-03-09 17:09:16 +00:00
2024-03-28 14:09:39 +00:00
<img src="../../wiki_images/logos/ponzu-logo.png" width="150">
2024-03-09 17:09:16 +00:00
2024-03-17 06:35:27 +00:00
Ponzu is an temporary as-is function that is searching for user provided Citra and Yuzu AppImages and make them available as emulators inside RetroDECK.
2024-03-09 18:49:31 +00:00
2024-03-09 17:09:16 +00:00
## Where to put the AppImages
2024-03-09 18:49:31 +00:00
2024-03-09 17:09:16 +00:00
Ponzu is looking for the AppImages in the `retrodeck/ponzu/` directory (lowercase).
2024-03-09 18:49:31 +00:00
### Accepted filenames & versions
2024-03-09 17:09:16 +00:00
- Yuzu*.AppImage
- yuzu*.AppImage
- Citra*.AppImage
- citra*.Appimage
2024-03-17 06:35:27 +00:00
Where `*` means that there can be a combination of any character.
2024-03-09 17:09:16 +00:00
## How to:
2024-03-09 18:49:31 +00:00
- Create the `retrodeck/ponzu/` folder
2024-03-28 14:04:45 +00:00
- COPY the AppImages into the folder.
2024-03-09 18:49:31 +00:00
- Open RetroDECK and wait.
2024-03-28 14:04:45 +00:00
- When RetroDECK starts and the ES-DE Frontend is loaded go to `Other Settings` -> `Alternative Emulators` to set the new defaults.
2024-03-09 17:09:16 +00:00
## How to uninstall the emulators
- Open Configurator
- Navigate to RetroDECK Tools
2024-03-09 18:49:31 +00:00
- Run Ponzu - Remove Ponzu
2024-03-17 06:35:27 +00:00
- This removes the Emulators.
2024-03-28 14:05:35 +00:00
Your saves and games will not be deleted, so if you decide to re-install them everything will be as you left, except for the configurations those will be defaulted.
2024-03-17 06:35:27 +00:00
2024-03-28 14:04:45 +00:00
## A Full Reset will remove the Emulators
2024-03-09 18:49:31 +00:00
2024-03-17 06:35:27 +00:00
If you do a Full Reset of RetroDECK you will need to do the Ponzu process again.
2024-03-28 14:04:45 +00:00
## Q: Should this be seen as official support for the removed emulators?
No we provide zero support, the the only official emulators we support for those systems are Ryujinx and Citra-core in RetroArch (as long as it is shipped as part of RetroArch).
Since the first day of our announcement on both Citra's and Yuzu's removal, we made it extremely clear that we will not provide any new: configurations, bug fixes, improvements, or any kind of support at all, for the these removed emulators. There is also a very substantial risk that future updates of RetroDECK will break the current temporary compatibility, this to be seen as a temporary as-is solution.
At the same moment we also updated our social rules to reflect that any type of discussion about these emulators will come with a warning first and then a ban.
The only recommended use case of Ponzu is the intended function as safe way to migrate to Ryujinx or the Citra-core (finish up, save and move).
We urge everyone to stop using these emulators.