From a4911246a20d75d70e7d318122d16a86a0017ca1 Mon Sep 17 00:00:00 2001 From: Leon Styhre Date: Tue, 11 Jul 2023 10:51:59 +0200 Subject: [PATCH] Documentation update --- CHANGELOG.md | 1 + INSTALL-DEV.md | 56 ++++++++++++++++++++++++++++++------------------ USERGUIDE-DEV.md | 40 ++++++++++++++++++++++++++++++++++ 3 files changed, 76 insertions(+), 21 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 432c746dd..eeb5a0c9a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -42,6 +42,7 @@ For the Linux AppImage releases a built-in application updater has been added so * Added ares [Benesse Pocket Challenge V2] standalone as an alternative emulator for the wonderswan system * Added the .sh file extension to the ags system on Unix and macOS and set the %STARTDIR% variable to the game directory * (Linux) Changed a lot of find rules so that emulator AppImages are always searched before Flatpaks +* (Linux) Removed the AppImage systempath find rule entry for RetroArch * (Linux) Added "AppImage (Suspend ES-DE)" and "AppImage (Keep ES-DE running)" as alternative emulators for the windows system * (Linux) Added the .AppImage file extension to the windows system * (Linux) Added support for the official Citra AppImage release diff --git a/INSTALL-DEV.md b/INSTALL-DEV.md index d2b70b524..ae0c96b52 100644 --- a/INSTALL-DEV.md +++ b/INSTALL-DEV.md @@ -1510,6 +1510,13 @@ Here's an example es_find_rules.xml file for Unix (this is not the complete file + + + + bash + sh + + retroarch @@ -1517,11 +1524,11 @@ Here's an example es_find_rules.xml file for Unix (this is not the complete file RetroArch-Linux-x86_64.AppImage + ~/Applications/RetroArch-Linux*.AppImage + ~/.local/bin/RetroArch-Linux*.AppImage + ~/bin/RetroArch-Linux*.AppImage /var/lib/flatpak/exports/bin/org.libretro.RetroArch ~/.local/share/flatpak/exports/bin/org.libretro.RetroArch - ~/Applications/RetroArch-Linux-x86_64.AppImage - ~/.local/bin/RetroArch-Linux-x86_64.AppImage - ~/bin/RetroArch-Linux-x86_64.AppImage @@ -1544,7 +1551,7 @@ Here's an example es_find_rules.xml file for Unix (this is not the complete file /usr/pkg/lib/libretro - + dosbox-staging @@ -1552,6 +1559,7 @@ Here's an example es_find_rules.xml file for Unix (this is not the complete file /var/lib/flatpak/exports/bin/io.github.dosbox-staging + ~/.local/share/flatpak/exports/bin/io.github.dosbox-staging @@ -1559,13 +1567,13 @@ Here's an example es_find_rules.xml file for Unix (this is not the complete file yuzu org.yuzu_emu.yuzu - yuzu.AppImage - /var/lib/flatpak/exports/bin/org.yuzu_emu.yuzu ~/Applications/yuzu*.AppImage ~/.local/bin/yuzu*.AppImage ~/bin/yuzu*.AppImage + /var/lib/flatpak/exports/bin/org.yuzu_emu.yuzu + ~/.local/share/flatpak/exports/bin/org.yuzu_emu.yuzu @@ -1631,6 +1639,13 @@ For reference, here are also example es_find_rules.xml files for macOS and Windo + + + + zsh + bash + + /Applications/RetroArch.app/Contents/MacOS/RetroArch @@ -1672,6 +1687,12 @@ For reference, here are also example es_find_rules.xml files for macOS and Windo + + + + cmd.exe + + @@ -1698,10 +1719,8 @@ For reference, here are also example es_find_rules.xml files for macOS and Windo %ESPATH%\Emulators\RetroArch-Win64\retroarch.exe %ESPATH%\Emulators\RetroArch\retroarch.exe - %ESPATH%\RetroArch-Win64\retroarch.exe - %ESPATH%\RetroArch\retroarch.exe - %ESPATH%\..\RetroArch-Win64\retroarch.exe - %ESPATH%\..\RetroArch\retroarch.exe + %ESPATH%\..\Emulators\RetroArch-Win64\retroarch.exe + %ESPATH%\..\Emulators\RetroArch\retroarch.exe @@ -1711,18 +1730,14 @@ For reference, here are also example es_find_rules.xml files for macOS and Windo - - SOFTWARE\PCSX2\Install_Dir|\pcsx2.exe - - pcsx2.exe + pcsx2-qt.exe + pcsx2-qtx64.exe + pcsx2-qtx64-avx2.exe - C:\Program Files (x86)\PCSX2\pcsx2.exe - D:\Program Files (x86)\PCSX2\pcsx2.exe - %ESPATH%\Emulators\PCSX2\pcsx2.exe - %ESPATH%\PCSX2\pcsx2.exe - %ESPATH%\..\PCSX2\pcsx2.exe + %ESPATH%\Emulators\PCSX2-Qt\pcsx2-qt*.exe + %ESPATH%\..\Emulators\PCSX2-Qt\pcsx2-qt*.exe @@ -1733,8 +1748,7 @@ For reference, here are also example es_find_rules.xml files for macOS and Windo ~\AppData\Local\yuzu\yuzu-windows-msvc\yuzu.exe %ESPATH%\Emulators\yuzu\yuzu-windows-msvc\yuzu.exe - %ESPATH%\yuzu\yuzu-windows-msvc\yuzu.exe - %ESPATH%\..\yuzu\yuzu-windows-msvc\yuzu.exe + %ESPATH%\..\Emulators\yuzu\yuzu-windows-msvc\yuzu.exe diff --git a/USERGUIDE-DEV.md b/USERGUIDE-DEV.md index f5ab7b06f..68f4b78e6 100644 --- a/USERGUIDE-DEV.md +++ b/USERGUIDE-DEV.md @@ -657,6 +657,46 @@ The following emulators are supported in AppImage format when using the bundled _RMG = Rosalie's Mupen GUI_ +## AppImage vs Flatpak search order on Linux + +As of ES-DE 2.1.0 emulator AppImages are always searched before Flatpaks while in previous releases the opposite was true. + +To clarify with an example, this is what the find rule entry for the Dolphin emulator looks like: +``` + + + + dolphin-emu + org.DolphinEmu.dolphin-emu + + + ~/Applications/Dolphin_Emulator*.AppImage + ~/.local/bin/Dolphin_Emulator*.AppImage + ~/bin/Dolphin_Emulator*.AppImage + /var/lib/flatpak/exports/bin/org.DolphinEmu.dolphin-emu + ~/.local/share/flatpak/exports/bin/org.DolphinEmu.dolphin-emu + + +``` + +The _staticpath_ rules are always parsed in the order they are defined, and as the AppImage entries are listed above the Flatpak entries, these will be searched first. + +There is however a workaround available to launch the Flatpak first, should you prefer that. As you can see in the above example there is also a _systempath_ entry for the Flatpak launch file, and by manually defining the path to your Flatpak bin directory you can make use of this systempath entry instead, which will always be executed before the staticpath entries. + +For example if using the ES-DE AppImage release, this would be the command to execute: +``` +PATH=/var/lib/flatpak/exports/bin:~/.local/share/flatpak/exports/bin:$PATH ./EmulationStation-DE-x64.AppImage +``` + +Obviously you would need to change the path to the AppImage if it's not in your current working directory. + +You can also set the PATH variable permanently in your shell environment configuration file: +``` +export PATH=/var/lib/flatpak/exports/bin:~/.local/share/flatpak/exports/bin:$PATH +``` + +Refer to your operating system documentation for more details of how the PATH environmental variable works and how to customize your shell environment. + ## Using manually downloaded emulators on Linux Normally on Linux you would install emulators using either one of the established cross-distribution package formats, i.e. AppImage, Snap or Flatpak, or you would install them using the operating system repository (including the AUR if available on your OS). Less likely would be to manually build from source code and install to a standard system directory. In all these instances ES-DE should be able to find the emulator when launching a game. But in some cases you may instead manually download an emulator as an archive file to unzip somewhere on the file system. Normally you would want to place these files in your home directory, and if running a distribution that has an immutable filesystem (such as SteamOS or Fedora Silverblue), you don't even have the choice to install them to a standard system directory.