Differences

This shows you the differences between two versions of the page.

--- emulators:winetricks [2022/10/08 18:21] – Replaced winetricks listings from raw text to downloadable .txt file. grandmabetty
+++ emulators:winetricks [2026/04/19 11:49] (current) – [Example] crcerror
@@ Line 7: / Line 7: @@
 ===== 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>
-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>
@@ Line 23: / Line 23: @@
 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: \\
-''/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.
 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}}]
@@ Line 30: / Line 30: @@
   * 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>
@@ Line 37: / Line 40: @@
 </WRAP>
-That was mostly it. Now as in Wine this game needs Vulkan in order to call the according DirectX graphics API, it is necessary to enable ''DXVK FEATURE'' in the ES game's ''Advanced Game Settings'' menu: [{{:emulators:winetricks_01.png?400|DXVK FEATURE}}]
+That was mostly it. Now as for Wine the game "Giana Sisters: Twisted Dreams" needs Vulkan in order to interact with the according DirectX graphics API, it is necessary to enable ''DXVK FEATURE'' in the ES game's ''Advanced Game Settings'' menu: [{{:emulators:winetricks_01.png?400|DXVK FEATURE}}]
 Now start the game via ES and have fun!
@@ Line 44: / Line 47: @@
 ===== Listing the available winetricks =====
-You can produce this information on your own by executing the following command: <code>/usr/wine/winetricks list-all</code>
+You can produce this information on your own by executing the following command on your batocera: <code>/usr/wine/winetricks list-all</code>
-A static copy is below, last updated 08.10.2022.
-{{ :emulators:winetricks.txt |winetricks.txt}}
+An updated list can also be found at [[https://github.com/Winetricks/winetricks/blob/master/files/verbs/all.txt|the Winetricks github page]], though generating it from your batocera version is the preferred method.
 ===== Troubleshooting =====
 ==== System "freezes" when installing a winetrick ====
-Depending on the winetrick you want to install you may run into the issue that the system seems to freeze on the remote command line. Before giving up you should take a look on your Batocera screen. It may ask you to interact. \\ Example: If you want to install the ''vcrun2017'' the system seems to freeze at this point: \\ ''0104:fixme:oleacc:find_class_data unhandled window class: L"Button"'' \\ So you may think it fails to install but instead there's the according package setup appearing on the Batocera screen witing for you to interact: [{{:emulators:winetricks_03.png?400|Setup menu}}]
+Depending on the winetrick you want to install you may run into the issue that the system seems to freeze on the remote command line. Before giving up you should take a look on your Batocera screen. It may ask you to interact. \\ Example: If you want to install the ''vcrun2017'' the system seems to freeze on the remote command line at this point: \\ ''0104:fixme:oleacc:find_class_data unhandled window class: L"Button"'' \\ So you may think it fails to install but instead there's the according package setup popping up on the Batocera GUI screen, waiting for you to interact: [{{:emulators:winetricks_03.png?400|Setup menu}}] In this case, just go through the setup process and you're done.