Troubleshooting Unlisted Applications in CrossOver Mac

An unlisted application is an application that does not have a CrossTie, or installation recipe, in CrossOver's application database. CrossOver does not default any install details for unlisted applications, so they may not run correctly or at all. But if you’re willing to experiment, it might be possible to get an unlisted application working.

To begin, search the compatibility database to see if the program you're trying to install is listed there. If other users have worked with the same program, there may be useful information. You can check out the comments that other users have left on their ratings, you can go to the Tips section, and you can search the forums to potentially learn how to get your program running.

If the compatibility database doesn’t yield any answers, there are a few other things you can try: you can install additional dependencies, you can make changes to Wine Configuration and you can edit registry settings. We have instructions for all of these below.

Note that our support staff will not examine unsolicited logs for an unlisted application.

Installing Dependencies

In many cases, an unlisted application isn’t running because it needs some additional Windows dependencies. An easy way to troubleshoot is to import an archive containing several common dependencies. If it works, you don’t know which dependency was needed, but you got your application up and running quickly.

Click on the link below to download a pre-made dependency archive. When the download is complete, import the archive into CrossOver by going to the Bottle menu and selecting Import Bottle Archive.

The-Kitchen-Sink.cxarchive (unlock code is demo)

Once the download is complete, import the archive into CrossOver by going to the Bottle menu and select Import Bottle Archive.

After you import the dependency archive, select your newly imported bottle from the Bottles list in the left sidebar, and click Install Application into Bottle.

On the Install screen, select Install an Unlisted Application.

Note that CrossOver has identified the bottle you selected as the bottle for installation, so you just need to select your installer and click Install.

If you already know which dependency is needed, you can always search for and select the dependency you want to install instead of using a dependency archive. Additionally, advanced users can gather a debug log of a misbehaving program and determine which specific libraries or frameworks referenced in log error messages are needed to get the program running.

Adjusting Wine Configuration Settings

The Wine Configuration tool allows you to make changes to bottle settings. This tool is quite powerful and incorrect settings may damage the bottle and require it to be deleted.

The Wine Configuration tool is accessible from the Control Panels menu in the right sidebar when a bottle is selected.

Common troubleshooting steps in the Wine Configuration tool include the following:

  • Changing DLL Overrides (Libraries tab) — CrossOver by default tries to handle all API commands your Windows program wants to use. Using the Libraries tab you can tell CrossOver to pass the API commands to use a native Windows DLL instead.
  • To change an existing override, select a DLL from the Existing overrides list and click Edit. The Native option uses the native Windows DLL and the Builtin option uses Wine's replacement.
  • If your application installs a custom DLL, for example called SOMEAPP.DLL, you can add that DLL here and tell CrossOver to default to using the native DLL instead of trying to translate the API command using Wine's replacement DLLs. To add a new DLL, enter the name of the DLL in New override for library and click Add.
  • Map a new drive letter (Drives tab) — CrossOver creates and maps three drive letters in each bottle. The C:' drive points to the root of the bottle, the 'Y:' drive to your home folder, and 'Z: points to the root of your hard drive. External drives or removable drives like CDs, DVDs, and USB sticks are automatically given a drive letter when mounted by the OS. In some cases, a program wants its CD/DVD mounted before it'll run as a type of copy protection. Click Add, choose the D: drive, and set it to the CD/DVD.

Editing registry keys

Editing a bottle's registry keys can be beneficial, mainly for games. If registry keys are needed, they're often found on the program's app entry.

Next Step: Creating a Debug Log

Last modified on 2023-11-27 20:41:31 UTC by Andrew Balfour