Translations of this page:Français (Translators, please see Discussion page.)
Installing WineHQ packages
Wineskin, an open source Wine GUI configuration manager for macOS. Wineskin creates a wrapper around Wine in the form of a normal Mac Application. The wrapper can also be used to make a distributable 'port' of software. Odin, a project to run Win32 binaries on OS/2 or convert them to OS/2 native format. The project also provides the Odin32 API. I just got the new MacOS Mojave 10.14.1 (MacBook Air) and tried downloading Warnings at Waverly Academy but had many failed attempts using the (WS8Wine1.3.18) due to mouse lag issues. However after trying the (WS8Wine1.3.34) it worked perfectly! If you have a new Mac operating system I would try that engine first.
Official WineHQ packages of the development and stable branches are available for macOS 10.8 to 10.14 (Wine won't work on macOS Catalina 10.15). Please test these packages and report any bugs at http://bugs.winehq.org.
I’ve even gone as far as editing Winehq macOS sections and asked a mod to pin an information thread and edit another to indicate 10.8 10.14 support only. Unofficial Wineskin and all of its components are 64Bit bar WSGamma due to the lack of source. Wineskin is a user-friendly tool used to make ports of Microsoft Windows software to Apple's macOS/Mac OS X. How Does It Work? As described in the original Wineskin's website: The ports are in the form of normal macOS application bundle wrappers.
Prerequisites:
- XQuartz >= 2.7.7
- Gatekeeper must not be set to block unsigned packages.
Installing:
Both .pkg files and tarball archives are available at https://dl.winehq.org/wine-builds/macosx/download.html.
Installing from a .pkg file is recommended for inexperienced users.
To install from a .pkg file, double-click on the package, and the usual macOS installer wizard should open. The process should be self-explanatory. It is possible to install the package either for all users (needs administrator privileges), or just for your current user. After the installation is finished, you should find an entry 'Wine Staging' or 'Wine Devel' in your Launchpad. By clicking on it, a new Terminal window opens with a short introduction into some important wine commands. You can now directly start wine/winecfg/... from the Terminal, as the PATH variable is set correctly. For user convenience, the package also associates itself with all *.exe files, which means you can run windows executables just by double-clicking on them.
To install from a tarball archive, simply unpack it into any directory. There is no need to set DYLD_* environment variables; all paths are relative, so it should work as long as the directory structure is preserved (you can skip the /usr prefix though using --strip-components 1).
For more information, see https://www.winehq.org/pipermail/wine-devel/2015-December/110990.html and https://www.winehq.org/pipermail/wine-devel/2016-January/111010.html.
Installing Winehq packages using homebrew
Winehq packages can be installed using homebrew
XQuartz can be installed using;
To install wine the following command can be used;
wine-stable, wine-devel or wine-staging packages can be installed using the above example.The advantage of installing via homebrew means wine is available from a standard terminal sessionThe --no-quarantine line to used to above brew adding the quarantine bit
Building Wine
Wineskin Winery Mac
See Building Wine on macOS
Uninstalling Wine
Wineskin Mac Os Catalina
- Remove the source tree and binaries.
Using Homebrew:
Using MacPorts, uninstall the wine package you previously installed:
Replace wine with wine-devel if you installed the development version.
Otherwise and if you used `sudo make install`, revert it:
Then simply delete your local Wine source code directory:
- Clean-up pseudo C: drive and registry entries as well as all programs installed to C:
Wineskin For Mac Os Sur
- Check the hidden directory `$HOME/.local/` where Wine stores some desktop menu entries and icon files as it interoperates with the X.Org Foundation and the Free Desktop.
Note: Files in this directory are unused on macOS unless you use a UNIX window manager and other X11 applications instead of the native MacOS apps.
Third Party Versions
Third party versions of Wine, such as Wineskin, Winebottler, and PlayOnMac, are not supported by WineHQ. If you are using one of those products, please retest in plain Wine before filing bugs, submitting AppDB test reports, or asking for help on the forum or in IRC.