Translations of this page:Français (Translators, please see Discussion page.)
Installing WineHQ packages
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.
Prerequisites:
Linux/macOS; The game root folder is where the game executable is located. On Linux, the game root folder is where the executable.x86 or.x8664 is located. On macOS, the root folder is where the game.app is located. Support for Electric Quilt products. Help articles, lessons, and tutorial videos. Linux Shout published a tutorial about installing the latest version of Wine on Linux mint.How to install Wine HQ for Linux mint latest version Tutorial to install Wine and WineTricks GUI for Linux Mint distro to run various popular Windows 10, 7 or XP applications and softwareHow to install Wine HQ for Linux mint. This popup tells the user to install Wine, and points them to the Linux Support page, even though the Launcher is running on Mac. If a shell script is specified in execs.json as an alternative to a batch script, the Launcher will attempt to launch the shell script defined for Linux, even if a different shell script is defined for Darwin (MacOS). Install Terminal on Mac OS. The client terminal can be installed and run on computers with Mac OS using Wine. Wine is a free software that allows users of the Unix-based systems to run an application developed for the Microsoft Windows systems.
- 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
See Building Wine on macOS
Uninstalling Wine
- 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:
- 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.
See Also
Translations of this page:简体中文Nederlands
Supported Wine
CrossOver is a polished version of Wine provided by CodeWeavers. CrossOver makes it easier to use Wine and CodeWeavers provides excellent technical support to its users. All purchases of CrossOver are used to directly fund the developers working on Wine. So CrossOver is both a great way to get support in using Wine and to support the Wine Project. CodeWeavers provides fully functional trial versions of CrossOver. |
Wine Binary Packages
WineHQ Binary Packages | ||
These packages are built and supported by WineHQ. Please report any problems with them in WineHQ's bugzilla. |
Android - WineHQ binary packages for Android | Maintainer:Alexandre Julliard |
Ubuntu - WineHQ binary packages for Ubuntu 18.04, 20.04, and 20.10 Debian - WineHQ binary packages for Debian Buster and Bullseye | Maintainers:Rosanne DiMesio,
|
macOS - WineHQ binary packages for macOS 10.8 through 10.14 | Maintainer: none |
Distro Binary Packages | ||
These packages are built and supported by the distros. Please report any problems with them to the package maintainer. |
SUSE - release binary and source .rpms and daily snapshot RPMs for all openSUSE versions (Leap and Tumbleweed) and SUSE Linux Enterprise 12 and 15 | Maintainer:Marcus Meissner |
Slackware - binary txz (Slackware 14.2), and tgz (for older versions) | Maintainer:Simone Giustetti |
FreeBSD - source for FreeBSD 5.3 or later | Maintainer:Gerald Pfeifer |
3rd Party Tools
Sometimes a customization of Wine can cause an application to work, but this change cannot be incorporated into Wine for some reason. To help overcome current deficiencies in Wine, various third party applications for end users have been made over the years. These applications are entirely unsupported by the Wine developers, however you may find them useful. For more information, see our wiki page on Third Party Applications.
Wine Source Downloads
WineHQ download server - our official source release site.
Git - instructions for building Wine from git.
ibiblio.org - alternative download site for the official source and documentation tarballs.
See Building Wine for help on configuring and building Wine.