Configuration

Michael Müller edited this page Dec 15, 2014 · 1 revision

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.

Winecfg

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.

/opt/wine-compholio/bin/winecfg

You should now see a user interface similar to the on 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 the Wine Wiki 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 CSMT in this tab.

Registry

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 on 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 the Wine Wiki. Some of these keys like DllRedirects are only available in Wine Staging and are described in the sub pages of Configuration.