About Us

Products

Services

Compatibility

Partners

Support

Store
 Login  View Cart

Tweaking your configuration

The Wine configuration used by CrossOver is stored in the registry under the HKEY_CURRENT_USER\Software\Wine key. Changing these settings can prevent applications from working correctly in subtle ways, so you should make a backup of the registry file before changing it. It is located in ~/.cxoffice/bottlename/user.reg. At this time some of the settings can be changed via a new configuration program called winecfg. This program is still under development and support is not provided for changing all of the settings. If you need to change a setting not provided by winecfg then you will need to edit the registry to make the required change. The following options are supported:

  • Windows Version

  • X11 Driver settings

  • DLL overrides

Setting your Windows version

If your applications needs Windows version 95, NT, 98, ME, 2000, or XP you can set the version in the config file. This is a simple change that can be made via winecfg. Simply run

$ ~/cxoffice/bin/cxrun

Select the correct bottle and type in winecfg for the command.

All you have to do is change "win98" to the version that is required for your application to run. As an example we will say your application needs Windows XP. Just change "win98" to "winxp" and now CrossOver should recognize your Windows version as Windows XP.

Note this change will affect the current bottle and may break some applications! You can also change the Windows version on an application by application basis and this is the recommended way. For example, the following entry will make CrossOver report the Windows version as Windows 2000 to myapp.exe.

Setting your Desktop Resolution

If you want your application to take a smaller windowed size you can set the X11 driver to the mode that you prefer. For example if you would like to play myapp.exe at 1024x768 even though your desktop is set at 1600x1200 this is possible by setting your desktop mode to a lower resolution. All you need to do is replace 1024x768 with your desired resolution and then restart CrossOver. Also, some applications run better in "Desktop" mode, so if you are having trouble starting a certain program, try adding a application override entry for it:

$ ~/cxoffice/bin/cxrun

Select the correct bottle and type winecfg for the application, Click on Add Application, browse for your program and then click on the Graphics Tab and check Emulate a virtual Desktop.

Using Native DLLs in CrossOver

Builtin DLLs are included in CrossOver and are located in ~/cxoffice/lib/wine. You must use the builtin versions of some DLLs (e.g. kernel32, user32, x11drv, ntdll, winsock, d3d8, dsound, mci), however having the native versions of certain DLLs can improve the functionality of many programs.

In order to use these DLLs you will first need to:

  • Retrieve the DLLs from a Windows CD or install, or

  • Download the DLLs from a server on the internet, or

  • Have an application install the DLLs for you

Then change their setting from builtin to native. You may also have to edit the configuration to add DLLs that are not currently included. There are some exceptions too. For instance, it is highly recommended that you use the "Builtin" DirectX DLLs at this time as most native DirectX DLLs will not work in Wine because they interface directly with the low-level Windows drivers.

As an example we will say you need to add imm32.dll as a Native DLL below is an example of how this would be done.

$ ~/cxoffice/bin/cxrun

Select the correct bottle and type winecfg for the application, Click on Add Application, browse for your program and then click on the Libraries Tab and type in the name of your library without the .dll extension. Then select Native for a Windows native DLL or builtin to select a DLL that ships with CrossOver.

If your application needs more than one DLL to work, just keep adding the needed DLLs to your list.

Debugging your application

There are many tools built into CrossOver for debugging applications. To see a short list of some of the available channels, just start wine with -h in a terminal and a list of available help commands will be printed out.

If you want to learn more about debugging applications with CrossOver it is a good idea to read over the avaliable documentation on WineHQ concerning debugging. The main difference between CrossOver and Wine is that CrossOver provides a --cx-log option.