The SheepShaver Wrapper for OS X

Summary | How to set it up | Acknowledgments | Support


An easy way to run "classic" applications under OS X

Mac OS X no longer makes it possible to run "classic" Mac applications written for "classic" Mac OS versions, such as System 7 or Mac OS 9. In order to run such applications, OS X users must now install "emulator" software that runs old versions of the Mac OS in a window on the OS X desktop. The most advanced of these emulator programs is SheepShaver. SheepShaver is no longer supported by its original author, Gwenolé Beauchesne, but minor updates are available from an active support forum at E-Maculation.

This page provides a system that makes it easy to set up and use SheepShaver under OS X 10.5 or later. You will need to supply a "ROM file" (as described below) and you will need an installation CD for any version of the Mac OS from OS 8.5 through 9.0.4, or a disk image of such a CD, as described below.

This system requires OS X 10.6.6 or later. It was revised on 3 August 2013 to include a 2GB "sparse bundle" virtual disk and a blank disk image to use if needed as a replacement or addition to the original disk.


How to set it up

The usual way to set up SheepShaver is to follow the detailed guide on the E-maculation site. The page you are now reading provides a much simpler method, using a prebuilt "application bundle" that contains almost everything you need, in a single package. To use it, follow these steps. Note that when the instructions refer to OS 9, the same procedure should work with OS 8.5 or 8.6. (Expert users will know how to modify the system for use with System 7 through 8.1; non-experts should not attempt this.)

1. Download the application bundle here. It is enclosed in a 13 MB ZIP file. Extract it and place it anywhere on your hard disk. Do not launch the application until you finish step 2; if you do, it will display a warning that you need to add a ROM file, and SheepShaver will not start.

2. Get a copy of a New World Mac PPC ROM. See the setup guide at E-Maculation for advice on how to find one. (A web search for "new world PPC ROM best for SheepShaver" - without the quotation marks - might also yield results.) Make certain that the ROM file is named Mac OS ROM and drop it onto the SheepShaver Wrapper. A message from the SheepShaver Wrapper will tell you that the file was copied to the correct location.

3. Install Mac OS 8.5 through 9.0.4. This step assumes that you have a copy of an OS 8.5 through 9.0.4 installation CD, either on CD or on a disk image. (Note: Under OS X 10.8 or later, you must use a disk image, not an actual CD.) The installation CD must be a retail CD, not one that came with a specific machine. Follow step 3a or 3b below, depending on whether you have a CD or disk image. Note that when installing, you should not try to format or initialize the virtual hard disk; it is already formatted, and contains some Apple-supplied updates for OS 8.6 and 9.0.4 in a disk image file in a folder named "OS Updaters". Some of these are US-English versions; other versions may be downloadable from the international downloads page on Apple's web site.

