| Both sides previous revision Previous revision Next revision | Previous revision |
| emulators:winetricks [2024/03/04 13:11] – [Listing the available winetricks] Linking to Winetricks Github for an up to date version fishou | emulators:winetricks [2026/04/19 11:49] (current) – [Example] crcerror |
|---|
| ===== Usage ===== | ===== Usage ===== |
| |
| The commands for Wine/Winetricks are different on Batocera than on other classic Linux distributions. The syntax for installing a winetrick into a wineprefix is as follows: ((You need to put the absolute path to the ''.wine'' folder, for example ''/userdata/saves/windows/lutris/game.pc.wine'' or ''/userdata/saves/windows/proton/game.pc.wine'' or ''/userdata/roms/windows/game.wine''))<code>batocera-wine windows tricks <absolute-path-to-the-wineprefix> <trick-to-install></code> | The commands for Wine/Winetricks are different on Batocera than on other classic Linux distributions. The syntax for installing a winetrick into a wineprefix is as follows: ((You need to put the absolute path to the ''.wine'' folder, for example ''/userdata/system/wine-bottles/windows/ge-custom/<myGame>.pc.wine''))<code>batocera-wine windows tricks <absolute-path-to-the-wineprefix> <first-trick-to-install> <second-trick-to-install> ... <nth-trick-to-install></code> |
| |
| <WRAP center round tip> | <WRAP center round tip> |
| Note that you can only install one winetrick after another, so it is necessary to run the command from above multiple times if you have multiple winetricks to install. | Note that you can only install one winetrick after another if you use Batocera lower than **v43**, so it is necessary to run the command once per time per trick if you have multiple winetricks to install. |
| </WRAP> | </WRAP> |
| |
| First of all, it is necessary to either get the game's data as an installer or as raw binary files. For this example, the game is not installed on Batocera by using its installer but just copied the game's binaries to the according filesystem path at ''/userdata/roms/windows/Giana Sisters - Twisted Dreams.pc'' with the according ''autorun.cmd'' already set up (get more information about the ''autorun.cmd'' [[systems:windows|here]]). | First of all, it is necessary to either get the game's data as an installer or as raw binary files. For this example, the game is not installed on Batocera by using its installer but just copied the game's binaries to the according filesystem path at ''/userdata/roms/windows/Giana Sisters - Twisted Dreams.pc'' with the according ''autorun.cmd'' already set up (get more information about the ''autorun.cmd'' [[systems:windows|here]]). |
| After updating the gamelist via the ES menu, the game accours on the WINE games list. In order to get Batocera creating the according wineprefix, the game has to be started manually once (where all ES specific game settings have to be left on default) via ES. Now the winefrefix is being created on the filesystem automatically at the following path: \\ | After updating the gamelist via the ES menu, the game accours on the WINE games list. In order to get Batocera creating the according wineprefix, the game has to be started manually once (where all ES specific game settings have to be left on default) via ES. Now the winefrefix is being created on the filesystem automatically at the following path: \\ |
| ''/userdata/saves/windows/proton/Giana Sisters - Twisted Dreams.pc.wine'' \\ | ''/userdata/system/wine-bottles/windows/ge-custom/Giana Sisters - Twisted Dreams.pc.wine'' \\ |
| Be patient while you see the according blue screen, depending on Batocera's hardware it may take a while. | Be patient while you see the according blue screen, depending on Batocera's hardware it may take a while. |
| Then, as the game is missing some dependencies, it will not start correctly and therefore it should crash and exit back to the ES desktop automatically (which is expected, so don't worry!). If it freezes instead, just exit manually by pressing ''Alt + F4'' followed by ''End Process'' on the keyboard (sometimes you have to do it twice): [{{:emulators:winetricks_02.png?400|End Process}}] | Then, as the game is missing some dependencies, it will not start correctly and therefore it should crash and exit back to the ES desktop automatically (which is expected, so don't worry!). If it freezes instead, just exit manually by pressing ''Alt + F4'' followed by ''End Process'' on the keyboard (sometimes you have to do it twice): [{{:emulators:winetricks_02.png?400|End Process}}] |
| |
| * First, to let the system become aware of your resolution settings, execute the following command: <code>export DISPLAY=:0.0</code> | * First, to let the system become aware of your resolution settings, execute the following command: <code>export DISPLAY=:0.0</code> |
| * Now set the Wine architecure (''win32'' for 32-bit or ''win64'' for 64-bit) to the according game's architecure, 64-bit in this case: <code>export WINEARCH=win64</code> | * Now set the Wine architecture (''win32'' for 32-bit or ''win64'' for 64-bit *default arch and therefore not needed*) to the according game's architecure, 64-bit in this case: <code>export WINEARCH=win64</code> |
| * Now you need to use ''batocera-wine'' with the ''tricks'' command as follows, which will install the first needed winetrick to the game's wineprefix (Note that if you have any whitespaces in your path you have to put the whole path into single quotes as in the following example): <code>batocera-wine windows tricks '/userdata/saves/windows/proton/Giana Sisters - Twisted Dreams.pc.wine' xact_x64</code> Now install the next winetrick: <code>batocera-wine windows tricks '/userdata/saves/windows/proton/Giana Sisters - Twisted Dreams.pc.wine' wmp11</code> | * Next create the prefix according your exported architecture. The command will not work if there is already a prefix! The reason is, if you want to change the architecture (32/64bit) this works **only** if the prefix is initiated at first time - it can not be changed later. So delete the prefix and start over by using ''batocera-wine'' with the ''createprefix'' command: <code>batocera-wine windows createprefix '/userdata/system/roms/windows/Giana Sisters - Twisted Dreams.pc'</code> |
| | * Now you need to use ''batocera-wine'' with the ''tricks'' command as follows, which will install the first needed winetrick to the game's wineprefix (Note that if you have any whitespaces in your path you have to put the whole path into single quotes as in the following example): <code>batocera-wine windows tricks '/userdata/system/wine-bottles/windows/ge-custom/Giana Sisters - Twisted Dreams.pc.wine' xact_x64 wmp11</code> |
| | |
| | **Something to note: Since v43 the ''createprefix'' command and the ability to daisychain several tricks was installed, for versions before v43 you install trick per trick.** |
| |
| <WRAP center round tip> | <WRAP center round tip> |