Xargon/Wiki
1
0
Fork 0
mirror of https://github.com/RetroDECK/Wiki.git synced 2025-04-10 19:15:16 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

pon

Browse source
This commit is contained in:
laz 2025-02-20 12:18:45 +01:00
parent 8312a8d20e
commit 43d39b1db3
1 changed files with 26 additions and 22 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
wiki-rtd/docs/wiki_system_guides/ponzu/ponzu-guide.md
View file

@ -1,49 +1,53 @@
# Guide: Ponzu - Legacy AppImage Loader
# Ponzu - AppImage Loader: General Guide
<img src="../../../wiki_images/logos/ponzu-logo.png" width="100">
Ponzu can be used temporarily to search for user-provided Citra and Yuzu AppImages and make them available as emulators inside RetroDECK.
Ponzu is an AppImage Loader that can be used to search for user-provided AppImages and add them to RetroDECK.
**Note:** This will not work in the longterm.
In the future, Ponzu might support other systems not shipped by default in RetroDECK, such as proprietary emulators. We hope to get custom licenses for them so they can be installed via Ponzu as an option if we can't build them via RetroDECK directly (nothing yet).
**Warning: Factory Reset will remove everything Installed by Ponzu**
If you do a Factory Reset of RetroDECK, you will need to repeat the Ponzu process.
## Where to Put the AppImages
Ponzu looks for the AppImages in the `retrodeck/ponzu/` folder (lowercase).
### Accepted Filenames & Versions
## What Components are supported in Ponzu?
- Yuzu*.AppImage
- yuzu*.AppImage
- Citra*.AppImage
- citra*.Appimage
| Component | Supported Files Names |
|----------|-----------------|
| Yuzu `*` | `Yuzu<X>.AppImage`, `yuzu*.AppImage` |
| Citra `*` | `Citra<X>.AppImage`, `citra*.AppImage` |
Where `*` means any combination of characters.
Where `<X>` means any combination of characters.
## How to: Use Ponzu
`*` These are not supported is to be seen as a temporary as-is solution and will stop working in the end, check the statement on this page.
1. Create the retrodeck/ponzu/ folder.
## How to Use Ponzu
1. Create the `retrodeck/ponzu/` folder.
2. Copy the AppImages into the folder (they will be deleted during the process).
3. Open RetroDECK and wait.
4. When RetroDECK starts and the ES-DE Frontend is loaded, go to `Other Settings` -> `Alternative Emulators` to set the new defaults.
5. Check the Archive 📂 section on the wiki for the old guides.
## How to Uninstall the Emulators
4. When RetroDECK starts and the ES-DE Frontend is loaded, go to `ES-DE Configurations` -> `Other Settings` -> `Alternative Emulators` to set the new defaults for the components you have installed.
## How-to: Uninstall Components installed by Ponzu
1. Open Configurator.
2. Navigate to RetroDECK Tools.
3. Run Ponzu - Remove Ponzu.
4. This removes the emulators.
Your saves and games will not be deleted, so if you decide to re-install them, everything will be as you left it, except for the configurations which will be reset to default.
**Warning: A Full Reset will remove the Emulators**
**This will not be deleted:** Userdata under retrodeck/: Saves, ROMs, etc.
If you do a Full Reset of RetroDECK, you will need to repeat the Ponzu process.
## Does RetroDECK officially support Yuzu and Citra?
## Should this be seen as official support for the removed emulators?
No, RetroDECK does not officially support Yuzu and Citra, and we provide zero support for them. The only official emulators we support are the ones we ship.
No, we provide zero support. The only official emulators we support for those systems are the Citra-core in RetroArch (as long as it is shipped as part of RetroArch).
Since the removal of Citra and Yuzu, we have made it clear that there will be no new configurations, bug fixes, improvements, or support for these emulators. Future updates of RetroDECK will break the current temporary compatibility, and this is to be seen as a temporary solution.
Since the announcement of Citra's and Yuzu's removal, we made it clear that we will not provide any new configurations, bug fixes, improvements, or any kind of support for these removed emulators. There is a substantial risk that future updates of RetroDECK will break the current temporary compatibility. This is to be seen as a temporary as-is solution.
We have also updated our social rules to reflect that any discussion about these emulators will result in a warning first and then a ban on where to find those AppImages.
We also updated our social rules to reflect that any discussion about these emulators will come with a warning first and then a ban on where to find AppImages.
The old guides are still available in the Archive 📂 section, but they are not updated (except for rare format changes that need to be done on all of the wiki).