CrossOver Support

Setting registry keys for a bottle


You may encounter tips, guides, or instructions for troubleshooting issues that ask you to set registry keys for windows applications. Each bottle has a separate registry, and registry keys set in one bottle do not affect other bottles, however note that registry keys set in a given bottle may affect all applications in that bottle - this is another reason to install your applications into their own, separate bottles (unless you have a good reason not to).

There's a great breakdown of useful registry keys over at WineHQ. In this guide's example, we'll set the "useGLSL" key to "enabled".

To get started, you need to access the registry for a given bottle. Launch Crossover, then highlight the bottle in question and click on "Run Command":



In the "Run Command" window type "regedit" in the "command" field and click "run":



This will open up the registry editor:



Now, browse to the location specified in the instructions you're following. Again, for this example we'll add "useGLSL=enabled" to "HKEY_CURRENT_USER/Software/Wine/Direct3D", which is a fairly common value to add for 3D games.

note - it's fairly common to abbreviate "HKEY_CURRENT_USER" as "HKCU", "HKEY_CLASSES_ROOT" as "HKCR", as so on.

Browsing to "HKEY_CURRENT_USER/Software/Wine", we see that "Direct3D" isn't there, yet:



To add "Direct3D", right-click on "Wine" and select "New>Key" (or highlight "wine" and go to "Edit>New>Key>"):



And then name the "New Key" entry that appears (we'd name it "Direct3D" in this case):



To add "useGLSL=enabled", which is a string value (the instructions you're following should indicate what type of value you need), highlight the new "Direct3D" key, right-click, and choose "New>String Value" (or highlight "Direct3D" and go to "Edit>New>String Value"). This will generate an entry in the right-side panel:



Name it "useGLSL", hit "enter", and then right-click and choose "Modify" (or "Edit>Modify"):



Type "enabled" in the "Value data" field, and click "ok":



The String Value "useGLSL=enabled" has now been added to "HKEY_CURRENT_USER/Software/Wine/Direct3D".

Other Articles

How to edit the registry in older versions of Crossover
Last modified on 2017-01-24 10:50:23 by Andrew Balfour
Are you sure you want to delete this page?
Note: Any nested pages that are under this one will be moved up one level. Any attachments tied to this page will be deleted.
Move / Rename Page
Unknown Error, unable to move!
That page exists already!
One or more of the parent pages specified in new path do not exist!
/support/wiki/ /support/wiki/linux/linuxtutorial/registry_keys
Please Wait...
eyJjYXJ0IjowLCJ0enMiOi01LCJjZG4iOiJodHRwczpcL1wvbWVkaWEuY29kZXdlYXZlcnMuY29tXC9wdWJcL2Nyb3Nzb3Zlclwvd2Vic2l0ZSIsImNkbnRzIjoxNTI1ODk4MDg2fQ==