Running Windows Applications on macOS with Wine (WineBottler, Wineskin Winery, PlayOnMac, and CrossOver)

Guide Emulators by Emuzone

Verre de vin (wine)

What is Wine?

Wine is not an emulator; in fact, its acronym "Wine Is Not an Emulator" reflects this. Unlike VirtualBox, Wine does not emulate a machine or low-level code; instead, it is an interpreter that "mimics" Windows. In simple terms, Wine translates calls to Windows functionalities and related libraries into function calls for the host OS, in our case: macOS.

If you are using an old PPC OS X, then you should look into Darwine, unfortunately no longer updated or supported.


 Wine

wine000.png

Installation

Several methods exist to obtain Wine. Developers will retrieve the source code from the official website to compile it themselves before installing the application. Note that to support 64-bit Windows, during configuration, you normally need to add the argument "--enable-win64".

wine010.png

Others will use brew install wine in the terminal for an automated installation via brew.

You know that packages including binaries are also available on the official website.

Execution

Once Wine is installed, it is then easy to launch Windows applications using the following simple command in the terminal:

wine <path_to_application>/<application_name>.exe

wine020.png


 

wine030.png

In the case of a prior installation, the latter is launched in the same way via the terminal:

wine <path_to_installer>/<installer>.exe

Note that if it is an MSI file, it is recommended to use the following command:

msiexec /i <installer>.msi

Configuration

But to go a bit further, we will install a game whose files intended for this purpose are on a CD. And to begin, we will configure our Windows emulation by typing:

winecfg

A window then opens

wine040.png

In the Applications panel, you can choose the version of Windows you want to emulate. This can be important.

wine050.png

With the Libraries panel, you have the choice regarding many libraries to install such as DirectX.
Note that not all are available and you will likely need to manually install libraries for some applications.

wine060.png

The Display panel will allow you to manage some options like font size and have a virtual desktop.

wine070.png

With the Desktop Integration panel, you will be able to redirect typical Windows folders to folders on your Mac.

wine080.png

The Drivers panel will likely be the most used.

It will allow you to manage storage spaces like hard drives, optical discs, and floppy disks.

wine090.png

In the dedicated audio panel, you can modify the type of devices to use.

wine100.png

For the last "About" panel, let me leave you to discover it.

Usage

Let’s start with the installation of a game that spans two CDs and, to do so, begin by mounting your first CD and, in a new terminal, launch winecfg. Note the drive on which your volume is mounted and trigger the installation.

wine110.png


 

wine111.png

When prompted to change the disc, remove the first disc to mount the second and open a new terminal to launch winecfg if needed, then go to the drive configuration panel.

wine120.png

Remove the discs.
Then add a new drive with the letter you noted, which was assigned to the first CD.

wine130.png

Click on the Browse button and choose the volume of your second CD.

wine140.png

By displaying the details, you can ensure that the type is indeed CD-ROM, otherwise modify it.

wine150.png

Normally, your installation should resume normally. If this is not the case, you can perform this operation manually via the terminal and, to begin with, check which drive was mounted for your second CD in the dosdevices folder of Wine.

wine160.png

You will notice that the chosen letter is 'e', so you will rename the 'e:' folder to 'd:'

wine170.png

The installation should then resume normally.

If this still wasn’t the case, another technique—which we will use later with Wineskin (see below for more details)—involves copying the contents of the CD-ROMs into a folder on your hard drive. Then, via Wine’s configuration, specify that folder as the CD.

Note where your application’s executable is installed on your C: drive, as you will need to re-enter the full path to launch it, knowing that this drive is physically located on your disk in the directory ~/.wine/drive_c/ or /Users/<username>/.wine/drive_c

Thus, after installing our small game, we can see that the installation was successful in the specified directory within our user folder.

wine180.png

And we can then execute it.

wine190.png

Appendix

For experts with a good knowledge of Microsoft’s system registry, the latter can be modified via text files with a *.reg extension located in your ~/.wine/ folder.

You can also open the registry using the simple command: wine regedit

wine200.png


 

wine201.png

 


WineBottler


 

wine210.png

An old utility no longer updated and apparently no longer supported, it allows generating a complete macOS application called a bottle.

Creation

In its simplest use, it allows creating a macOS application from a ready-to-use Windows executable. To do this, we will use MegamanMaker.

Open WineBottler and display the advanced panel by clicking on the "Advanced" icon.

wine211.png

Start by clicking on the "Select File" button and choose the Windows executable.

wine220.png

Continue with the configuration.

