Author: Dave Nelson

How to make a new folder icon for your MAME games is pretty easy with a handful of steps. This is the process I followed; there are other ways to do it using other tools. I used Preview, Adobe Photoshop, and Xcode’s Icon Utility.

Step 1: Get the Icons

I like JohanChalibert’s OS X Yosemite Icon set that he has posted on Deviant Art, but you could search around a bit and find many different icon sets that would be a great place to start.

Download the icon set, unzip it, take a moment to read the readme file, and then find the folder icon you want to use as a starting point, I used GenericFolderIcon.icns. Right-click the Icns file and open it in Preview.

Step 2: Export the Base Icon

Now that you have the icon set open in preview you can see that it is made up of 10 different graphics. By opening the Inspector (Tools > Show Inspector or Command i) you can see the details for each graphic, like the first graphic is 1024 x 1024 pixels in size at 144 dpi.

Right-click the “1” graphic and choose Export As…, change the Format to PNG making sure the Alpha checkbox is checked. I kept the default name of GenericFolderIcon.png.

Step 3: Editing the Graphics

Now I download the super large version of the MAME logo from MAME Dev. This is what I want to put on the front of my folder icon.

1. Open both the GenericFolderIcon.png and the MAMELogoTM.jpg files in Photoshop.
2. On the MAME logo in the Layers panel click the padlock icon to convert the background to a regular layer.
3. Using the Magic Wand tool with a Tolerance of 12, Anti-alias checked, and Contiguous unchecked click the black background of the logo.

4. 

   Click the Delete key to remove that black background then Command D to cancel the selection.

5. 

   Open the Levels panel (Image > Adjustments > Levels… or Command L) and under Output Levels make both sides “0” which will make the entire logo solid black.

6. 

   Then Select All (Command A), Copy (Command C), then switch to the GenericFolderIcon graphic and Paste (Command V).

7. 

   Initially the MAME logo will be huge compared to the folder so you will need to transform it to fie. Transform (Command T) then while holding down the shift key to keep the ratio of the logo locked start resizing the logo until it looks good to you.
8. In the Layer panel switch the mode to Overlay.
9. Create an “fx” layer with an Inner Shadow, I like the settings Blend Mode: Mulitply, Opacity: 36%, Angle: 128, Distance: 9px, Choke: 0, Size: 21px. Play with it until you find something you like.

10. 

    For my tastes the MAME logo is still too strong, I want it to more closely match the Apple Applications folder Icon. So back in the Layers I turn the Opacity of the logo layer down to 38%.
11. Save that PSD file early and often so you have something to go back too if there are any problems or you want to make adjustments later.

Step 4: Saving the Graphics

For a complete Apple icon you need 10 images.

icon_16x16.png
[email protected]
icon_32x32.png
[email protected]
icon_128x128.png
[email protected]
icon_256x256.png
[email protected]
icon_512x512.png
[email protected]

The “2x” images are saved at 144 DPI while the others are saved at 72 DPI.

It can get a bit confusing at this point, but keep in mind that [email protected] is really 256×256 at a resolution of 144 DPI while icon_256x256.png is 256×256 at a resolution of 72 DPI.

1. I make a Duplicate (Image > Duplicate) of the image so that I wont accidentally overwrite my full-sized PSD file.

2. 

   In the Image Size panel (Image > Image Size… or Command Option I) adjust the resolution to 1024×1024 at 144 DPI.
3. Then Save for Web (File > Save for Web… or Command Option Shift S) with the settings of PNG-24 and Transparency Checked.
4. Click Save and in the Save Optimized As dialog box make a new folder naming it “MAMEFolderIcon.iconset”. The “.iconset” portion is important later.
5. Name this first file [email protected] and save it.

6. 

   Back to the Image Size panel adjust the size to 72 DPI Resolution and sized 512×512 (easier to make the changes in that order as adjusting the resolution will change the width and height). Resample should be set to “Automatic” or “Bicubic Sharper (reduction)”.
7. Save this one as icon_512x512.png.

8. 

   Now do that another 8 times adjusting the size and saving based on the file names above.

As the icon graphic gets smaller you could change it up to keep it distinguishable from other icons. Instead of using the full MAME logo you could use just an “M” or you could darken the logo, or anything else you can think of.

Step 5: Building the Icon Set

