Updated the Windows portable installation instructions.

This commit is contained in:
Leon Styhre 2021-06-25 11:47:15 +02:00
parent 31fc6c33e6
commit 7bd5f5b732

View file

@ -1145,46 +1145,46 @@ So the home directory will always take precedence, and any resources or themes l
It's possible to easily create a portable installation of ES-DE for Windows, for example on a USB memory stick. It's possible to easily create a portable installation of ES-DE for Windows, for example on a USB memory stick.
For the sake of this example, let's assume that the removable media has the device name `f:\`. For the sake of this example, let's assume that the removable media has the device name `f:\`
These are the steps to perform:
* Copy the EmulationStation-DE installation directory to f:\ * Copy the EmulationStation-DE installation directory to f:\
* Create the directory `ES-DE_Home\.emulationstation` directly under f:\ * Copy your emulator directories to f:\
* Copy `f:\EmulationStation-DE\resources\systems\windows\es_systems.xml` to `f:\ES-DE_Home\.emulationstation\custom_systems\` * Create the directory `ES-DE_Home` directly under f:\
* Copy your game ROMs into `f:\ES-DE_Home\ROMs` * Copy your game ROMs into `f:\ES-DE_Home\ROMs`
* Copy your emulators to f:\ (such as the RetroArch directory) * Create the file `Start_ES-DE.bat` directly under f:\
* Create the file `start_es.bat` directly under f:\
Add the following lines to the start_es.bat file: Add the following lines to the Start_ES-DE.bat file:
``` ```
@echo off @echo off
EmulationStation-DE\EmulationStation.exe --home %CD:~0,3%ES-DE_Home EmulationStation-DE\EmulationStation.exe --home %CD:~0,3%ES-DE_Home
``` ```
The emulators that will be automatically searched for by ES-DE are (relative to the EmulationStation-DE directory):
```
..\RetroArch-Win64\retroarch.exe
..\RetroArch\retroarch.exe
..\yuzu\yuzu-windows-msvc\yuzu.exe
```
The two dots will of course resolve to the root of the device in this example, such as ..\RetroArch-Win64\retroarch.exe being the same as f:\RetroArch-Win64\retroarch.exe
This means that as long has you don't have any non-standard directory names for your emulators, everything should work fine with the default configuration. But if needed, these paths can be easily customized by modifying f:\EmulationStation-DE\resources\systems\windows\es_find_rules.xml
The contents of f:\ should now look something like this: The contents of f:\ should now look something like this:
``` ```
EmulationStation-DE EmulationStation-DE\
ES-DE_Home ES-DE_Home\
RetroArch RetroArch-Win64\
start_es.bat yuzu\ (if you're using this Nintendo Switch emulator)
Start_ES-DE.bat
``` ```
Now run the batch script to start ES-DE and check that everything works as expected, for example that the gamelists are properly populated. Now run the batch script to start ES-DE and check that everything works as expected.
Exit the application and modify the file `f:\ES-DE_Home\.emulationstation\custom_systems\es_systems.xml` to point to the emulators on the portable media. Following this, optionally copy any existing gamelist.xml files and game media files to the removable media. By default these should be located here:
For instance, change from this:
```
<command>retroarch.exe -L %EMUPATH%\cores\snes9x_libretro.dll %ROM%</command>
```
To this:
```
<command>%ESPATH%\..\RetroArch\retroarch.exe -L %EMUPATH%\cores\snes9x_libretro.dll %ROM%</command>
```
The %ESPATH% variable is explained later in this document.
Following this, optionally copy any existing gamelist.xml and game media files to the removable media. By default these files should be located here:
``` ```
f:\ES-DE_Home\.emulationstation\gamelists\ f:\ES-DE_Home\.emulationstation\gamelists\