For this application, the files alongside the executables are crucial for its proper functioning, which is why we must choose the third installation mode ("copy file and files in the folder to the App bundle"). In the case where the executable is self-contained, the second option ("copy file to the App bundle") would then be more appropriate.

Several versions of Windows are available, ranging from XP to Seven.

Installations of frameworks such as Mono for .NET applications or Gecko are possible for applications that require them to function. However, since we don’t need them here, we will mainly aim to save some space and thus won’t activate them. We will also select the following two options: deleting the Windows installation directories and user profiles.

The last section, called "App Bundle," is also very important.

You can choose to include Wine directly (an old version 1.8-rc4) in it, making the application standalone, or not, which will require the end user to install Wine on their Mac but will allow them to enjoy a version that is undoubtedly more recent.

Note that we can add a copyright notice and a version number, as well as the type of our application.

But the most important thing is the identifier we will enter in the "identifier" field. This is the name of the folder that will be created in the user’s library, so it seems logical that this name resembles what other applications already do and is easily identifiable during a search.

That's why I decided to follow this naming convention: "com..."

wine230.png

Once the parameters are filled in, click the "Install" button and choose the name of your macOS application and its location.

wine240.png

The creation process starts...

wine250.png

A message will inform you when the application is complete.

wine260.png

You can then enjoy using it.

wine270.png


 

wine280.png

Deletion

In case of deleting your application, simply moving it to the Trash is not enough. Remember that a folder is created on the first launch in the User Library within the "Application Support" folder, and it bears the name of the identifier you previously chose with a numerical suffix.

wine290.png

Note that WineBottler also allows you to properly delete these folders by clicking on the "On my Mac" icon, where all your applications are displayed, offering you the option to delete them cleanly or reset them.

wine300.png

Installation

Creating a Mac application from a Windows one is great, but what about when an installation is required? Let's try with Heroes of Yggdrasil and go back to the advanced panel. Choose the first installation mode ("Execute file").

wine310.png

Instead of selecting the application executable, you must select the installer executable.

wine320.png

The rest of the configuration proceeds as previously described.

wine330.png

Again, by clicking the "Install" button, you will be prompted to choose the location and give a name to the final macOS application.

wine340.png

The Windows installation will then launch.

wine350.png

And you will only need to follow the steps normally.

wine360.png

Once finished, you will have to choose the executable file to run.
In our specific case, you must obviously select the one for the game we just installed.

wine370.png

The application is then finalized.
And you can launch the Windows game as if it were a Mac game.

wine380.png


Wineskin Winery


 

wine390.png

Wineskin is based on the same principle as WineBottler but is more recent and offers a more up-to-date wrapper version.

Update

Once Wineskin is installed, the first thing we will do, via our internet connection, is to update the wrapper, which currently remains unfortunately stuck at version 2.6.2.

wine400.png

Usage

Once this step is completed, we will be able to create our first wrapper with a simple application. By chance, the Golden Axe created with OpenBor.

After clicking the create button, you are asked to name your application.

wine410.png

Once the name is validated, Wineskin will take some time to create the environment and notify you once it is done.

wine420.png

Then choose to go to the folder containing your new application via the blue button. If you missed this step, know that it is located in the Wineskin folder, which is itself inside the "Applications" folder at the root of your user account.
Ask to display the contents of your application.

wine430.png

Then open the Wineskin application normally.

wine440.png

Click the "Install Software" button.

wine450.png

Since our game is already in a ready-to-use folder, we do not need to perform an installation. We can then copy the contents of the folder into our wrapper or move them inside it.

No matter your choice here, but personally I use the "Move a Folder Inside" option.

wine451.png

All that remains is to select the folder containing all the useful files for the game (or the executable if your Windows application is self-contained).

wine460.png

In our case, since multiple executables are available in the folder, the one automatically selected is not the right one.

wine470.png

You therefore need to modify the one the wrapper will execute.

wine471.png

Then you confirm.

wine472.png

You can reopen the "Advanced" panel, which will allow you to modify the executable file to run if you made a mistake (don’t hesitate to click on the "Test Run" button to check everything is correct) or modify the version number and the icon of your application.

wine480.png

Our game is ready, and all we have left to do is launch our GoldenAxe.app application normally.

wine490.png


 

wine491.png


 

wine492.png

Installation

Let’s try something a bit more complex with a game that requires installation from two CDs. For this, we will test with a French game: Dark Earth.

While it is possible to install a game normally from the CDs, sometimes by modifying the Wine configuration (as seen above), we will see another technique.
To begin, we will need to create a folder on our hard drive that we will name "DarkEarthInstall". We will copy the contents of the two CDs into it.

