Changes

{{Infobox consoleemulator|title logo = Apple MacintoshCemu-Logo.png|version = {{CemuVer}}|logo active = Yes|developer platform = [[:AppleEmulators on Windows|AppleWindows]]|type architecture = x86_64|target = [[:Category:ComputersWii U emulators|Home computerWii U]]|release developer = 1984Exzap, Petergov|discontinued website = [http://cemu.info Cemu]|predecessor license = Closed-source freeware|compatibility = [[https:Apple II]//compat.cemu.info Compatibility list]|successor support = [https://www.patreon.com/cemu Patreon]|emulated bios = {{✓}}[[Emulator_Files#Wii_U|Optional]]

The {{Outdated}}'''[[wikipedia:MacintoshCemu|MacintoshCemu]]''' is a family of personal computers designed, manufactured, and sold by Apple Inc. since January 1984. The original Macintosh was the first mass-market personal computer that featured a graphical user interface, builtclosed-in screen, and mouse, eschewing the command-line interface and/or BASIC interpreter that had been the mainstay for home computers since the late '70s. Apple sold the Macintosh alongside its popular source [[Apple II LineWii U emulators|Apple IIWii U emulator]] family of computers for almost ten years before they were discontinued in 1993, Windows. Its development was started circa 2015 and later shortened it's known to be the line to '''Mac''' in 1998very first Wii U emulator ever that can boot games.

Throughout its history the Macintosh comprised three processor architectures that represented the three commonly known generations. From its launch in 1984 up until 1994, Apple sold Macintoshes with the Motorola 68k family of CPUs. In the early 90s, Apple partnered with Motorola and IBM to create the Power architecture, using a CPU brand called PowerPC and naming some models accordingly like Power Mac. They then switched to x86 in 2006, explaining that Power failed to be competitive with Intel's Pentium M series. Macintosh computers have always included a platform-exclusive operating system that never had a consistent name.<ref group=N>It used to be called System or System Software until version 8, when it was renamed Mac OS in 1997. Version 10 was named Mac OS X in 2000, and when version 10.8 was Before updates are publicly released in 2012, it was shortened to OS X and then macOS when version 10.12 was released in 2016. Donthey't try re accessible to make sense of this.<backers over at [https://ref> Old World ROMs used System 1-7, and Mac OS 8 and 9 gradually dropped 68k support in favor of PowerPCwww. When Mac OS X was released in 2001, it required a New World ROMpatreon.<ref group=N>Though that didn't stop some programmers from making bootloaders for the very late Old World ROM models that used PowerPC.<com/ref> Some quick ways to distinguish an Old from a New World ROM is by checking for a built-in floppy drive and/or USB port. Old World ROMs used ADB for keyboard and mouse connectivity, whereas a New World ROM would have a USB port and no floppy drive. Mac OS X, which has different underpinnings from its predecessor, was introduced for PowerPC Macs in 2000 and is still in active development to this day, albeit for x86 (and ARM for its mobile cousin [[iOS emulators|iOS]cemu their Patreon]).

A ton of Macintosh emulators have appeared over the years, some early in the system's release and others as late as a few years ago. Apple has strict terms about how their operating systems are used, which forces most emulators to maintain a macOS port to some degree. It should be noted that we do not aim to be the last word on Mac emulation; there's a community called E-Maculation that covers this more thoroughly, as they offer builds for many of the emulators shown here on their forums. We'll either be further ahead or severely behind. ==Emulators=====68k=Download=={| class="wikitable" style="text-align:center;"|-! scope="col"|Name! scope="col"|Operating System(s)! scope="col"|Latest Version! scope="col"|Active! scopecellpadding="col4"|[[Recommended Emulators|Recommended]]|-|[[Mini vMac]]|Windows, macOS, Linux|[https://www.gryphel.com/c/minivmac/download.html 3.5.8]|{{✓}} ||{{✓}}|-|[[Basilisk II]]|Windows, macOS, Linux|[https://github.com/cebix/macemu 1.0 R5]|{{✓}} ||{{✓}}|-|[[vMac]]|Multi-platform|[http://www.vmac.org/ 0.19]|{{✗}} ||{{✗}}

|[[MAME]]align=center|{{Icon|Windows, macOS, LinuxWin-big}}|'''[httpshttp://wwwcemu.mamedev.orginfo/releaseindex.html {{MAMEVer}}#download Latest public release]|{{✓}} ||{{na|text=TBD}}'''<br/><small>Available one week after the Patreon builds release</small>

;Basilisk II==System requirements==You will also need enough storage for the [[Wii U emulators|Wii U]] games. Running Cemu on [[Wine]] has been reported to work just as well as Windows.===Minimum===* Windows 7 (64-bit)* Graphics Card: Supports at least OpenGL 4.5 or Vulkan 1.1* Memory: 4 GB===Recommended===* Windows 10 (64-bit)* Graphics Card:An emulator targeting Supports OpenGL 4.6 (Vulkan 1.1 for AMD or Intel)* Memory: 8 GB or more ==Game formats and needed files=====Physical dumps===You'll first need to fill in the "Mac Classickeys.txt" file in Cemu's directory. It has a sample line with a bogus key and "Mac II" a comment, which you may as well delete.  Your file must have many lineslike this, one for the Wii U Common Key (D7B00402659BA2ABD2CB0DB27FA2B656), and one line for the Game Key of each game. Sharing these keys isn't exactly safe legally, but ROM sites at least share [http://pastebin.com/GWApZVLa the Game ones]. Note that for games using the Loadiine format, you won't need a Game Key at all, but those will need Cemu versions from 1.4.0 onward. Your ISO must be either uncompressed, compressed using WUD format, or in Loadiine format (only possible for versions 1. The successor 4.0 onward) to Basiliskboot in Cemu. Here's a [http://docs.google.com/spreadsheets/d/19WV2YQvS2PkiHnQTlYP7cE2eHOPl06Rx4tCvfud_Hpw/edit?pref=2&pli=1#gid=0 compatibility list]. Dump your discs using [https://gbatemp.net/threads/wudump-dump-raw-images-from-a-wiiu-game-disc.451736/ Wudump]. ===Digital copies===Cemu supports either physical games dumps in WUD, or compressed WUX format, as well as game dumps converted to the Loadiine format. Loadiine games come as multiple directories with game files and a similar emulator .rpx file. Nintendo's CDN for Linux Wii U and BeOS3DS digital games is rather poorly secured, it works by providing replacement drivers due to a huge oversight when designing the software protection for components that would normally be hardware these consoles. As such, with tickets proving you bought the game (but which you can get through less legit ways), there are downloader utilities like NUSGrabber, FunKiiU, UWizard, or jnus among others, and decryption tools like UWizard and CDecrypt, to obtain a sort functional copy. The process of HLE approachhow to exactly acquire those files is detailed elsewhere on this wiki. Load the .rpx file from [Your gamelocation]/code/[yourgame].rpx with Cemu. ===Updates and DLC===Prior to 1.7.3, only updates were supported though pasting update files on the main game's folders (keeping in mind the main game is in Loadiine format) and overwriting any files. DLC wouldn't work at all through this method, though with some specific games there were workarounds and some could play DLC tracks in Mario Kart 8 through swapping of specific files. From 1.7.3 onwards, proper support for DLC and updates was included in Cemu. The Update installation method has been reworked since 1.11.0 simplifying the installation method a lot.To install updates and DLC on Cemu on (1.11.0)+ versions you need to follow theses steps :  *On Cemu interface, select File -> Install game update or DLC*Select the meta. Aside xml in the meta folder of the update or DLC*Run the game to update the UI and show the update and/or DLC version ===Amiibo support===[[Amiibo]] are hard-to-find figurines unlocking various on-disc content in select 3DS and Wii U games. They use the NFC technology. Nintendo Amiibo data is distributed online as NFC tags (.bin files). There's a regularly updated complete set of the official ones but there are also unofficial spoofed packs on various other sites. Recent versions of Cemu include Amiibo support. Simply go to NFC / Scan NFC Tag from file, and load the usual Windowsrelevant .bin file. Keep in mind Amiibo support in Cemu is incomplete right now and not all figurines are compatible yet - though incompatibilities may be caused by bad Amiibo dumps as well. ==Setting up Cemu=====Controls===Cemu added native support for Wii Remote controllers as of 1.12.0. Cemu cannot connect to a real (or emulated) [[Nintendo 3DS emulators|3DS]]. ===Cemuhook===Using this is completely optional but highly recommended. Without Cemuhook, macOSsome games won't have texts, have laggy cutscenes and display numerous other bugs. Download [http://sshnuke.net/cemuhook/ the latest version] compatible with your Cemu version, unpack it to the same directory as cemu.exe and Linux portsright-click on dbghelp.dll, check Proprieties, Basilisk II Digital Signatures tab, select a signature and press Details. This should make it no longer crash at start-up. Make sure you also received an acclaimed PSP port have the latest GPU driver installed, as well as both x86 and x64 versions of the [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ 2017 X64 Redistributable]. After the first boot of Cemu with cemuhook installed, accept to download the missing shared fonts to make the text in some games (Super Mario Maker among others) display correctly.Whenever you boot Cemu now, this cemuhook tool is enabled by default and offers various additions for better motion control emulation or some graphical hacks that greatly enhance Zelda BOTW in particular.Various way to take advantages of the cemuhook motion control emulation are listed [http://compat.cemu.info/wiki/Motion_Sensing#Full-motion_Solutions here]. Enabling "GX2SetGPUFenceSkip (HACK)" enhances graphical emulation in BOTW in particular. A pre-installed Graphical Pack that comes with recent versions of homebrewCemuhook, "LWZX Crash Workaround", as well as the "GX2DrawDone()" option under Experimental, should help with some general crashes specific to BOTW. As of version 1.18.0, cemuhook is no longer considered required to run the emulator, as all major functions previously provided by cemuhook have been implemented into the emulator itself. ===Shader caches===When your game is loaded, check for its ID on the title bar in front of "SaveDir:" and note it down. The directory where transferable shader caches are stored is <code>.\Cemu\shaderCache\transferable</code>. They're generated the first time you play through a game and at that time cause noticeable stuttering. You can download a complete cache from places like [http://www.reddit.com/r/Cemucaches/comments/7bv7el/complete_shader_cache_collection_1110c_v2/ here] and rename them to match your game version's ID to spare yourself most of that unpleasant experience. Just keep in mind that shader caches from versions older than 1.8.0 are incompatible with later versions of Cemu.

;Mini vMac:The successor to vMacAt startup, an older emulatorCemu will prepare a compiled version of that cache under <code>. Targets the Macintosh Plus\Cemu\shaderCache\precompiled</code> and that one depends on your GPU driver, but is known so you might want to support other modelserase it if any problems or crashes when compiling shaders at startup occur.

;[[Ardi Executor]]==Troubleshooting/speeding up==:An old compatibility layer ===Shader caches===Shaders are normally cached as you play the game. This can cause a lot of stutters and emulatorslow the game down. It used an HLE approach to get applications working However, as opposed to OS emulationof version 1. However19.0, it lacks any kind of networking Cemu added support and is also riddled with compatibility issuesfor Asynchronous Shader Compiling on their Vulkan API which can make shader compiling near instantaneous on modern hardware, so try enabling that before hunting for shader caches.

;[[MAME]]:To say it's a multi-system emulator would Cemu accepts other shader caches that can be an understatementtraded online. It covers 's often very difficult to generate a wide range of electronic historycomplete cache for large games, with its namesake being arcade machines. Just typing in "Macintosh" and will list basically everything Mac-related like the original Macintosh 128K (unfortunately labelled as Not Working) and the Macintosh II (not completely eliminate stuttering, which is OK). [https://github.com/mamedev/mame/blob/0f028a8bd2afcb32ccdab0291eb3a798a98a1afc/src/mame/machine/mac.cpp#L14 See the full list herewhy using Asynchronous Shader Compiling is recommended instead.]

;PCE <small>(PC Emulator)</small>[[File:A multi-system emulatorShadercachestuff. One of the computers it targets is the Macintosh Plus. Stables used to release every two years but stopped png|thumb|Some settings in 2013. A snapshot exists for December 2018 however, which suggests that the project isn't completely deadNvidia control panel might help.]]

===PowerPC==={| class="wikitable" style="text-align:center;"|-! scope="col"|Name! scope="col"|Operating System(s)! scope="col"|Latest Version! scope="col"|Active! scope="col"|[[Recommended Emulators|Recommended]]|-|[[SheepShaver]]|Windows, macOSSome games' transferable caches may cause slowdowns on some graphics cards like the GeForce GTX 970. If this is the case, Linux|[https://github.com/cebix/macemu 2you will have to generate your own shaders and delete the ones you downloaded.4]|{{✓}} ||{{✓}}|-|[[PearPC]]|Windows, macOSIn the case of the GeForce, Linux|[https://github.com/sebastianbiallas/pearpc 0also consider deleting the .6bin and .0]|{{✗}} ||{{✗}}|-|[[Classic Environment]]|Mac OS X toc file in your GLCache at <code>%APPDATA%\NVIDIA\GLCache\(PPChexstring)|Mac OS X v10.4 "Tiger"|{{✗}} ||{{✓}}|-|[[QEMU]]|Windows, macOS, Linux|4.0.0|{{✓}} ||{{na|text=TBD}}|-|[[Rosetta]]|Mac OS X \(Intelhexstring)|Mac OS X 10.6</code>.8 (Intel)|{{✗}} ||{{✓}}|-|}

;SheepShaver==Graphic Packs==:An open-source To work around emulation bugs and other problems the way [[Dolphin]] does, "run-time environmentGraphic Packs" that includes a PowerPC emulator for nonare title-PowerPC systems. Originally commercial software, it is the companion app of Basilisk II, specific property sheets which emulates 68k Macs. It hasn't seen significant development in a while, yet it runs most if define advanced settings you might not all Mac OS applications be able to change in full speed on any Windows PCthe interface. It can interface with Basic rendering options including shadow resolution and copy files to and from host hardwarequality, but suffers from the lack of memory management unit supportpost-processing effects like bloom, not to mention that it is riddled with hacks lighting and workaroundsgod rays, which accounts for why some applications such as the default bundled Internet Explorer flatcustom anti-out crashesaliasing, and such can be applied here. You can only run up even use them to 9''reduce'' the internal resolution for an increase in the framerate.0.4. Like Basilisk and vMacThis is not to be confused with '''Texture Packs''', which are replacement textures; Cemu doesn't support that, but it needs a firmware image from a working Macis planned.

;PearPC:This emulator had been developed since 2004 and marketed itself as a Mac on Windows solutionThe "Graphic Packs" themselves are folders under the <code>graphicPacks</code> directory. HoweverThey can be named anything, it encountered controversy when another team announced but they should contain the closed-source CherryOS, which aimed to do the same thing and was revealed to have used [[source "<code|>rules.txt</code]] from PearPC (violating its license)>" file. PearPC lacks A bare-bones example of a usable interface (all that's available is the "Change CDGraphics Pack", called "Bayo_1080p" button), so using a frontend may be necessary.would look like this:

; [[QEMU]Definition]:Known for its presence as an x86 hypervisor titleIds = 0005000010172600,0005000010172700,000500001011b900,000500001014db00, QEMU emulates a wide range of architectures. In 20150005000010157e00, a Google Summer of Code event brought PowerPC Macintosh support from a curiosity to a possibility and it now supports 0005000010157f00 name = "Bayonetta 1 + 2 - 1080p" [https://docs.google.com/spreadsheets/d/1T0kkk8WpQ-eWBIdxBnXWCfeyClVVLJyXvvF2NED2U6Q/view a specific range of versionsTextureRedefine] as of 2017. Like PearPC, QEMU is run from a shell. width = 1280 height = 720 overwriteWidth = 1920 overwriteHeight = 1080

;Rosetta:Apple's official PowerPC emulator for x86Whenever the titleId matches the current one, Cemu will show the Graphics Pack under Options -based Macs included in Tiger (10> Graphics Pack.4.4). Though it wasnIf you don't included in Snow Leopardknow what the titleId of the game you want is, it was still possible to transfer it from a previous Leopard installcheck the <code>logs. It was removed entirely in OS X Liontxt</code> file. Rosetta uses QuickTransit technology licensed from Transitive Corporation, and works transparently from the end-user, leading Apple to market You can safely delete it as "in the most amazing software you'll never see." as event that it, unlike most emulators, does not have gets too big for a user interface. Rosetta works best on software that isn't system-intensive, such as office applications; games and other software applications which rely on kexts, libraries or certain instructions may not work properly if at all. A compatibility list is available [https://web.archive.org/web/20060208152806/http://guides.macrumors.com/Rosetta_incompatibilities here]text editor to parse.

===x86==='''No Intel Mac emulators exist.''' However, using [https://github.com/DrDonk/unlocker macOS Unlocker for VMware], for The overwriteWidth and overwriteHeight properties used in this example, you can patch VMware products will upscale the game from 720p to run macOS in a virtual machine1080p. [https://github.com/img2tab/okiomov A script] has also emerged that allows one to install macOS Mojave But if the game doesn't have all of its textures in VirtualBox. If you want to run modern macOS software without a Macthe specified resolution, those are your two best options outside of doing they won't be upscaled and could look messy as a Hackintosh/OSx86 setupresult. There In this case, this problem is also seen in some FMVs in the work in progress [[Darling]] [[Compatibility layers|compatibility layer]] for running Intel macOS software on Linuxgame. This project is similar to [[Wine]] but currently only has experimental support for GUI applicationsthe purpose of the TextureRedefine rule.

==Resources==Since 1.13.0, the graphic packs system and interface was overhauled for better use and many bugs when using multiples graphic packs were fixed.*[https://wwwFor 1.emaculation15.com/doku.php '''E-Maculation'''] - This links to their wiki1 and now on, but they also have a forum thatusers can download the community's "super busygraphics packs linked below directly from Cemu user interface and just check the graphics packs they want to enable." They provide setup guides and builds when That update completly removed the need to manage files for the emulators themselves don'tuser.

==Notes==<references group=N See some of the community graphics packs at [http:/>/slashiee.github.io/cemu_graphic_packs/ this page].

<references/> [[Category:ComputersEmulators]][[Category:Console emulators]][[Category:Home console emulators]][[Category:Wii U emulators]][[Category:Windows emulation software]][[Category:Closed-source emulators]]