Wine-Staging Configuration

From WineHQ Wiki
Jump to: navigation, search

The goal of Wine Staging is to make applications work out of the box, but in order to provide compatibility from Windows 3.1 to Windows 10 it is sometimes necessary to dynamically change the behavior of Wine. Some applications are for example incompatible with specific Windows versions and refuse to install. To solve this problem Wine contains many different settings and this page will give you are short overview about the most important ones. On the sub pages you will also find settings which are only available in Wine Staging.


The most important Wine settings can be configured through a utility called winecfg. All settings are stored in the registry and theoretically can also be altered manually - but winecfg provides you with a graphical user interface and some convenience functions to make it easier to select the correct values. You can start winecfg by executing the following command:


You should now see a user interface similar to the one in the screenshot:


The different tabs contain short descriptions telling you what these settings are used for, but it makes sense to take a look at winecfg or the Wine User Guide for some more extended explanations.

Since Wine Staging 1.7.33 there is also an additional *Staging* tab which contains switches for some experimental features. As the time of writing, you can enable/disable the Wine-Staging_CSMT in this tab.


Almost all Wine settings are internally stored as registry keys and many of them can either be configured for the whole Wine prefix or individually for each installed application. In order to change the global settings which affects all applications inside this wineprefix, start regedit using the following command and go to HKEY_CURRENT_USER\Software\Wine

/opt/wine-compholio/bin/wine regedit

You should now see registry keys similar to the ones in this screenshot:


There are also some other keys which contain Wine settings, but HKEY_CURRENT_USER\Software\Wine is the most important one. Here you can change the sound driver between ALSA, Pulse and OSS or alter Direct3D settings. A full list of registry keys is available in UsefulRegistryKeys. Some of these keys, like DllRedirects are only available in Wine Staging and are described further in their configuration pages.