Guide for MacMAME
Please note that this translation dates back to 2002; some features, such as the folder now being located in the user's Documents folder, have been slightly modified, removed, or added. Additionally, MacMAME is no longer supported and has been replaced by other MAME ports for Mac.
Ported by: John Butler, Aaron Giles, Brad Oliver
Translated from English by Thomas Dury (syndicman@mac-emu.net), except for sections "III.F. Controls" and "IV. Questions and Answers," which were mostly translated by Marc Vielfaure (marcv@dunet.com).
note: Marc Vielfaure is the translator of MacMAME (excellent French version)
Table of Contents
I. Introduction
Many people ask what MacMAME is and how it works. Simply put, it is an emulator whose sole purpose is to emulate the internal workings of arcade cabinets. It achieves this by deceiving the original program's source code, contained in electronic chips called ROMs, into believing they are running in the actual machine when in fact they are running on your Mac. MAME, which stands for Multi-Arcade Machine Emulator, is the product of a group of people who have joined forces to emulate as many games as possible. It is an open-source project with available source code. This is done in the hope that, over the years, no matter what computer you have, you will always be able to find a copy of MAME to play with, thus keeping classic games alive forever. It is a constantly evolving program, and things are often changed or added, so stay updated.
II. Quick Start
This section describes how to access MacMAME as quickly as possible.
If you encounter any issues, I recommend reading the Section III, "General Usage" to see what each option does.- Download MacMAME from the official website http://www.macmame.org (dead link) (dead link).
- Extract it using Stuffit Expander if your browser doesn’t do it automatically. You can get Stuffit here http://www.aladdinsys.com
- Find the ROM files to use with MacMAME. You will find ROMs online.
- Most of the ROMs you find are in .zip format – you must NOT unzip them. Place these .zip files in the "Roms" folder that was created when you extracted MacMAME.
- Double-click the MacMAME icon. All the ROMs you placed in the "Roms" folder will appear in the dialog box. Select one and click Play; you're ready!
- Once you click Play, a screen will appear telling you who worked on emulating this game. Press any key to enter the game.
- Some games will start a test and display a "bric à brac" on screen. This is normal and what you would see if you plugged in the real machine right after turning it on in the arcade. Wait for these tests to finish.
- You are now in the arcade, ready to insert coins. Press TAB to access the menu that allows you to configure the keyboard and press Return. Here you can see and configure the keys for each game. Press ESC to return to the game and start playing!
III. General Usage
This section provides a detailed overview of MacMAME's options and features and how they affect what you see on screen. Assuming you have MacOS 8 and/or Appearance Manager, you will see the main window: (ndt: ATTENTION: this screenshot is from a newer version than the one described on this page) If you are using System 7, or an older version of MacOS 8, you must download Appearance Manager 1.0.2. Not only will this work on your machine, but you will be able to use the full power of the main window.
On the left, you'll find the list of MacMAME games found in the "ROMs" folder and compatible with MAME. Unsupported games or those with incorrect filenames are removed. Correct filenames are listed in the "readme.txt" file located in the "Documentation" folder. Most of the options mentioned below have equivalents in the menu bar, so I won’t cover the menu options here.
- A. Video
On the right, there are 4 tabs, the first one is called "Video." Let’s look at the options.- Fullscreen: This checkbox determines whether MacMAME will run in a window or hide the desktop and menu bar. It’s purely cosmetic, but I find fullscreen mode less distracting and offers greater immersion.
- Automatic Frames Per Second: You can achieve better performance in some games by letting MacMAME handle increasing or decreasing the frames per second to maintain emulation quality. This option will adjust the frames per second (above 5) to run the emulation as close to 100% as possible. Display sizes:
- Nominal Size: This means each pixel in the game corresponds to one pixel on your Mac’s screen. Many games have a resolution of only 256x256, which is quite small by today’s standards. Since the screen is smaller, this mode is faster.
- Size x2: For each original pixel, four are displayed on your Mac’s screen, effectively doubling the screen size. This mode works well at 640x480, especially at 800x600.
- Size x2, Interlaced: Every other vertical line is not displayed, giving the "interlaced" effect that was present on original machines with poor-quality TV monitors. Less information is displayed on screen, so this mode is slightly faster than Size x2.
- Size x3: The image is three times larger than the original.
- Size x3, Interlaced: The image is three times larger than the original. Every third row is not displayed, giving a slight interlaced effect.
If you have a large screen or one that supports high resolutions (1024x768 or higher), this option will give you the best visual quality and most realistic experience at the expense of speed.
The second tab is called Audio. Here is the breakdown of the available options.
- Sound: Checking this box tells MacMAME to emulate sound chips and audio CPUs in certain games. Most of the time, you will prefer to leave these enabled. Some games will run noticeably faster if this box is unchecked, particularly those with a dedicated second CPU solely for sound. For example, play Donkey Kong with the box checked and unchecked, and you will notice that the speed is significantly higher when the audio CPU is not emulated. The downside is that some games require audio emulation to function correctly. Try experimenting if speed is an issue for you.
- FM Emulation: Checking this box tells MacMAME to emulate specialized chips for generating FM sound. These chips produce advanced sound effects for certain games, but they can consume a lot of your processor's power. If you have speed issues with certain games, you can try unchecking the box to see if it helps. For example, Rastan uses FM sounds for its music. Unchecking the box can speed up the game.
- Use 16-bit audio: 16-bit audio produces better sound quality, but at the cost of a bit of speed.
- Sample rate: You can choose from three sample rates, from poor to good quality: 11025 Hz, 22050 Hz, and 44100 Hz. Like 16-bit audio, quality comes at the expense of speed. Choose the one that works best for you.
- Volume: This represents the volume used by MacMAME. It is completely independent of your Mac's system volume, so keep that in mind. Changing the system volume will not affect MacMAME and vice versa.
- Ignore Other Applications: You will usually keep this checked. This allows MacMAME to take as much CPU time as possible to run as fast as possible. As a result, if you run games in a window, you will notice that the clock in the menu bar no longer updates while you play. MacMAME cannot hog the CPU that much, so if you are connected to a network or the internet while playing, it will run slower than if you were disconnected. This option is also referred to as "Seize Processor" in the options menu.
- Nominal Speed: When this option is checked, MacMAME keeps the game speed at 100%. Unchecking it will allow you to play certain games faster, depending on your Mac's speed. It's a real experience to play Pac-Man at 300%. You will leave this option enabled unless you want to brag about your Mac's speed in front of PC users.
- Load/Save Replay: MacMAME supports creating "replay" files, which are essentially recordings of your keystrokes while playing a game. You can use the replay options to record your high-score breaking sessions in Warp Warp and send these recordings to your friends to show off how skilled you are. Of course, it's tough to look like a pro when playing Warp Warp.
- Save Lists of All Games/Samples/ROMs/Info: These are simply informational lists that MacMAME can generate for you about games.
The fourth tab, called "Info", provides information about MacMAME.
- Generate a Debug Log: You will prefer to leave this option inactive unless you a) want to fill your hard drive with a file called error.log or b) are extremely curious about the internal workings of emulation. This is mainly for people who write drivers for MacMAME.
- ROM Audit: This informs you about the composition of your ROM.
The game list on the left represents all the ROMs that MacMAME recognizes in the "Roms" folder. In fact, there are three ways these ROMs can be stored:
- 1. The .zip file. This type of file has a ".zip" extension in its name. This is the standard format to use, not only because it is smaller than others, but it also helps the main window load faster.
- 2. The "Super ROM". This is a file with a grey icon with a black dot on it. This is the old format that contains all the ROMs of the same game in a Mac file that you can double-click from the Desktop to launch MacMAME. Using these files slows down the main window, so they are no longer recommended.
- 3. The "folder". This is a folder whose name matches a game listed in the "readme.txt" file. You will get this by unzipping a ROM. It is recommended to keep them in ".zip". Additionally, you can group ROM files in the "Roms" folder into subfolders. For example, if you want, you can group all Pac-Man clones in a subfolder named "Pac Truc". Better yet, you can force MacMAME to keep this folder closed in the main window by adding a "-" at the end of the name, so "Pac-Truc-" will appear closed and you won't see the ROMs inside. Double-clicking on a folder in the main window will open and close it, so you can see the ROMs inside.
Here is a brief summary of the keys:
- 5, 6, 7, 8 = Insert a coin (coin operator 1, 2, 3, 4 if applicable)
- 1, 2, 3, 4 = Start 1, 2, 3, 4 players
- 9, 0, ) = Service coin operator 1, 2, 3, 4 if applicable
- ESC = Pause (reveals the menu bar)
- F2 (then possibly F3) = Places the machine in "service/test" mode, if it has one!
- F3 = Reset the current game
- F4 = Reveals the color palette table. Navigation with arrow keys, F4 to return to the game
- F7 = Enables or disables cheat mode (requires the "cheat.dat" file)
- F8 = Increments frame skipping options
- F10 = Enables or disables original speed (it should normally be active!)
- F11 = Shows or hides performance info
- Shift+F11 = Enables or disables the "Runtime" profile
- F12 or Command+G = Takes a screenshot (to be saved in the "Photos" folder)
- TAB = Accesses the configuration menu, where you can set the dipswitches (internal settings for each game), key assignments, etc...
- "<" = Allows adjusting certain video and audio settings for each game (not saved)
- Command + Option = Temporarily accelerates the game to the maximum speed your Mac allows. The commands can be configured for each game: Press TAB (tab) during a game to call the configuration menu.
- ? Config (general): modifies commands for all games,
- ? Config (for this game) modifies commands only for this game. This also works for joysticks. By default, most games use (for player 1) arrow keys for movement, control to shoot, then option, space, and shift keys are used if necessary.
Some other functions require documentation.
- Preferences. MacMAME first looks in the same folder as the application for a file named "MacMAME Prefs" and uses it. If it is not found, it looks in the "preferences" folder. This is very useful if you have multiple versions of MacMAME and you do not want to "desynchronize" them.
- High Scores and Dipswitches. High scores are stored in a folder called "Scores" and dipswitches are stored in a folder called "Config". Both folders are located in the same folder as MacMAME. If you were using an older version of MacMAME and your files are in a folder called "Settings", MacMAME will look there first and then migrate them to the new locations. This was changed so that score and dipswitch files can be exchanged with PC users with minimal complications.
- Sound Samples. Some games do not emulate all sounds; they use sample files that they play. In this case, the sounds are placed in a folder called "Sound Samples" located in the same folder as the MacMAME application. Like ROM files, they can be .zip files or folders. There is no equivalent to the "Super ROM" format for samples. Also, the names of the .zip files and folders must match those of the ROMs. For example, the Asteroids sample must be named "asteroid.zip" like the ROM file.
IV. Frequently Asked Questions (FAQ)
This section aims to answer the most frequently asked questions about MacMAME.
- Q: Can I make the games run faster?
Several things can improve speed. Try these.- Make sure "Fullscreen" is checked in the "Video" tab.
- Ensure the "Ignore Other Applications" box is checked in the "Game" tab.
- Disable AppleTalk and disconnect from the internet.
- Make sure the "Generate Debug Log" box is not checked in the "Info" tab.
- Increase the frame skip to 1, 2, or 3 (via the Options menu).
- Play the game at nominal size.
- Lower the sound quality to 11025 Hz
- Disable FM sounds
- Disable sound
- Uncheck "anti-aliasing" for vector games
- Change your screen resolution to 800x600 or higher so the game fills the entire screen
- Q: Why isn't it working?
You would be surprised by the number of problems submitted without details. Obviously, we cannot start helping you if you don’t provide more information. Please, if you wish to ask a question, try to give us as many details as possible about your issue. - Q: All I see is a list of "names" or "credits" when I launch MAME. What should I do next?
You have correctly launched MacMAME. Press the spacebar to skip the warnings and credits. - Q: How do I start the game? All I see are 'demos'.
You have launched the game correctly. Remember that MAME is the emulation of an arcade machine. You need to insert a "virtual coin" to play a game. You can do this by typing "5". This is explained in the readme.txt file. Don’t forget to type "1" to start a single-player game. Press "TAB" during gameplay to see the keyboard and joystick configuration. - Q: Upon launching a game, a message appears: "XXX" cannot be opened! What's happening?
MacMAME is looking for a specific ROM for this game and cannot find it. This means your game is incomplete. You should download a new version. Neo-Geo and PlayChoice-10 games require the presence of their respective "BIOS" files in the "ROMs" folder (neogeo.zip and playch10.zip). - Q: I downloaded the ROM "XXX" for the game "YYY" but it doesn't appear in the list! Why?
2 reasons for this issue:- Not all games are obviously emulated by MacMAME (not yet!), so it's possible you're trying to play a game that hasn't been included yet.
- The name of the ROM you downloaded might be incorrect. To verify, save a list of games (Reports tab, then Lists, then select Games) and search for your game's name in this list. You'll find the correct ROM name there. It should be in the form: "xxxxxxxx.zip" (8 characters max + .zip).
- You can also try to identify a game whose name you don't know or aren't sure if it can be recognized by MacMAME. To do this, use the "ROM Identification" function (Reports tab).
- Q: The game "YYY" no longer works with the new version of MacMAME! Why?
2 reasons for this issue:- It may happen that the game's name changes from one version to another. If this is the case and it no longer appears in the list, see the next question.
- The ROMs of some games are sometimes incomplete or have been incorrectly extracted from the original game. If the Mini-Audit (or Audit) tells you that ROMs are missing or have a "Bad CRC", it means a new version of this game exists, it has been included in this version of MacMAME, and you will need to re-download the game to enjoy it.
- Q: How do I make the sound samples work?
The "Sound Samples" folder contains the sound samples (which you will have previously downloaded from the internet) in ".WAV" format required for some games whose sounds are not (yet) emulated. - Q: I downloaded the sound samples, placed them in the "Echantillons sons" folder, checked their names, but still no sound! What's going on?
MacMame does not require sound samples for all games, check in the "gamelist.txt" which games require or not require samples. Otherwise, verify that sound is enabled in the "AUDIO" tab and that your system volume is not set to zero. Also consider running an Audit of your sound samples (Reports tab). - Q: Where is the music in Bubble Bobble and others?
Not there yet. Maybe in a future version of MacMAME. The YM-3812 sound chip is not yet emulated on Mac. The PC version relies on the Soundblaster sound card, which uses almost the same component. Cheaters. - Q: Is this emulator legal?
In one word, yes. MacMAME performs game emulation using a "black box" reverse engineering method. The ROMs themselves are still the intellectual property of the copyright holder, which explains why they are not distributed with MacMAME. It goes without saying that MacMAME is not very useful without these ROMs. - Q: What are these 'replay' files?
The 'replay' files allow MAME to record your keystrokes during a game session so that someone else can replay them to see your gameplay, your high scores, a well-executed combo, etc. Chris Moore maintains a repository of these files. Note that it is not guaranteed that they will work on different versions of MAME other than the one on which they were created, although it usually works. - Q: Why don't the rocks glow in Asteroids?
Good question. This is related to the differences between a cathode-ray tube monitor (the one you are currently reading this on) and a vector monitor (the one Asteroids used). - Q: Did you know that "Game X" crashes when you do "Y"?
Probably. Check the "readme.txt" file included with MacMAME. It lists all the games that don’t work properly as well as all known bugs. Please check before writing to us. The requests listed in this file include the mysterious crash in Discs of Tron when you reach the mobile platform level. - Q: Will you emulate "Game X"?
Maybe. First, the ROMs must be available. PLEASE ask before sending us ROMs! Often, they are widely available and we already have them. Several popular games are not yet emulated for various reasons, but we are listening to requests. Pole Position, Turbo, and others are often requested. They will be done when we can. Often, a game is not emulated because it uses non-standard hardware (the Z8002 CPU in Pole Position) or is encrypted (Turbo), or is equipped with hardware anti-piracy devices that make it more complex to emulate. - Q: I downloaded ROMs from a PC site: can I use them with my Mac?
YES! The "zipped" (.zip) files containing the game ROMs are the same, whether for MAME (PC) or MacMAME (Mac). All you have to do is place them in the MacMAME "ROMs" folder in the format: "xxxxxxxx.zip" (8 characters max + .zip). Don’t unzip them! The games will take up much more space on your hard drive and will take longer to load, as MacMAME is optimized to decompress games on the fly. - Q: When loading certain games, the message "Out of memory" appears. What should I do?
It’s clear, you don’t have enough available memory! In any case, DO NOT MODIFY THE MEMORY ALLOCATION OF MacMAME. Indeed, MacMAME draws its temporary memory needs directly from the system.Increasing the share allocated to the application will proportionally reduce the amount needed to load the games. Games like Neo-Geo are very memory-intensive (KOF98 requires over 100MB!). Two solutions are available to you:
- Add more RAM, as their prices have significantly dropped.
- Use the virtual memory option in the "Memory" control panel. Be aware that loading some games may take an extremely long time—up to half an hour for the largest ones! As long as you hear disk activity, wait patiently... Finally, do not use RAM Doubler.
-
Q: How do you cheat in a game?
You need a specific file that you can find at this address: http://cheat.retrogames.com- If the file is compressed in "zip" format, you'll need an application like Zipit (version 1.4) to extract it.
- You should end up with a file named "cheat.dat" that you will place in the "Misc" folder.
- Launch MacMAME, go to the "More" tab, and enable "Cheat Enabled".
- Select a game and launch it.
- Press "TAB" (tab key), use the arrow keys to select "Cheats," then press "Return".
- Select the cheat you're interested in, then press "Return".
- Press "TAB" to return to the game.
-
Q: Where can you discuss MacMAME on the internet?
R: Nathan Strum manages a site dedicated to MacMAME at this address (in English): http://macmame.net. He also set up a specific discussion forum for the Mac version of MAME here: http://www.emuverse.com/boards/. If you prefer newsgroups, you can try: comp.emulators.misc or alt.emulators.classic-arcade. Additionally, there is a discussion forum dedicated to MAME (all versions combined) here: http://www.mame.net/cgi-bin/wwwthreads/. Unfortunately, there is no known forum or site discussing the Mac version of MAME in French. Maybe this is the opportunity you've been waiting for to contribute?
;-) If you know of, or wish to create, a French MacMAME site, let me know! - Q: What happens to old MAC (680XX)?
R: MacMAME no longer works on Mac PPC since version 0.29. It became too complex to maintain the code specific to these machines. Now that this is done, many PowerPC-specific improvements have been able to be implemented, taking full advantage of the processor's power. The last non-PPC compatible version is 0.28. You'll have trouble finding it... :-(
Having said that, you should run an "AUDIT" on your ROMs to check if they are complete and in good condition. To do this, select the "Reports" tab and click on "ROM AUDIT". This will generate a text file. If you're in a hurry, you can check only one game using the "MINI-AUDIT" located in the dropdown menu of the "INFO" tab. In case of issues, always use the AUDIT or Mini-Audit. It's your best friend!
These files must be compressed in ".ZIP" format. They must bear the same name as the game. The exact name of these files can be found in the "gamelist.txt" document next to the game name.
For simplicity, vector monitors offer better brightness and contrast. The best thing to do is to increase brightness and gamma and adjust contrast. Don’t write to us if you’ve burned your screen :)
⚠️ This guide is flagged as obsolete.
Related software
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.