Mupen64Plus
Mupen64Plus 2.6.0 emulates the Nintendo 64 on Intel Macs running macOS 10.7 or later, with legacy versions and multiple interfaces available depending on the configuration.
Mupen64Plus is a multi-platform Nintendo 64 emulator based on plugins, designed to provide extended compatibility with many games. It relies on four MIPS R4300 CPU emulators, including dynamic recompiler cores for x86 (32/64-bit) and ARM architectures, as well as dedicated plugins for audio, graphical rendering (RDP), the RSP coprocessor, and input handling.
On macOS, it supports Intel-based machines with macOS 10.7 or later versions. The emulator includes two OpenGL video plugins (including RiceVideo), supports advanced features like high-resolution textures, Rumble Pak, cheat devices (GameShark), and a speed adjustment system with smooth audio. Alternative interfaces, such as a command-line front-end or third-party solutions (Qt, Python), can be used for further customization. No official version is confirmed for Apple Silicon or older macOS versions (10.5/10.6).
Last updated:
Platforms
Architecture
Mac OS X - macOS
64-bit
Download and links
- Download Mupen64Plus
- Official website
- Source code 1 572 GitHub stars
- License : GPL-2.0-or-later
- Command copied to the clipboard.
- Homebrew page
Version history
2.6.0
- Ajout d’un bundle précompilé pour macOS 64-bit incluant les modules principaux (core, audio SDL, entrée SDL, RSP HLE, vidéo Glide64mk2/Rice).
- Utilisation exclusive du Dynarec Hacktarux/Richard42 pour tous les bundles, y compris macOS.
- Front-end console en ligne de commande inclus par défaut (pas d’interface graphique native).
- Mise à disposition de plugins tiers pour interfaces graphiques via un lien externe dédié.
After 5 long years and a worldwide pandemic, a new tag and release of Mupen64Plus has been made!
Pre-built binary bundles for the following platforms are available here for your download:
Linux 64-bit Windows 64-bit Macintosh OSX 64-bit Source Code Only
The Windows packages were built with Microsoft Visual Studio 2019, and you may need to install the Microsoft redistributable package for this version of Visual Studio, if your operating system is too old.
All binary bundles were built with the Old (Hacktarux/Richard42) Dynarec.
Each bundle contains the following modules:
- mupen64plus-core
- mupen64plus-audio-sdl
- mupen64plus-input-sdl
- mupen64plus-rsp-hle
- mupen64plus-video-glide64mk2
- mupen64plus-video-rice
- mupen64plus-ui-console
Note that this bundle includes the 'ui-console' front-end application, which is command-line only. For GUI front-end applications and other plugins, see:
http://mupen64plus.org/wiki/index.php?title=ThirdPartyPlugins
2.5.9
- Version bêta exigeant des tests utilisateurs et des retours pour stabilisation avant une sortie stable prévue sous 2.6.
- Bundles précompilés disponibles pour macOS 64-bit incluant tous les modules nécessaires (audio, entrée, vidéo, etc.).
- Front-end intégré limité à une interface en ligne de commande (ui-console), sans support pour les interfaces graphiques tierces.
- Utilisation exclusive du Dynarec Hacktarux/Richard42 pour les builds macOS, Linux et Windows 32-bit.
This is a Beta release of Mupen64Plus. Please help us by testing this software on your platform and reporting bugs to our IRC channel, or Google Group, or Emutalk Forum. There have been so many changes since the last release (in 2015), that we decided to make this BETA release and only accept pull requests for bug fixes during the next month or two. Then we will make a stable 2.6 release.
Pre-built binary bundles for the following platforms are available here for your download:
Linux 32-bit Linux 64-bit Windows 32-bit Macintosh OSX 64-bit Source Code Only
The Windows packages were built with Microsoft Visual Studio 2013, and you may need to install the Microsoft redistributable package for this version of Visual Studio, if your operating system is too old.
The Windows bundle was built with the New (Ari64) Dynarec, while all others were built with the Old (Hacktarux/Richard42) Dynarec.
Each bundle contains the following modules:
- mupen64plus-core
- mupen64plus-audio-sdl
- mupen64plus-input-sdl
- mupen64plus-rsp-hle
- mupen64plus-video-glide64mk2
- mupen64plus-video-rice
- mupen64plus-ui-console
Note that this bundle includes the 'ui-console' front-end application, which is command-line only. For GUI front-end applications and other plugins, see:
2.5
- Ajout de bundles précompilés pour Linux 32/64 bits, Windows 32 bits (avec et sans New Dynarec), et macOS 64 bits.
- Publication d’un build Windows 32 bits incluant le New Dynarec, plus rapide mais potentiellement instable (artéfacts, plantages).
- Correction d’incompatibilité sur Ubuntu avec une version obsolète de LibPNG, via un bundle dédié compilé avec SDL 1.2 et LibPNG 1.2.
- Inclusion systématique des modules core, audio-sdl, input-sdl, rsp-hle, video-glide64mk2, video-rice et de l’interface ui-console (CLI uniquement).
Pre-built binary bundles for the following platforms are available here for your download:
Linux 32-bit Linux 64-bit Linux 64-bit Ubuntu version Windows 32-bit Windows 32-bit with New Dynarec Macintosh OSX 64-bit Source Code Only
The Windows packages were built with Microsoft Visual Studio 2013, and you may need to install the Microsoft redistributable package for this version of Visual Studio, if your operating system is too old.
The New Dynarec is much faster than our original one, but it is not as well tested and may contain defects which cause bugs in game playback, graphical artifacts, or crashes. For Windows users whose computers are not fast enough to play games well with the standard build, you may try out the New Dynarec build.
The Ubuntu Linux distribution still uses an older version of LibPNG which is no longer used with most other distributions. For this reason, I have built a special binary bundle for use with Ubuntu Linux. This package is built against SDL 1.2 and LibPNG 1.2, so it should run on nearly all Ubuntu versions.
Each bundle contains the following modules:
- mupen64plus-core
- mupen64plus-audio-sdl
- mupen64plus-input-sdl
- mupen64plus-rsp-hle
- mupen64plus-video-glide64mk2
- mupen64plus-video-rice
- mupen64plus-ui-console
Note that this bundle includes the 'ui-console' front-end application, which is command-line only. For GUI front-end applications and other plugins, see:
1.99.3
- Ajout de la fonctionnalité ConfigGetParameterType() pour consulter le type des paramètres de configuration.
- Limite relevée à 1000 captures d’écran par ROM au lieu de 100.
- Support intégré des codes de triche pour le Gameshark 3.3.
- Correction : activation par défaut du Dynarec si le cœur le supporte, sinon bascule vers l’interprète en cache.
- Correction des séparateurs de chemins dans le gestionnaire de dossiers de captures (compatibilité multiplateforme).
- Correction d’un bug spécifique à macOS : ajout de tirets bas avant les noms de symboles en assembleur 64 bits.
- Correction d’un plantage ancien lié aux ROM sans EEPROM de 16 Ko après en avoir chargé une avec.
- Correction d’une corruption mémoire provoquée par la fonctionnalité de rumble.
- New feature: configuration function ConfigGetParameterType()
- New feature: up to 1000 screenshots per ROM are allowed
- New feature: support for Gameshark 3.3 patch codes
- Bugfix: Use Dynarec by default when core supports it. If dynarec is selected but unavailable, fall back to cached interpreter
- Bugfix: screenshot directory handling code used unix-specific path separators; now is platform-independent
- Bugfix: #313 - 64-bit inline assembly code in r4300/x86_64/rjump.c needs to have underscores before the symbols names in OSX
- Bugfix: old bug in the core - hang if a ROM without a 16kb EEPROM type is loaded after a ROM with a 16kb EEPROM type
- Bugfix: rumble feature caused memory corruption
- Bugfix: Problem with zilmar API: the plugin RomOpen() functions had no way of returning errors to the core, causing crashes
- Replaced api documentation .tar.gz file with the mediawiki text
- Build script improvements:
- new feature: m64p_update.sh script can take an input argument to update to a tag or revision
- new feature: added bash script for building source packages of individual modules
- Makefile improvements:
- dont run ldconfig on make install unless user is root
- added OS type GNU/kFreeBSD
1.99.2
- Suppression des messages d'erreur redondants dans la console pour les fichiers de mémoire et EEPROM introuvables.
- Amélioration des fichiers Make : vérification du support OS/CPU avant compilation et utilisation de DESTDIR pour les chemins d'installation.
- Compatibilité étendue avec MSVC8 pour le projet mupen64plus-core et refactoring du code.
- Flexibilité accrue dans les chemins de compilation via variables personnalisables (CC, CXX, LD).
- Installation des fichiers d'en-tête du Core pour permettre la construction ultérieure des plugins.
- doc: added tarball of emuwiki api documentation from 2010-01-06 for backup purposes
- clean-up: removed almost all of the ifdef WIN32 statements
- bugfix: stop spamming console with "Core: couldn't open memory pack file '...' for reading" messages
- bugfix: stop spamming console with "Core: couldn't open eeprom file '...' for reading" messages
- new feature: MSVC8 project file for mupen64plus-core, refactored code for VC8 compatibility
- Makefile improvements:
- throw error if OS/CPU not supported
- use DESTDIR in install/uninstall paths
- Allow user-specified CC/CXX/LD paths
- makefile needs to install Core header files so that plugins can be built later
1.99.1
- Ajout du support des codes cheat et des raccourcis clavier personnalisables pour les commandes du noyau.
- Intégration native de la sauvegarde/chargement des états PJ64 et simplification de l’architecture globale (portabilité, gestion unifiée des fichiers de config).
- Correction des problèmes d’avancement par cadre (fixe le décalage vertical) et de mouvements diagonaux du stick.
- Résolution des bugs critiques liés à l’événement joystick (hystérésis, gestion des appuis GameShark, commandes edge-triggered).
- Correction des erreurs de conversion des registres FPU entre modes 32/64 bits (impactant Banjo-Tooie).
- Suppression des dépendances inutiles et refonte du système de build pour améliorer la portabilité.
New 2.0 architecture advantages:
- Simplified emulator Core, making it much more portable
- Removed all GUI code from plugins, making them simpler and more portable
- User interface development is not tied to Core emulator releases
- All messages from core/plugins can be filtered and shown in GUI instead of only on console
- Video Extension allows Front-end to override some video functions, ie to support embedded render window
- Startup in Fullscreen mode, instead of always starting in windowed mode and switching to FS after few seconds
- video resolution can be given via command-line parameter
- all configuration options for core and plugins are in a single config file, can be configured with a single GUI
- dummy plugins are automatically used if plugin loading fails for any reason
- core and plugins all use the same conventions for where to put data/config files
Mupen64Plus core:
- New feature: cheat code support
- New feature: Keyboard shortcuts for Core commands are now user-configurable
- New feature: can load/save PJ64 state files
- Major code cleanup, refactored build system to separate source and object files
- Removed many dependencies to simplify porting to other platforms
- Moved all of the SDL event-related stuff into a new source file eventloop.c
- Use XDG directory convention for file locations on Unix
- bugfix: frame advance feature should advance every frame, instead of every vertical interrupt (every field)
- bugfix: allow diagonal hat movements for core joystick commands
- bugfix: modified SDL event loop joystick code so that gameshark button press is captured, and joystick commands that are level-triggered instead of edge-triggered (such as fast foward) can be accommodated
- bugfix: fixed the outstanding SDL event issues by re-writing the code which handles the joystick-event-driven core commands. Now the axis-based commands use hysteresis and there is a single global event function for determining if the gameshark button is pressed
- bugfix: OSD crash after pause-stop-start-pause of emulator
- bugfix: Set video width and status, aiDacrate during savestate load
- bugfix: in pure interpreter, Dont allow to override r0 register
- bugfix #52: PJ64 load state patch from olejl77
- bugfix #268: use aligned malloc and mprotect to set executable status for dynarec emitted code
- bugfix #51: Floating Point Register data was not correctly converted when switching between 32-bit (MIPS-I) mode and 64-bit (MIPS III). New code more closely emulates behavior of r4300 hardware. Fixes collision problems in Banjo-Tooie
- bugfix #272: rounding mode for x86 FPU not being set correctly in interpreter and pure interpreter cores
- bugfix: many games need different ScreenUpdateSetting to work properly with Rice Video
2.0
- Ajout d’un recompilateur dynamique Ari64 compatible avec les architectures x86 (32 bits) et ARM.
- Détection automatique du type de sauvegarde (Mupen64Plus ou PJ64) lors du chargement depuis un slot.
- Prise en charge de la redimensionnement de la fenêtre vidéo (selon le plugin vidéo et l’interface frontale).
- Nettoyage du code du débogueur et du cœur (core) pour améliorer la stabilité.
- Support de la construction avec SDL2 pour une meilleure compatibilité logicielle.
- Fixes for various games (DK64, Zelda, Blast Corps)
- add Ari64's dynamic recompiler for x86 (32-bit) and ARM
- improved PJ64 savestate loading
- support video window resizing (with help from video plugin and front-end application)
- Auto-detect savestate type (Mupen64Plus or PJ64) when loading from a slot
- many various code cleanups in core from casualjames
- support to build against SDL2
- debugger code cleanup
- Project files for Visual Studio 2012
- Makefile changes
- add support for PowerPC and MinGW32 builds
- add cross-compiling support to build Win32 executables (MXE) under Linux
1.99.5
- Ajout du support de l’horloge interne temps réel du N64 et remplacement de l’algorithme PIF-CIC par celui de X-Scale.
- Configuration séparée pour les fichiers SRAM/EEPROM/MPK, avec paramètre dédié pour éviter leur mélange avec les snapshots.
- Correction de l’affichage du texte OnScreenDisplay dans les captures d’écran et sous macOS.
- Gestion correcte du chemin de sauvegarde des états (SaveStatePath) depuis le fichier de configuration.
- Résolution d’un plantage lié à un problème de permissions sur le répertoire utilisateur sous Linux.
- New feature: support for N64 internal real-time clock
- use X-Scale's PIF-CIC algorithm instead of the hard-coded challenge-response pairs
- New config parameter for path to save SRAM/EEPROM/MPK files, so they can be separated from emulator snapshots
- updated core for new Mupen64plus 2.0 API versioning scheme
- split core configuration data into 2 sections: Core and CoreEvents. Added version numbers and upgrade handling to both
- Accurately emulate the RSP DMA operation (from Bobby Smiles)
- bugfix: #290 - OnScreenDisplay text is sometimes captured in screenshots
- bugfix: when the front-end specifies an override for the configuration directory, always use this path, so that we don't load the config from there and then save it back to the default user path
- bugfix: #468 - On-screen-display problem under OSX
- bugfix: Use option SaveStatePath from config file
- bugfix: don't call SDL_Quit() until the core library is being unloaded. fixes some front-end use cases
- bugfix: #410 - segfault in dma_pi_write()-->strlen() if /home/username/.local/share/mupen64plus/ owned by root
- bugfix: for Interpreter cores, use proper math functions for ceil/floor/round/trunc instead of x87 rounding modes
- many makefile fixes and improvements
1.99.4
- Ajout d’un contrôle de type dans ConfigGetParameter() et d’un nouveau type d’erreur pour renforcer la robustesse des paramètres de configuration.
- Correction d’un plantage (segfault) dans le code des extensions vidéo si l’initialisation de SDL échoue à cause d’un plugin vidéo défaillant.
- Introduction de la fonction CoreGetRomSettings() pour permettre aux interfaces frontales d’accéder aux paramètres du ROM.
- Activation du dynarec (Dynamic Recompiler) dans les fenêtres protégées par le module DEP (Data Execution Prevention) du matériel.
- Acceptation par le parseur de fichiers .cfg des chaînes de caractères sans guillemets autour, simplifiant leur syntaxe.
- Changement d’API : utilisation obligatoire de la nouvelle fonction ReadScreen2() pour les plugins vidéo, remplaçant l’ancienne méthode.
- Mise à disposition d’un nouveau désassembleur réentrant pour le processeur R4300 (architecture MIPS), développé par tty68k/zzt32.
- Added some type checking to ConfigGetParameter() function, and a new error type
- Bugfix: avoid segfault in the video extension code if SDL initialization fails (because video plugin fails)
- Added new CoreGetRomSettings() function for front-ends
- Allow to run dynarec in hardware DEP protected windows
- Allow core .cfg parser to accept strings without quotes around them
- API change: use new ReadScreen2() video plugin function
- New re-entrant R4300 disassembler, from tty68k/zzt32, a man who loves MIPS processors
- makefile fixes and improvements, code cleanups
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.