I am using the Icon Utilities tool that comes with Xcode. There are a lot of icon tools out there, the App Store is full of them, but I happen to have Xcode installed and decided this was the easiest way for me to create the finished icon set.

1. Open the Terminal app and change the directory to where you have the MAMEFolderIcon.iconset saved. For me that was “cd /Users/dnelson/Documents/Folder\ Icon\ Post/”
2. Then run the Icon Utilities app “iconutil -c icns MAMEFolderIcon.iconset”

And BANG! You have your very own MAMEFolderIcon.icns icon set.

Step 6: Put your New Icon Set to Use

Find the folder you want to give your new Icon Set to and get ready for the magic.

1. Select the folder, click on it once, than then Get Info (right-click and choose Get Info or Command I).

2. 

   Now drag-and-drop you new icon set on top of the folder icon at the top of the Get Info dialog box.

3. 

   And you are done!

It is a tedious process, but it is nice to have custom icons like this, especially for folders in the Doc. This process will also work for making icons for your game launching files.

Sometimes you want to be able to launch a game by double-clicking an icon rather than going through MAME’s interface or using the Terminal. This method has the added benefit of letting you easily launch MAME with various options.

We are going to write a small shell script, save it as a command file, and make it executable.

If you have followed the directions in my previous post “MAME on Mac OSX Yosemite” you can follow these instructions exactly, if you have made changes or modified any steps, keep that in mind while working through these steps.

First off we write the shell script.

1. 1. Open the Documents directory and create a new folder named “MAME Games”.
2. 2. Open Applications > TextEdit and click Format > Make Plain Text
3. 3. On the first line of the document enter “#!/usr/bin/env bash”. This is known as a shebang and tells the computer that we want to use the Bash shell to run our script.
4. 4. Then for readablility’s sake skip a line and enter “cd ~/Documents/mame” on the next line. This changes the directory to your mame folder inside of your Documents folder.
5. 5. On the last line enter “./mame64 robotbwl” which launches the MAME application and loads the Robot Bowl ROM.
6. 6. Now save the file naming it “Robot Bowl.command”. The filename extension of “command” tells Mac OSX that this is a Terminal shell script.

We have created our script now we have to give it permission to be executable.

1. 1. Open the Terminal app and end enter “chmod +x ~/Documents/MAME\ Games/Robot\ Bowl.command”, this modifies the permissions of the “Robot Bowl.command” file by adding the Executebale for everyone permissions to it.
2. 2. NOTE: The back slash “\” in the code escapes the spaces in the directory path and file names, without those back slashes the code will not work.

That is all there is to it, you should now be able to double click on the Robot Bowl file to launch MAME and the Robot Bowl game.

Options

Now we are going to create a file that will launch the Robot Bowl game with the screen much brighter than normal. This can be really handy if you have a screen or a game that is dark.

1. 1. Copy the Robot Bowl file we created above and name it “Robot Bowl Bright”. By copying the Robot Bowl file the copied file will have the original’s executable permissions.
2. 2. Open the Robot Bowl Bright file in TextEdit and add the brightness option to it by changing the last line to be “./mame64 robotbwl -brightness 1.5” and save it.

Now launch the new Robot Bowl Bright file and you can see how much brighter it is, the background has become gray. Hit the Escape (esc) key to quit and launch the original Robot Bowl file and you should see that the background is black when launching the game from that file.

In the docs directory there is a config.txt file that contains many other options you can use to configure your launchers. The ones you will probably use most often are the joystick options.

The Dock

To make launching games even easier you can drag the MAME Games folder onto the right-hand side of the Dock by the trashcan. I don’t like the default view of folders in the Dock so I right-click the folder and choose “Display as Folder” and “View content as List”. Now I can click the folder in the dock and choose a game from the list.

You could get creative with this and have a different folder for different types of games or with different options enabled for the games.

Multiple Arcade Machine Emulator (MAME) is a free and open source application used as a reference of the inner workings of arcade gaming systems. A side effect of this is that MAME can be used to play old arcade games if you can find the games. MAME uses data dumps from the Read Only Memory chips (ROMs) that were used in the original arcade games.

You can download the ROMs of some games from the mamedev.org website. I am going to use Robot Bowl as an example.

You will have to use the terminal app and the console to get MAME working, but it is very easy following the steps below. You will also need admin privileges on the computer, this is not absolutely necessary to run MAME, but that is how I am going to cover it here.

