1. Wine For Mac
2. Wine Emulator For Mac

• Can't see Worms 2 intro films as they play (mciavi32 missing support to MCI_MCIAVI_PLAY_FULLSCREEN)
• No keyboard response in Super Mario 3 remake
• Regedit randomly crashes when deleting registry keys
• Shiva Editor/Evochron: Mercenary refuse to run with built-in dinput/dinput8.dll
• FileAlyzer 1.6.0.4, Affinity-installer-1.6.5.123 can't load PE images (needs imagehlp.ImageLoad and imagehlp.ImageUnload implementation)
• URLDownloadToFileW does not support FTP URLs
• LabChart Reader 7.x crashes due to missing wmvcore 'IWMProfileManager2', CLSID '{7a924e51-73c1-494d-8019-23d37ed9b89a}'
• Warframe (Steam) updater fails to replace 'Launcher.exe', reports sharing violation
• Face Noir demo crashes on start without native d3dx9_36 ('D3DXLoadSkinMeshFromXof' must return 'ID3DXSkinInfo' interface even with no skinning info present)
• Rogue Squadron 3D 1.3: Unable to setup controller in-game
• wine-mono does not appear in 'wine uninstaller' list on a 64-bit prefix
• GOG.com downloader (.NET 3.5 app) wants wininet.GetUrlCacheConfigInfoA/W implementation
• Settlers III: mouse not working on start screen and menu (after fixing raw input bug 33479)
• Mass Effect (1) Steam freezes since Steam Update from 8th of July 2017
• Older directx games (The Sims, Revenant) - Screen not redrawing properly (needs Set/GetClipStatus implementation)
• Office 2007/2010 32bit - links not working
• Inno Setup v5.x based game-installers using 'wintb' plugin fail with: 'Runtime error 229 at ' (Win7+ ITaskbarList3 ThumbBar/Thumbnail semi-stubs needed)
• Multiple games and applications crash in dwrite due to invalid index access to cluster array (Rekordbox 5.3.0, SpellForce 3)
• Microsoft Office 365 applications crash on startup (Microsoft AppV ISV virtual filesystem technology requires several native and core API to be hot-patchable)
• Aruba digital signature crashes on missing hid.dll.HidD_FlushQueue
• Multiple NSIS 2.x based installers fail due to invalid module handle passed to 'kernel32.FreeLibrary', causing code dll unmapped as data dll (Adobe Digital Editions 4.5.x, ConceptDraw Office 4)
• Cursor in unity games moving down and to the right one pixel on any mouse interaction
• Windows PowerShell Core 6.2 Preview 2 for ARM32 crashes due to unhandled trap_no 0 (write watch access causes SIGSEGV)
• Windows PowerShell Core 6.2 Preview 2 for ARM32 crashes due to ntdll 'set_cpu_context' not restoring Thumb mode during return from exception handling
• Hauppauge Capture version 36187 crashes during install
• FFXI + Ashita random crash ingame
• F.E.A.R. 2: Project Origin screen is completely light grey while playing intro movie
• UPlay fails to start : 'Error at hooking API LoadStringA' (UPlay's hooking engine can't handle ENDBR32 instruction inserted at non-hotpatch API entries due to distro build environments '-fcf-protection')
• Eventide H9 Control crashes on unimplemented function bthprops.cpl.BluetoothFindDeviceClose
• Since 3.3 other HID devices than Joysticks not supported anymore
• Atelier Firis config tool crashes with 'Unhandled page fault on execute access'
• School days HQ occasional divide by zero
• Two quotes together (in outer quotes) not parsed correctly in argv
• Multiple application installers fail in VBscripts due to IWshEnvironment::Item property returning BSTR with embedded null terminator (PostgreSQL 9.3)
• BigNox VM VirtualBox Support Driver 'YSDrv.sys' (part of NoxPlayer 6.x) crashes on unimplemented function ntoskrnl.exe.MmBuildMdlForNonPagedPool
• Creo Elements/Direct Modeling Express 6.0 installer fails with VBScript parser error: parser_lex '_' not followed by newline
• LINE (Powered by Naver): LINE v5.12.XXX series crashes after few seconds
• The Sims hangs when opening menus
• Inquisitor: black screen after start in fullscreen mode
• PS4 Remote Play installer 2.8.x fails, claims 'You need the Media Feature Pack' (MsiGetDatabaseState is called from a custom action)
• Freelancer: character glitches in cutscenes after loading a saved game
• PTC Mathcad Prime 3.0 Web installer crashes on unimplemented function api-ms-win-crt-convert-l1-1-0.dll.wctrans
• If prefix contains 'windows' drive information not available in 64-bit prefix
• Power World Simulator installer needs unimplemented function msi.dll.MsiSourceListForceResolutionW
• SIMATIC WinCC V15.1 Runtime installer (.NET 4.0) fails in CoreLib::GetPhysicalMemoryAmountWmi() (missing 'DeviceLocator' property of 'Win32_PhysicalMemory' WMI class)
• SIMATIC WinCC V15.1 Runtime installer (.NET 4.0) fails due to missing 'OperatingSystemSKU' property of 'Win32_OperatingSystem' WMI class
• SIMATIC WinCC V15.1 Runtime installer: user can't accept license terms (richedit20 ITextRange::ScrollIntoView lacks handling of 'tomEnd')
• SIMATIC WinCC V15.1 Runtime installer: S7Inst64.exe sub-installer crashes on unimplemented function msvcr110.dll._wcsnset_s
• SIMATIC WinCC V15.1 Runtime installer: AdHocSigner.exe tool crashes on unimplemented functions mssign32.dll.SignerSignEx and SignerFreeSignerContext
• SIMATIC WinCC V15.1 Runtime installer: SeCon tool 'SeCon_Win32.exe' crashes due to hnetcfg 'INetFwRules::get__NewEnum' not initializing out parameter
• Support msvcp mtx_init 'mtx_try' flag (0x2) to create a mutex object that supports test and return
• Missing (black) textures in Black & White
• X-Tension, X-Beyond The Frontier: Dynamic light breaks after opening up a menu
• Atelier Firis config tool doesn't show up when launched through Steam
• propvarutil.h: missing extern 'C'
• Watch_Dogs crashes after intro
• Multiple Steam games crash with Wine 4.6 (Steam Game Overlay Renderer hook engine requires several API to be hot-patchable) (Sniper Elite V2, Sniper Elite 3, Brawlhalla)
• Grand Prix Legends: Wheel (Wheel, Gas, Brake) axes inputs aren't recognized
• Improvements to the 7.1 and 5.1 to stereo conversion
• msi x64 installation file created by Visual Studio cannot be uninstalled
• Multiple performance monitor applications fail to display system physical/committed virtual memory usage (Sysinternals Process Explorer v16.x, builtin Taskmgr)
• widl generates invalid typelib when importing types from multiple typelibs
• Microsoft Excel 2016 (Office 365) crashes on startup (Microsoft AppV ISV virtual filesystem technology requires kernel32.CreateActCtxW to be hot-patchable)
• Vocaloid 5 (.NET 4.x app) crashes on startup (needs 'Win32_OperatingSystem' WMI class 'SystemDrive' property)
• Grand Prix Legends: Only the first two axes are recognized
• compile error: ‘for’ loop initial declarations are only allowed in C99 mode