(Note: When installing OS 9, when you reach the menu that lets you specify which parts of the OS you want to install, click Options and turn off the option to "Update Apple Hard Disk Drivers"; for reasons that I don't understand, the OS installation may stall when this option is on. When booting from an OS 8.5 CD or CD image, hold down the shift key to turn extensions off, or else the CD or CD image may not boot; this is not required with an 8.6 CD.)

3a. If you have an actual Mac OS installation CD, mount it on the OS X desktop, and then - after the CD has mounted on the OS X desktop - start the SheepShaver Wrapper application. When the CD boots, you may install OS 9 on the virtual hard disk included in the SheepShaver Wrapper. When you are done, shut down SheepShaver, and eject the CD. Warning: Under OS X 10.8 "Mountain Lion" or later, you cannot use a physical CD. You must create an image file from the CD, as described in step 3b immediately below.

3b. If you have a CD image file of a Mac OS installation CD, drop the image file on the SheepShaver Wrapper. If the file is in the correct format, and is bootable, SheepShaver will boot from the image file. (If the image file is not "locked," which it must be if the Mac OS is to be installed from it, the SheepShaver Wrapper will offer to lock it for you.) Install the Mac OS from the booted CD image. 9. Shut down SheepShaver completely. Start the SheepShaver Wrapper again, and it should now boot to OS 8 or 9, and the CD image will not be mounted. (To create an image file from an installation CD, use Disk Utility in OS X and create a disk image in "DVD/CD Master" format.)

4. Start up SheepShaver and start working in Mac OS 8 or 9. The steps above will give you a working SheepShaver system, with the "Unix" folder in SheepShaver set to be your Documents folder in OS X. If you want to use a different folder as the "Unix" folder, then shut down SheepShaver, and turn on Caps Lock by tapping the Caps Lock key on your keyboard. Follow the prompts to select a folder as your "Unix" folder.

Note that you should not try to change the "Unix Root" folder in the SheepShaver -> Preferences dialog, because the application will ignore any change you make to the "Unix Root" setting in the Preferences dialog. (Any other changes made in the Preferences dialog, however, will take effect the next time you start the application.) For complicated reasons, my own system - the one on which this one is based - writes the location of the Unix folder into the SheepShaver preferences file every time the program launches, and I didn't change that method when preparing this reduced version. Hold down CapsLock when starting the SheepShaver Wrapper if you want to change the location of the Unix folder.

4. Study the configuration guide at E-Maculation. The Configuration Guide includes absolutely essential information about using the "classic" Mac OS in SheepShaver. If something goes wrong, and you have not studied that guide, then you have only yourself to blame.

6. Some tips and tricks. If you hold down the Command key while launching the SheepShaver Wrapper, it will open in a quasi-full-screen mode. (It will prompt you to ask if you want this to happen.) The dock will be hidden; the OS X top-line menu will not appear until you move the cursor to the top of the screen; the SheepShaver "window" will fill the entire screen. This is different from true full-screen mode in that you can Alt-Tab to other OS X applications. If you want to go back to windowed mode, hold down the Option key when launching the SheepShaver Wrapper. (It will prompt you to ask if you want to go back to ordinary windowed mode.) This quasi-full-screen feature requires that "Access for Assistive Devices" be turned on in your OS X system; if "Access for Assistive Devices" is not already turned on, you will be prompted to let the script turn it on for you. (You will be prompted by OS X for a password. As you can see by reading the AppleScript, the script itself does not get access to your password.)

By default, the application opens with a window size of 896 x 672. This is a non-standard size, but it lets the application work easily on all current Macs. If you know how to edit AppleScript, you can open the application in the AppleScript Editor (ignore the warning message about the application not being scriptable), and change a clearly-explained option near the top of the script, so that the application will instead calculate its initial window size as a proportion of your actual monitor size. Also, you can change the window size at any time by using the SheepShaver Preferences dialog, and then shutting down and restarting the application. Or (if you know what you are doing) you can edit the AppleScript in the SheepShaver Wrapper to change the default window size, and then hold down the Option key when next starting the SheepShaver Wrapper in order for the changed default to take effect. (Standard screens on PowerPC laptop computers that shipped with OS 8 or 9 had screen sizes of 800x600 and 1024x768.)

The virtual hard disk in the system is a 2GB disk. If that does not provide enough disk spce for your purposes, create a second disk, using the procedures described in the wiki at Emaculation.com. Or use the SheepShaver preferences to add the unformatted Backup 2GB disk also included in the system.


Acknowledgments

This system is built on software provided by many people who are more expert than I am. The included build of SheepShaver was built by Ronald P. Regensburg and posted at the E-Maculation support forum for SheepShaver. The AppleScript makes use of two Unix applications, checkModifierKeys by Stefan Klieme, and dspsizes, by Martin Michel. I have benefited from many suggestions by Ronald P. Regensburg and others in the E-Maculation forum, and I could not have written this script without the help of many experts at Macscripter.net.


Support

Please do not ask me to help you set up the Mac OS or use any applications. Please ask for support in the E-Maculation support forum for SheepShaver. If you want to get in touch with me about the AppleScript in the SheepShaver Wrapper, then please visit this page.


Edward Mendelson (em thirty-six [at] columbia [dot] edu, but with two initials and two numerals before the [at] sign, not spelled out as shown here).