SpeedofMac.comᵝ

Mupen64Plus

Awesome command-line N64 emulator

mupen64plus

Mupen64Plus logo

Mupen64Plus is "a cross-platform plugin-based N64 emulator which is capable of accurately playing many games" (from Mupen64Plus's Google code page).

What does that mean? It means that Mupen64Plus is an excellent Nintendo 64 emulator that works on Mac OS X, Linux, and Windows. Plus, it's free ($0) and open-source. Can you think of a better way to play your favourite N64 games? I sure can't!

This page will help you download and install Mupen64Plus, and show you how you can start playing N64 games on your Mac.

Download Mupen64Plus 1.99.4

To download Mupen64Plus 1.99.4, head over to the Mupen64plus download page.

Click the "mupen64plus-bundle-osx-1.99.4.zip" link to start your download.


If Safari is set to open safe files automatically (see this SpeedofMac QuickTip), the .zip file will automatically unzip a folder called mupen64plus-1.9.9.4-osx. If not, go to your downloads folder and double-click the .zip file to produce the folder.

Select whichever folder matches your system architecture and operating system.

Rename the folder Mupen64Plus and move it to your Applications folder.

Once you've done that, Mupen64Plus 1.99.4 should be successfully installed and ready to go. Now all you need to know how is how to launch games!

Launch a Game

Command line (Terminal) method:

Launching a game using the command line (Terminal.app) really isn't as difficult as it may seem:

Here's a play-by-play of the steps in the video:

  1. Start in the mupen64plus-1.99.4-osx folder (or Mupen64Plus if you renamed and moved it to your Applications folder; skip to step 3 if you did)
  2. Move into the 32-bit or 64-bit folder
  3. Open Terminal.app (I'm using Alfred to launch applications)
  4. Type cd  and drop mupen64plus into the Terminal window to reveal get its path
  5. Add Conents/MacOS to the end of the path (I'm using the tab key to autocomplete these path names)
  6. Optional: Type ls and press return to view the contents of the MacOS folder (this is the list command)
  7. Type ./mupen64plus 
  8. Drag your N64 rom file onto the Terminal window to get its path
  9. Press return
  10. Enjoy!

A few notes on this method:

  • It plays well with rom files and folders that contain spaces
  • It will default to the Rice video plugin. To use another plugin, use one of these commands before dragging your rom into the Terminal window:
    • ./mupen64plus --gfx mupen64plus-video-glide64 
    • ./mupen64plus --gfx mupen64plus-video-arachnoid 
  • It can do all kinds of nifty things, like:
    • Set the window size (resolution) using --res (width)x(height) (replacing those with the appropriate values)
    • Launch in fullscreen mode using --fullscreen or windowed mode using--you guessed it-- --windowed
    • Use cheats (--cheats)
    • And more!

Applescript method:

Another method that's a little more familiar for most people is the Applescript method (developed by Mike, Dav, and me in the comments of this SpeedofMac.com blog post).

This method involves using a separate application made with Applescript to launch your N64 roms using Mupen64Plus. The application we'll be using can do the following:

  • Allow you to choose whether to launch a rom, configure a gamepad, or change Mupen64Plus preferences
  • Allow you to choose the video plugin you want to use
  • Open rom files or folders with spaces (you may need to change $1 to "$1" in the run_(plugin).sh files)

Here's the code:


display dialog "What would you like to do today?" buttons {"Open N64 ROM", "Controller Config", "Mupen64Plus Config"}
copy the result as list to the menuChoice
if the menuChoice is {"Mupen64Plus Config"} then
	do shell script "open -a TextEdit ~/.config/mupen64plus/mupen64plus.cfg"
	return quit
end if

set mypath to path to me
tell application "Finder" to set myFolder to folder of mypath as alias
set myPOSIXFolder to quoted form of (POSIX path of myFolder)
if the menuChoice is {"Open N64 ROM"} then
	
	set romPath to choose file with prompt "Select a rom file to open (.n64, .v64, .z64)" default location myFolder
	set romFile to quoted form of (POSIX path of romPath)
	display dialog "Which plugin would you like to use?" buttons {"Glide", "Rice", "Arach"}
	copy the result as list to the pluginChoice
	tell application "Terminal" to activate
	tell application "System Events" to keystroke "cd " & myPOSIXFolder & return
	tell application "System Events" to keystroke "./run_" & pluginChoice & ".sh " & romFile & return
else if the menuChoice is {"Controller Config"} then
	do shell script "open -a TextEdit " & myPOSIXFolder & "mupen64plus.app/Contents/Resources/InputAutoCfg.ini"
end if
		

To use this, just follow these easy steps:

  1. Open AppleScript Editor.app
  2. Copy the above code into the editor window
  3. Save the file as "Mupen AppleScript Launcher" and select "Application" as the file format to launch the script by double-clicking on it
    • You can save it as an AppleScript file and just run it every time you want to launch a game. This will let you change the code more easily.
  4. Either double-click the application you saved or run the code, and you should be off to the races!

Comments

blog comments powered by Disqus