Above all, do not replace the files, ask to merge the folders instead.

wine500.png

We create our new wrapper and repeat the steps until we choose "Advanced".

wine510.png

Then, we click on the "Tools" tab.

wine511.png

Next, click the first button "Config Utility".

wine520.png

Upon opening the window, for those who haven't read the tutorial from the start, you can choose the Windows version you want.

wine530.png

For Dark Earth, we will choose Windows 98, then click on the "Device" tab after applying the changes by pressing the "Apply" button.

wine540.png

Here, you can determine the different drives that will be connected. We start by clicking the "Add" button to add a D: drive.

wine550.png


 

wine551.png

Now, you need to define the path of the folder on your macOS corresponding to this new storage space.

This can be facilitated by the "Browse" button, which allows you to navigate through your computer.

wine552.png

Once the folder is selected, in this case the one we created for installation, you can click on the "Show advanced" button to check its mounting.

wine553.png


 

wine554.png

For example, you can change the type and, instead of automatic detection, force the type to hard drive, floppy disk, or CD-ROM, which is what we will do here.

wine555.png


 

wine556.png

Once everything is validated via the "Apply" button (followed by the usual "OK"), we will naturally click on the "Install Software" button.

wine560.png

Proceed with the installation and, for this, choose the "Choose Setup Executable" button.

wine570.png

All that remains is to select the game installer.

wine580.png

It will launch automatically and you just need to follow the steps one by one.

wine590.png

When prompted to change the CD, simply clicking the "OK" button should suffice until the game is fully installed.

wine600.png

Like the option without installation, you will need to select the correct executable to launch the game.

wine610.png

The CD being mandatory to play, you will need to mount it on your Mac, via your CD drive or a disk image.

Then go back to the tools and the Device configuration where you can remove the installation folder you no longer need, and add the path to the CD-ROM allowing you to launch the game if it wasn’t there before.

wine620.png

Here is Dark Earth ready to use.

wine630.png


 

wine631.png

Extension

Regarding updates, extensions, and file access...

If you want to modify, add, remove, or replace files, access is very simple. Display the contents of the package representing your application and, in the folder named "drive_c", access the files directly by following the directory structure specified during installation.

wine640.png

Note that the first folder is a shortcut "drive_c", the physical folder is located in Resources within the Contents folder.

Let’s now see how to install an extension that requires running a setup. For example, we will use Diablo and its extension created by Sierra called "Hellfire".

We insert the game installation CD into our Mac and then create our new wrapper to launch the Wineskin application contained within it.

We naturally choose installation and select the setup included on our CD, then follow the steps normally.

wine650.png

Here, the game launches automatically, and we notice some display issues, but the game remains playable.

wine660.png


 

wine661.png

We then exit the game and insert the Hellfire extension CD before returning to the Wineskin advanced panel.
As you may have understood, we need to click the "Install Software" button again and choose the setup for the update or extension.

wine670.png


 

wine671.png

If necessary, repeat the process for multiple extensions or updates, and if needed, modify the path to the final executable.

wine680.png


 

wine681.png

Here we have our game along with its extension. Don't forget to modify the Windows version if needed, but also define the CD-ROMs and inserted disks if the program requires them, which is the case for playing Hellfire, specifically the CD of Diablo.

wine690.png

Configuration

What if it doesn't work?

Unfortunately, Wine won't allow you to use all Windows applications. However, Wine is configurable. These advanced parameters allow you to enable or disable certain frameworks or libraries, load character fonts. For example, OpenGL instead of Direct3D.

These options, also sometimes referred to as winetricks, are available in the Tools menu, and some can help improve your application's support.

wine700.png


 

wine701.png

I strongly recommend that you check the dedicated section on the official site and search for your program to see if any parameters need to be applied: https://appdb.winehq.org

Here is an example of essential parameters to make the game Ori work, described on the dedicated page of the Wine site.

wine710.png


 

wine711.png


 

wine712.png

Or that of Path of Exile.

wine720.png


 

wine721.png

 

PlayOnMac


 

wine730.png

This program is a graphical interface for Wine that simplifies installations, manages them on virtual drives, and provides access to many other options and parameters in a simplified way. However, it has not been updated for years and includes an old version of Wine, 1.7.55.

Local Installation

Let's start our first installation with a setup file present on our hard drive by clicking the "install" button represented by a plus sign. This will be Heroine's Quest.

wine740.png

An automatic search via the internet is launched to offer you several aids depending on the program you wish to install.

Since this is a tutorial, we will skip this panel by clicking on "Install an Unlisted Program" at the bottom left.