What is Wine? Wine (originally an acronym for 'Wine Is Not an Emulator') is a compatibility layer capable of running Windows applications on several POSIX-compliant operating systems, such as Linux, macOS, & BSD. Open the downloaded DMG file. Drag and drop both Wine and WineBottler applications to your Applications folder to install them, just like you would any other Mac application. You can then launch WineBottler from your Applications folder. WineBottler lists a number of different programs you can easily install.

Translations of this page:Français (Translators, please see Discussion page.)

• You'll see Wine.app Downloads if you scroll down that page past WineBottler. Choose the version most compatible with your macOS system. The way it works is simple: Double-click a Windows.EXE and macOS attempts to open it inside the Wine.app. If that fails, then try WineBottler, which is more convoluted to use.
• 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. Wine-staging GitHub repository.
• Use the MAC Download button on the product page to download the zipped S & S application Wineskin Wrapper to the Download folder on your MAC. For example, if you are installing SewWhat-Pro, the zipped wrapper file will be named Wineskin-SewWhat-Pro.app.zip. Unzip it and run it to install the product.
• Wine has been a long-standing open source software. It is highly popular because it aims to allow the computer programs that have been developed for Microsoft Windows to run on Mac and other Unix-based systems.
• PlayOnMac is a Wine-based software for easy installation of Windows applications on Mac OS. PlayOnMac Installation To install PlayOnMac, open the product's official web site, move to Downloads section and click the link for downloading the latest version.

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.

Wine For Mac

Prerequisites:

1. XQuartz >= 2.7.7
2. Gatekeeper must not be set to block unsigned packages.

Wine Emulator For Mac

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.

Building Wine

See Building Wine on macOS

Uninstalling Wine

• Remove the source tree and binaries.

Using Homebrew:

Download apache maven. It is strongly recommended to use the latest release version of Apache Maven to take advantage of newest features and bug fixes. If you still want to use an old version you can find more information in the Maven Releases History and can download files from the archives for versions 3.0.4+ and legacy archives for earlier releases.

Using MacPorts, uninstall the wine package you previously installed:

Replace wine with wine-devel if you installed the development version. Dmg engineering australia.

Using Fink:

Replace wine with wine-dev 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