These instructions are for SDLMAME version 0.156 64-bit which was released on November 28, 2014.

Lets get started.

1. Visit http://wiki.mamedev.org/index.php/SDL_Supported_Platforms and click on the URL for “Apple Macintosh OS X Intel” with a build target of “MAME”. Curretly that URL is http://sdlmame.lngn.net/
2. Follow the instructions at the top of the page and install the “SDL runtime library”
   1. From the SDL website download SDL2-2.0.3.dmg or the latest version.
   2. Double-click the SDL2-2.0.3.dmg file which will mount it as a drive.
   3. Open the Terminal application Applications > Utilities > Terminal
   4. Enter “open /Library/Frameworks” into the terminal window, this will open a window for the Frameworks directory
   5. Drag the “SDL2.framework” file from the SDL2 window into the “Frameworks” window, you may be prompted to enter an Admin username and password to authenticate your desire to modify the Frameworks directory. Click “Authenticate” and then enter an Admin Username and Password.
3. Back at the SDLMAME page click on the “SDLMAME v0.156 64-bit” link and save the file to your computer. I am placing it in the “Documents” directory.
4. Double-click the zip file, when finished you should now have a folder named “mame0156-64bit”, now rename this folder “mame”, keep in mind that case counts so make sure the folder name is all lower-case.
5. Open the “mame” folder and take a look at the contents
6. Over in the Terminal app, enter “cd ~/Documents/mame” and then “ls -al” to double-check that you are in the right directory
7. Now to create the MAME configuration file enter “./mame64 -createconfig” this will create a “mame.ini” file in the “mame” directory
8. Now to get a ROM visit the mamedev.org website and the Robot Bowl game at http://mamedev.org/roms/robotbwl/
   1. Click on “I understand…” and download the game to the Documents/mame/roms directory
   2. WARNING: ROMs are saved as zip files and they should stay zipped. MAME will handle unzipping them and using the contents inside. If you use a web browser that automatically unzips files when you download them you will need to change that setting to preserve the original files.
9. In Yosemite the keyboard does not use the function keys on as F-1 through F19 the way other operating systems do, they are assigned all kinds of other functions. You can hold the “Function (fn)” key down everytime you want to use a function key or you can open the System Preferences > Keyboard and check the “Use all F1, F2, etc. keys as standard function keys” box. If you check this box you can use the “fn” key to utilize the special functions of those keys. That is my preferred method.
10. Now to launch MAMA and give Robot Bowl a try
    1. In the Terminal enter “./mame64”
    2. Use the arrow keys to select “robotbwl Robot Bowl” and tap Enter
    3. You may see a screen warning about using ROMs that you are not legally entitled to play, give it a quick read and know that you have been given permission by H.R. Kaufmann, president of Xidy, the original ROM images for Robot Bowl have been made available for free, non-commercial use. On your keyboard the left then right arrows to move on.
    4. Then you may see a message that there are known problems with this game. The sound emulation isn’t 100% accurate. Click the left then right arrow keys again to move on.
    5. Now the game should be playing its attract animation of a stick figure coming out to bowl.
    6. Tap the “Tab” key to bring up the in-game configuration menu and choose “Input (this Game)”
       1. NOTE: I prefer not to change the “Input (general)” controls from the default. By keeping the general defaults tutorials and other help I may use in the future will work without me having to translate which keys to press.
    7. Controls
       1. This is really cool, when you look at the input controls for a specific game, it shows ALL of the control options for that game making it very easy to learn how to play that game and re-configure the buttons and controls for it.
       2. For Robot Bowl the default controls are:
          1. 1 Player Start: 1
          2. Coin 1: 5
          3. P1 Left Button: Left arrow key
          4. P1 Right Button: Right arrow key
          5. P1 Button 1: Left Control key or mouse button 1 (left mouse button)
          6. P1 Button 2: Left Alt key or muse button 3 (right mouse button)
          7. Hook Left: Z key
          8. Hook Right: X key

       3. You can use the arrow keys to navigate to any of these and change them by tapping the Enter key then tapping the key you want to use; you can have more than one key assigned to a single control.

And that is it; you now have MAME up and running on your Mac OSX Yosemite computer.

You can find a lot more information about customizing MAME in the ~/Documents/mame/docs directory, especially in the config.txt file.