wine750.png

Skip the first panels and if you don’t want to see them again, remember to check the box at the bottom left.

wine760.png


 

wine761.png

The installation begins and it will largely be manual.

wine770.png

Let’s choose the first option, which will allow us to generate a virtual hard drive and install our program.

wine780.png

Then, give an explicit name to this virtual disk.

wine790.png

Before installation, you will be offered some options such as installing specific libraries like DirectX or other third-party programs, if your executable requires them. Here, we will choose our version of Wine and configure it.

wine800.png


 

wine801.png

If we chose to modify the Wine version, it means the one we compiled and previously installed on our system is more up-to-date than the one included in PlayOnMac.

wine810.png

Since we have not compiled Wine for 64-bit nor installed a 64-bit package available on the official Wine website, and our program does not require such architecture, we will select 32-bit.

wine820.png

To simulate the .NET Framework, you will be prompted to install Mono via the site. This may be mandatory depending on the installed programs (or you will need to install Microsoft’s framework instead).

In our specific case, we proceed.

wine830.png

The creation of the disk is completed.

wine840.png

Once finished, as we decided to configure Wine, a window that you may already be familiar with—if you followed the tutorial from the beginning—appears. It will allow you to manage drives and also the Windows version, as shown above.

wine850.png

After this step, we need to select our installation file.

wine860.png


 

wine861.png

Then we proceed normally.

wine862.png

The installation begins, and we will follow the steps as if we were on Windows.

wine870.png


 

wine871.png

At the end of the installation, PlayOnMac takes over, and will ask you to specify the executable of the program to launch.

wine880.png

It will also ask for the name of the shortcut it will create on your desktop (which I personally remove).

wine890.png

It will again request an executable to launch to create a new shortcut.

Once all the useful executables have been selected one by one, you can indicate that there are no more new ones.

wine891.png

You will then return to the main page of PlayOnMac with your application ready for execution.

wine900.png


 

wine901.png


 

wine902.png

Optical Drive Installation

Let's proceed with the installation via CD-ROM and mount our Dawn of Magic CD. Follow the same steps as before with PlayOnMac.

wine910.png

Choose your Dawn of Magic CD-ROM.

wine911.png

The installation program will then launch automatically.

wine920.png

Once again, specify your executable.

wine921.png

Here is your ready-to-use game.

wine930.png


 

wine931.png


 

wine932.png

Manual Installation

In reality, the most "complicated" thing with PlayOnMac might be creating a virtual disk with a program that doesn’t need to be installed. To do this, we will use the demo of Light Fairytale.

Let's start by opening the control panel where we will find our existing virtual disks and ask to create a new one via the button bearing the same name.

wine940.png


 

wine950.png

The same steps as before follow, with fewer steps this time.

wine960.png


 

wine961.png

Our hard drive is ready; we need to copy our Light Fairytale demo folder onto it. To do this, click on the "Miscellaneous" tab, then click the "Open the virtual disk folder" button. Note the path of this folder for later.

wine970.png

 

wine971.png

In the "Program Files" folder included in the "drive_c" folder, copy the complete demo folder there.

wine980.png

 

wine981.png

Return to the main window of PlayOnMac and perform a new installation, except this time choose the second mode, namely "Modify or update an existing application".

wine990.png


 

wine1000.png

Your disk doesn't appear? Simply click on the checkbox at the bottom left to display it and then select it.

wine1010.png


 

wine1011.png

Continue with the steps one by one as before.

wine1012.png

When the installation or update program is requested, choose notepad.exe.

This is located in the Windows folder of the virtual disk directory you noted earlier.

wine1020.png


 

wine1021.png

Notepad launches, we just need to exit it via the File menu.

wine1030.png

All that remains is to choose your program and launch the game.

wine1040.png


 

wine1041.png


 

wine1042.png

To go further, you will surely notice that the Control Panel allows you to monitor your program under Wine, edit the registry, install components, manage display, etc.

wine1050.png

 

CrossOver


We conclude with CrossOver, whose existence we mention. It is based on Wine and is paid with support and updates. Still, it actively contributes to Wine development. Its usage is similar to PlayOnMac, but unlike the others, CrossOver includes 64-bit builds of Wine.

wine1060.png


In summary

While Wine is an excellent alternative to traditional virtual machines that require a lot of resources, it is not a guaranteed Windows alternative. However, it supports more and more applications. So, if not all programs—especially those relying on certain libraries—are compatible, Wine remains a good free choice. Now it's up to you to enjoy Windows applications on your Macintosh.

wine1070.png


 

wine1080.png

Related software

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum