Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
sheepshaver_mac_os_x_setup [2018/05/14 00:26] – [Introduction] ronald_p._regensburg | sheepshaver_mac_os_x_setup [2024/03/01 12:43] (current) – [Setting up SheepShaver for OSX/macOS] ronald_p._regensburg | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Setting up SheepShaver for Mac OS X ====== | + | ====== Setting up SheepShaver for OSX/ |
- | (Last updated | + | (Last updated |
- | (You can also set up [[sheepshaver setup|SheepShaver | + | (You can also set up SheepShaver versions [[sheepshaver mac os x setup old|for Mac OS X on PPC]], |
===== Introduction ===== | ===== Introduction ===== | ||
=== === | === === | ||
- | This manual is revised for use with the 25-10-2009 | + | This manual is revised for use with our July 2018 and later builds of [[SheepShaver]].\\ |
+ | For older SheepShaver builds that will run on PPC Macs, see this [[sheepshaver mac os x setup old|older setup guide]]. | ||
- | **Download SheepShaver application from [[http:// | + | **Download |
+ | Please read the information on that page, newer information | ||
- | We start with the description of a classic setup with all files together in a folder named " | + | **Classic setup: |
+ | However, files and folders can be renamed and/or moved to different locations, provided you make sure the file names and/or full paths to the files are entered in SheepShaver | ||
- | **Note:** Changed settings in preferences | + | **SheepShaver Preferences and SheepShaver Settings:** Throughout this manual you will see both used together or alternately. OSX/macOS always used a " |
- | **Mountain Lion and later issue:** OSX 10.8 and later prevents mounting of physical CD-ROMs in SheepShaver | + | **Changing settings:** After saving changed settings, always quit the SheepShaver application, |
- | //(This guide describes a setup with installation of the Mac OS using a general retail | + | **CD-ROMs: |
- | Please post questions and comments on E-Maculation SheepShaver forum: http:// | + | As most users will now use disk image files instead of physical CD-ROMs, this guide will describe a setup with installation of the Mac OS using a disk image file created from a system install CD. |
+ | // | ||
+ | |||
+ | Please post questions and comments on E-Maculation SheepShaver forum: https:// | ||
===== Setting up SheepShaver ===== | ===== Setting up SheepShaver ===== | ||
==== You need a Mac OS install CD ==== | ==== You need a Mac OS install CD ==== | ||
Line 27: | Line 33: | ||
=== === | === === | ||
- | You will need a compatible Mac OS install CD to be able to install a Mac OS in the SheepShaver emulated machine. Depending on the used ROM file (see below for more info on ROM files), SheepShaver can run System 7.5.3 through Mac OS 9.0.4. SheepShaver cannot run 9.1 or later. | + | You will need a compatible Mac OS install CD, or a disk image created from a compatible Mac OS install CD, to be able to install a Mac OS in the SheepShaver emulated machine. Depending on the used ROM file (see below for more info on ROM files), SheepShaver can run System 7.5.3 through Mac OS 9.0.4. SheepShaver cannot run 9.1 or later. |
- | Only generic | + | Only general |
Line 35: | Line 41: | ||
* You may be able to install in SheepShaver from a model-specific install CD using a special hack and you may be able to use a restore CD by copying the system manually. However, with both procedures, the installed system may or may not work and when it works, it may not be fully functional.\\ | * You may be able to install in SheepShaver from a model-specific install CD using a special hack and you may be able to use a restore CD by copying the system manually. However, with both procedures, the installed system may or may not work and when it works, it may not be fully functional.\\ | ||
- | See discusion | + | See discussion |
+ | https:// | ||
=== === | === === | ||
- | //(A disk image of a retail Mac OS install CD can be used instead of the real CD. The disk image must be in a non-compressed format | + | This guide assumes that you own a suitable |
+ | |||
+ | == == | ||
+ | **However, install CD image files can be downloaded from various places on the internet.**\\ | ||
+ | Make sure the image is indeed created from a general retail Mac OS install CD. A retail international English Mac OS 9.0.4 install CD image that will work can be downloaded from the Macintosh Garden site. Go to [[http:// | ||
+ | |||
+ | === === | ||
+ | |||
+ | If you want to create disk images from CD-ROMs yourself, you can do this using Disk Utility in macOS 10.14 (Mojave) and earlier: | ||
+ | - Mount the CD in OSX/ | ||
+ | - Start Disk Utility (in the / | ||
+ | - Select the CD volume (not the drive) in the list on the left\\ | ||
+ | - Click New Image in the tool bar or in newer Disk Utility versions use New Image from the File menu\\ | ||
+ | - Choose DVD/CD master for the format\\ | ||
+ | - Save the image file. It will have a .cdr extension. | ||
+ | |||
+ | This does not work with these older (HFS) CD-ROMS in macOS 10.15 (Catalina) and 11 (Big Sur). A workaround for creating a disk image from the HFS volume on the CD is described here:\\ | ||
+ | https://www.emaculation.com/ | ||
+ | |||
+ | Interestingly, | ||
- | //(This guide assumes that you own a suitable retail Mac OS install CD and that you can create a disk image from it as described above in the Introduction chapter and in more detail in the Known Issues chapter below. A retail international English Mac OS 9.0.4 disk image can be downloaded from the Macintosh Garden site. On that site search for "Mac OS 9.0.4" and on the Mac OS 9.0.4 page look for the file " | ||
==== The files you need in your SheepShaver folder ==== | ==== The files you need in your SheepShaver folder ==== | ||
=== 1. The SheepShaver application === | === 1. The SheepShaver application === | ||
+ | |||
+ | The SheepShaver application and the SheepShaver folder are presented as separate downloads. First download and expand the SheepShaver application in a different location (like the Downloads folder or the Desktop) and then drag the application into the SheepShaver folder. | ||
+ | |||
+ | (Do not download the application or expand the zip archive directly into the SheepShaver folder. If you do that, a security feature in macOS may prevent running the application.) | ||
=== 2. A compatible ROM file === | === 2. A compatible ROM file === | ||
Line 51: | Line 80: | ||
**SheepShaver will not run without a compatible ROM file. If SheepShaver does not find a compatible ROM file, it will immediately quit on launch.** | **SheepShaver will not run without a compatible ROM file. If SheepShaver does not find a compatible ROM file, it will immediately quit on launch.** | ||
- | It may be difficult to get hold of a compatible ROM file as distributing bare ROM files violates Apple license agreements. Emaculation.com site policy is to not offer or link directly to bare ROM files, although Apple seems to have stopped taking action against distribution of ROM files. | + | It may be difficult to get hold of a compatible ROM file as distributing bare ROM files violates Apple license agreements. Emaculation.com site policy is still to not offer or link directly to bare ROM files, although Apple seems to have stopped taking action against distribution of ROM files. |
- | The ROM file from a 9.0.4 system CD will not work with any version of SheepShaver. ROM files from a 8.5 or 8.6 system CD may work with SheepShaver for Windows, but do not work with SheepShaver for Mac OS X (with a few specific exceptions that are beyond the scope of this manual). | + | The ROM file from a 9.0.4 system CD will not work with any version of SheepShaver. ROM files from a 8.5 or 8.6 system CD may work with SheepShaver for Windows, but do not work with SheepShaver for OSX/ |
- | ROM files that will work with SheepShaver for Mac OS X are either an "old world" rom image grabbed from an actual hardware PowerMacintosh ROM, or the "new world" rom file extracted from the "Mac OS ROM Update 1.0" using TomeViewer. The "Mac OS ROM Update 1.0" can be downloaded from Apple, but you need to have a working Mac OS system (or Classic in Mac OS X) to run TomeViewer. | + | ROM files that will work with SheepShaver for OSX/ |
[[http:// | [[http:// | ||
- | [[http:// | + | [[https:// |
- | [[http:// | + | [[https:// |
- | **However, to make it easier:** | + | == == |
- | You can find compatible ROM files when you search the web for " | + | **However, here is the easy way to get hold of a compatible ROM file:**\\ |
+ | You can find compatible ROM files when you search the web for " | ||
+ | With the **old world rom** file SheepShaver can run System 7.5.3 through Mac OS 9.0.4, with the **new world rom** file SheepShaver can run Mac OS 8.5 through 9.0.4.\\ | ||
+ | If you want to install 8.6 through 9.0.4, best use the new world rom. | ||
- | With the old world rom file SheepShaver can run System 7.5.3 through | + | //Note: The Redundant Robot site used to provide also a "Mac OS 9 Boot Image" (OS9.img) with a pre-installed |
- | If you want to install 8.6 through 9.0.4, best use the new world rom. | + | === === |
- | When you have acquired a compatible ROM file, **rename it "Mac OS ROM"** (without the quotation marks and without a file name extension) if that is not yet its name. (SheepShaver will recognize a ROM file with that name in the same folder | + | When you have acquired a compatible ROM file, **rename it "Mac OS ROM"**. Best do that in Finder Info for the file: Select the icon and hit Command-I. The Finder Info panel will appear. Under "Name & Extension" |
+ | (Renaming is needed because without configuration | ||
=== 3. A keycodes file === | === 3. A keycodes file === | ||
- | The keycodes file is needed with other than US-English QWERTY keyboard layouts. It is not needed | + | The keycodes file is needed with other than US-English QWERTY keyboard layouts. It is not needed if only a US-English keyboard will be used. The keycodes file is already present in the downloaded |
- | [[http:// | + | |
+ | === 4. The install CD image file === | ||
+ | |||
+ | If you are going to use an install CD image file for installing the Mac OS in SheepShaver, | ||
==== The shared folder ==== | ==== The shared folder ==== | ||
=== === | === === | ||
- | From within SheepShaver you will have access to a folder on the Mac OS X side. That folder will appear on the SheepShaver desktop as a disk named " | + | From within SheepShaver you will have access to a folder on the OSX/ |
- | Before you start configuring SheepShaver, | + | Before you start configuring SheepShaver, |
- | **Note:** Although | + | **Note:** Although serious bugs that plagued the shared folder feature in early versions of SheepShaver have been solved, we still advise to not use folders like your Documents folder or your Home folder as shared folder and not keep the only existing copy of a file in the shared folder. |
**Note:** Applications cannot run properly from the " | **Note:** Applications cannot run properly from the " | ||
Line 92: | Line 128: | ||
=== === | === === | ||
- | When the needed files are in the SheepShaver folder, when you have created a shared folder, and when you have your Mac OS system install disk ready, you can start configuring SheepShaver. | + | When the needed files are in the SheepShaver folder |
=== 1. Start SheepShaver === | === 1. Start SheepShaver === | ||
+ | |||
+ | Recent SheepShaver builds are notarized. If you use a build that is not notarized, the first time you launch SheepShaver you may need to right-click or control-click its icon to open it from the contextual menu. | ||
If SheepShaver does not find a compatible ROM file, it will immediately quit on launch. | If SheepShaver does not find a compatible ROM file, it will immediately quit on launch. | ||
Line 100: | Line 138: | ||
If a compatible ROM file with the name "Mac OS ROM" or " | If a compatible ROM file with the name "Mac OS ROM" or " | ||
- | {{ http:// | + | {{ https:// |
+ | |||
+ | **Note:** At this stage you can only hard shut down SheepShaver by pressing Control-Escape. | ||
- | **Note:** At this stage you can only quit SheepShaver pressing Control-Escape. | + | === 2. Open Preferences (Settings in macOS 13 Ventura and later) from SheepShaver application menu === |
- | === 2. Open Preferences from SheepShaver | + | Choose |
- | Choose Preferences from the SheepShaver | + | The settings will be saved in a hidden file .sheepshaver_prefs in your Home folder. The following description assumes that SheepShaver |
- | (The preferences settings will be saved in a invisible | + | (In a setup that is created with a SheepShaver build that was compiled between October 2022 and January 2024, the prefs file will be ~/.config/SheepShaver/prefs In later builds this is again reverted to ~/ |
- | === 3. Configure | + | === 3. Configure |
**ROM File**\\ | **ROM File**\\ | ||
First add the ROM file name using the " | First add the ROM file name using the " | ||
- | {{ http:// | + | {{ :ssosxprefs0-2.png }} |
**Volumes**\\ | **Volumes**\\ | ||
You can now proceed with creating the disk image file that will be the virtual hard disk on the emulated Mac. Click the " | You can now proceed with creating the disk image file that will be the virtual hard disk on the emulated Mac. Click the " | ||
- | {{ http:// | + | {{ :ssosxcreate-2.png }} |
- | Choose an appropriate name for the image file, for instance MacOS9. (An extension .dsk will be suggested, but no extension is needed.) Choose a size for the volume (for instance | + | Choose an appropriate name for the image file, for instance MacOS9. (An extension .dsk will be suggested, but no extension is needed.) Choose a size in MB for the volume (for instance |
- | {{ http://www.emaculation.com/ | + | Then, if a Mac OS install CD image file is used, use the "Add..." button to find and " |
- | //(If an install CD disk image file is used instead of a real install CD: Use the "Add..." button to find and " | + | {{ :ssosxprefs1-2.png }} |
**Unix Root**\\ | **Unix Root**\\ | ||
Add the path to your shared folder using the second " | Add the path to your shared folder using the second " | ||
- | **Do not keep the default value "/", | + | **Do not keep the default value "/", |
**RAM Size (MB)**\\ | **RAM Size (MB)**\\ | ||
Line 140: | Line 180: | ||
Leave **Disable CD-ROM** unchecked. | Leave **Disable CD-ROM** unchecked. | ||
- | === 4. Configure | + | === 4. Configure |
- | {{ http:// | + | {{ :ssosxprefs2-2.png }} |
**Video Type**\\ | **Video Type**\\ | ||
Line 149: | Line 189: | ||
**Refresh Rate**\\ | **Refresh Rate**\\ | ||
- | On fast Intel machines | + | On fast Intel machines |
- | (On slower machines a lower setting like 30Hz or 15Hz may improve performance and will lower the extreme CPU hunger of SheepShaver on PPC machines.) | + | |
**Width and Height**\\ | **Width and Height**\\ | ||
- | Set Width and Height for the window to lower values than the width and height of your screen. If you have a large screen, you can enter higher values than those in the menu, for instance 1280 x 800. | + | Set Width and Height for the window to lower values than the width and height of your screen. If you have a large screen, you can enter higher values than the presets |
Check **Enable QuickDraw Acceleration**. | Check **Enable QuickDraw Acceleration**. | ||
Line 159: | Line 198: | ||
The **Audio Settings** can be ignored. | The **Audio Settings** can be ignored. | ||
- | === 5. Configure | + | === 5. Configure |
- | {{ : | + | {{ : |
**CPU Options**\\ | **CPU Options**\\ | ||
- | Check only " | + | Check " |
+ | **Note:** JIT Compiler is not functional anymore on Apple Silicon, JIT settings will be ignored. | ||
**Mouse/ | **Mouse/ | ||
Check "Use Raw Keycodes" | Check "Use Raw Keycodes" | ||
- | "Mouse Wheel Function" | + | "Mouse Wheel Function" |
+ | In 17 March 2021 and later builds, a negative value can be entered in the "Lines to Scroll" | ||
**Serial/ | **Serial/ | ||
Line 178: | Line 219: | ||
=== 6. Save your settings === | === 6. Save your settings === | ||
- | Click " | + | Click "Save" or "Save and Quit" to save the settings and to close the Settings |
+ | (In 2 February 2019 and later builds the " | ||
=== 7. Quit SheepShaver === | === 7. Quit SheepShaver === | ||
- | The emulated machine cannot be shutdown | + | The emulated machine cannot be shut down normally while waiting for a boot disk and SheepShaver cannot be quit with the emulated machine still running. So at this point we use Control-Escape to quit SheepShaver, |
==== Booting SheepShaver and installing the system ==== | ==== Booting SheepShaver and installing the system ==== | ||
=== === | === === | ||
- | If you use a real install CD, **first insert the CD** and have it mount in Mac OS X. | + | //(If you use a real install CD, **first insert the CD** and have it mounted |
- | //(If you use a install CD disk image instead of a real install CD, make sure the CD image file is locked | + | Do **not** have your install CD image mounted |
- | **Launch SheepShaver**. The emulated machine will startup | + | **Launch SheepShaver**. The emulated machine will start up from the install CD image //(or from the install |
- | During startup, the system will encounter the newly created volume and will offer to initialize it. Give the volume an appropriate name (for instance MacOS9HD) and (for Mac OS 8.1 or later) choose Mac OS Extended for the format. Click to proceed with initializing the volume. | + | During startup, the system will encounter the newly created volume and will offer to initialize it. Give the volume an appropriate name (for instance MacOS9HD) and (for Mac OS 8.1 and later) choose Mac OS Extended for the format. Click to proceed with initializing the volume. |
- | Finally, you will see the desktop with icons for the startup volume (the CD or the CD disk image), for the new volume that you will install the system onto, and for the " | + | Finally, you will see the desktop with icons for the startup volume (the CD image or the CD), for the new volume that you will install the system onto, and for the " |
Proceed with the system installation by starting (double-clicking) the installer "Mac OS Install" | Proceed with the system installation by starting (double-clicking) the installer "Mac OS Install" | ||
Line 202: | Line 243: | ||
== == | == == | ||
- | | In some configurations the system installation may stall at the very beginning while " | + | | In some configurations the system installation may stall at the very beginning while " |
=== === | === === | ||
Line 208: | Line 249: | ||
When the installation is completed, you can quit the installer. | When the installation is completed, you can quit the installer. | ||
- | //(If you used a install CD disk image file instead of a real install CD: Open SheepShaver Preferences and remove the CD disk image file from the volumes list, select it and click the Remove button.)// | + | Open SheepShaver Preferences |
- | Shut down the emulated machine | + | Save the change and shut down the emulated machine |
- | If you used a real install CD, you can now remove it in Mac OS X. | + | //(If you used a real install CD, you can now remove it in OSX/macOS.)// |
===== Running Mac OS in SheepShaver ===== | ===== Running Mac OS in SheepShaver ===== | ||
==== First run, setup, basic functions ==== | ==== First run, setup, basic functions ==== | ||
Line 220: | Line 261: | ||
**The Configuration Assistant**\\ | **The Configuration Assistant**\\ | ||
When you launch SheepShaver, | When you launch SheepShaver, | ||
+ | |||
+ | **Better do not restart**\\ | ||
+ | Restarting may cause SheepShaver to freeze or crash. Instead, shut down and start again. | ||
**The Startup Disk control panel is not functional in SheepShaver**\\ | **The Startup Disk control panel is not functional in SheepShaver**\\ | ||
- | SheepShaver will startup from the first bootable volume in the Volumes list, or from a bootable CD if no bootable volume is in the list, or always from a bootable CD when "Boot From" is set to CD-ROM in Preferences. Trying to use the Startup Disk control panel may cause SheepShaver to crash. | + | SheepShaver will startup from the first bootable volume in the Volumes list, or from a bootable CD if no bootable volume is in the list, or always from a bootable CD when "Boot From" is set to CD-ROM in Preferences/Settings. Trying to use the Startup Disk control panel may cause SheepShaver to crash. |
**Enable sound in SheepShaver**\\ | **Enable sound in SheepShaver**\\ | ||
- | In " | + | In " |
+ | |||
+ | In Mac OS 8.5/8.6, and sometimes in 8.1, the Sound control panel is installed in the "Apple Extras" | ||
+ | |||
+ | If the "Apple Audio Extension" | ||
**Enable network access**\\ | **Enable network access**\\ | ||
- | Set the TCP/IP control panel to Ethernet and DHCP. As soon as you start using IP network access, for instance with a web-browser, | + | Set the TCP/IP control panel to Ethernet and DHCP. As soon as you start using IP network access, for instance with a web-browser, |
**QuickTime**\\ | **QuickTime**\\ | ||
The latest version of QuickTime that is compatible with SheepShaver is version 4.1.2. Note that it is not possible to downgrade QuickTime by simply installing an earlier version. If you happened to have installed a later version, you will need to remove all QuickTime related files first. | The latest version of QuickTime that is compatible with SheepShaver is version 4.1.2. Note that it is not possible to downgrade QuickTime by simply installing an earlier version. If you happened to have installed a later version, you will need to remove all QuickTime related files first. | ||
- | QuickTime 4.1.2 can be downloaded here: http://support.apple.com/kb/DL1134? | + | QuickTime 4.1.2 can be downloaded here: http://macintoshgarden.org/apps/quicktime-4 |
**CD-ROM**\\ | **CD-ROM**\\ | ||
- | To use a CD-ROM in SheepShaver, insert | + | You can use physical |
+ | |||
+ | OSX 10.8 and later prevents mounting physical CD-ROMs in SheepShaver. Use disk images instead. | ||
+ | |||
+ | **Mounting additional volumes**\\ | ||
+ | In Preferences/ | ||
+ | |||
+ | Most ' | ||
+ | |||
+ | Note that after any change in settings SheepShaver needs to be quit and launched again. | ||
+ | |||
+ | **Dynamically mount and unmount additional volumes while SheepShaver is running**\\ | ||
+ | This feature is available in 10 August 2023 and later builds. | ||
- | (OSX 10.8 and later prevents mounting physical | + | Dropping a disk image file from the host into the SheepShaver window will mount the volume as a read-only |
- | **Additional volumes**\\ | + | The mounted image can again be removed, in MacOS 8 and later by any available means (dragging onto Trash icon, from the Special menu, from the contextual menu), |
- | In Preferences you can create additional volumes | + | |
+ | Only one image file can be mounted at a time in this way. | ||
==== The shared folder / " | ==== The shared folder / " | ||
Line 249: | Line 309: | ||
**Transferring files**\\ | **Transferring files**\\ | ||
- | As explained above, the shared folder that you created in Mac OS X will appear on the SheepShaver desktop as a disk (a volume) named “Unix”. Files copied or saved in SheepShaver to the “Unix” disk, will appear in the shared folder on the Mac OS X side and files placed in the shared folder on the Mac OS X side will appear in the “Unix” disk in SheepShaver. That way you can use the shared folder and the “Unix” disk to transfer or exchange files in both directions. | + | As explained above, the shared folder that you created in OSX/ |
Exchanging files via the shared folder used to be crippled by many bugs. The most serious bugs have been solved but you may still encounter occasional unexpected behaviour while copying folders to and from the “Unix” disk. | Exchanging files via the shared folder used to be crippled by many bugs. The most serious bugs have been solved but you may still encounter occasional unexpected behaviour while copying folders to and from the “Unix” disk. | ||
Line 256: | Line 316: | ||
If you use the shared folder and “Unix” disk to transfer applications for use in SheepShaver, | If you use the shared folder and “Unix” disk to transfer applications for use in SheepShaver, | ||
- | Note that moving files directly from the “Unix” disk onto the SheepShaver desktop, does not copy them to the startup system volume. Those files will still be on the “Unix” disk, in fact inside the folder “Desktop Folder” in the shared folder. | + | Note that moving files directly from the “Unix” disk onto the SheepShaver desktop, does not copy them to the startup system volume. Those files will still be on the “Unix” disk, in fact inside the folder “Desktop Folder” in the shared folder. If you want to copy files from the " |
**Trashing files**\\ | **Trashing files**\\ | ||
- | Trashing files from the shared folder should be done at the Mac OS X side. On the Mac OS side, the trash cannot be emptied when it contains files from the " | + | Trashing files from the shared folder should be done on the OSX/ |
- | + | ||
- | ==== Mounting disk images ==== | + | |
- | + | ||
- | === === | + | |
- | + | ||
- | Most ' | + | |
- | + | ||
- | Disk images created with Disk Utility in Mac OS X can be mounted the same way, provided the format chosen while creating the image is either " | + | |
- | + | ||
- | A system install CD image file must be locked in Mac OS X Finder Get Info because the installer will refuse to work on writeable media. Locking the file is usually not needed for other CD images, but it can be used as a precaution to make sure the content of the image is not changed. | + | |
==== Printing ==== | ==== Printing ==== | ||
Line 285: | Line 335: | ||
=== === | === === | ||
- | SheepShaver can be set to run full-screen | + | SheepShaver can run full-screen. |
- | + | ||
- | While SheepShaver is running full-screen, | + | |
- | + | ||
- | The latest SheepShaver build makes that easy with a new feature: **fullscreen/ | + | |
- | \\ | + | While SheepShaver is running full-screen, the OSX/macOS environment cannot be accessed. That includes the OSX/macOS menu bar and thus SheepShaver Preferences/ |
- | \\ | + | |
- | + | ||
- | With older builds, if you want to go back to running SheepShaver in window mode, you can use the stand-alone preferences editor: | + | |
- | + | ||
- | http://www.xs4all.nl/ | + | |
- | + | ||
- | Or you can edit the related line in the prefs file in a text editor: | + | |
- | + | ||
- | Window mode and 1024x769 resolution: | + | |
- | screen win/ | + | |
- | + | ||
- | Fullscreen mode and 1024x769 resolution: | + | |
- | screen dga/ | + | |
- | + | ||
- | Fullscreen mode and maximum resolution: | + | |
- | screen dga/0/0 | + | |
+ | In SheepShaver settings, in the Audio / Video tab, you can set SheepShaver to start up in full-screen mode by setting “Video Type” to “Fullscreen”. Control-Return toggling between full-screen mode and window mode will then also work. | ||
+ | **Mission Control and Spaces** | ||
+ | The 64-bit 2.5 version SheepShaver builds (Mac OS X 10.7 and later only) will behave much like other applications in full-screen mode. It is compatible with Mission Control and you can easily switch between SheepShaver in full-screen mode and other applications in full-screen mode or the desktop using the swipe gesture that moves between spaces. | ||
===== Virtual machines ===== | ===== Virtual machines ===== | ||
Line 315: | Line 348: | ||
=== === | === === | ||
- | SheepShaver for OS X supports self-contained virtual machines. These virtual machines are packages with all needed files inside. They are portable to any compatible | + | SheepShaver for OSX/ |
- | The feature was added to SheepShaver in 2009. It was discussed in the forum here:\\ | + | Apart from the .sheepvm package creation, the setup is identical |
- | http:// | + | |
- | + | ||
- | These instructions are about self-contained .sheepvm packages. A way to manage multiple virtual machines from one setup window will be described under " | + | |
- | + | ||
- | Apart from the .sheepvm package creation, the setup is similar | + | |
**1. A SheepShaver application needs to be present on your machine.** | **1. A SheepShaver application needs to be present on your machine.** | ||
Line 333: | Line 361: | ||
- Add a .sheepvm extension to the folder name\\ | - Add a .sheepvm extension to the folder name\\ | ||
- | When you add the extension, the folder will change into a package with a SheepShaver icon. I will refer to it as the VM. | + | As soon as you add the extension, the folder will change into a package with a SheepShaver icon. I will refer to it as the VM. |
**3. Double-click the VM icon.**\\ | **3. Double-click the VM icon.**\\ | ||
- | SheepShaver will start and you can set up the VM in SheepShaver | + | SheepShaver will start and you can set up the VM in SheepShaver |
- | Multiple different | + | VMs are portable and will work on any compatible OSX/macOS system that has SheepShaver installed. If a SheepShaver.app is added to the VM, it is portable as one single package to machines that do not have SheepShaver installed. * * |
- | VMs are portable and will work on any compatible Mac OS X system that has SheepShaver installed. If a SheepShaver.app is added to the VM, it is portable as one single package to machines that do not have SheepShaver installed. | + | You can add or remove files to/from the VM by opening |
== == | == == | ||
- | //The VM will not necessarily use the SheepShaver application inside. The VM behaves as a SheepShaver document that will be opened with the " | + | //* The empty " |
+ | //* * Note that the VM will not necessarily use the SheepShaver application inside. The VM behaves as a SheepShaver document that will be opened with the " | ||
=== === | === === | ||
- | You can add or remove files to/from the VM by opening it in the Finder: Select the VM, right-click (or control-click) on the icon and choose "Show Package Contents" | ||
- | * The empty " | + | ===== Additional features ===== |
- | ==== SheepShaverLauncher | + | |
+ | === === | ||
- | ===== Uninstalling SheepShaver | + | Some features are not mentioned elsewhere in this manual: |
+ | |||
+ | **Grabbing mouse cursor toggle**\\ | ||
+ | Control-F5 will contain the mouse cursor within the SheepShaver window. This may be useful with some games. | ||
+ | |||
+ | Cursor grab is fully functional in version 2.4 builds. In 2.5 version builds it will only work with the (default) software cursor, not if the hardware cursor is enabled (see below under Advanced features). | ||
+ | ===== Advanced features (Version 2.5 builds only) ===== | ||
=== === | === === | ||
- | To uninstall SheepShaver, | + | **These features can be activated by manually editing settings |
- | Then remove | + | **• Hardware cursor in window mode**\\ |
- | | + | The version 2.5 builds use a different way to display |
- | | + | |
+ | However, with the hardware cursor only in window mode, the cursor issues in version 2.4 when switching between window mode and full-screen mode will also return. (See below under Known issues.) | ||
- | That's it! | + | **• Hardware cursor in both window mode and full-screen mode** (29 March 2019 and later builds)\\ |
- | =====Known issues===== | + | The hardware cursor can also be used in full-screen mode if integer scaling is used. You can enable the hardware cursor in both window mode and full-screen mode by adding these lines to the preferences file |
+ | hardcursor true | ||
+ | scale_integer true | ||
+ | scale_nearest true | ||
+ | See also " | ||
- | ====All Builds==== | + | **• Changing the hotkey**\\ |
+ | By default, the hotkey used with window/ | ||
- | === === | + | 1: control(default)\\ |
+ | 2: option\\ | ||
+ | 3: control+option\\ | ||
+ | 4: command\\ | ||
+ | 5: control+command\\ | ||
+ | 6: option+command\\ | ||
+ | 7: control+option+command | ||
- | **On PPC machines**\\ | + | For instance, you can set the hotkey to Control-Command by adding this line to the preferences file: |
- | SheepShaver | + | hotkey 5 |
+ | |||
+ | **• Changing reported CPU speed** (16 January 2019 and later builds)\\ | ||
+ | SheepShaver | ||
+ | cpuclock 200 | ||
+ | This line wil make SheepShaver identify itself as a 200MHz machine.\\ | ||
+ | **Note: **This setting does not change the actual speed! | ||
- | **Crash at startup**\\ | + | **• Offset date in years and/or days** (20 February 2019 and later builds)\\ |
- | On some host machines | + | The date inside SheepShaver can be set in the past or in the future, in years and/ |
+ | Adding these lines to the preferences file will set the date to 25 February 1989 when the actual date on the host is 20 February 2019: | ||
+ | yearofs -30 | ||
+ | dayofs +5 | ||
+ | **Note: **This feature can mix up relations between older files and newer files and between files' creation dates and modification dates. It should only be used by experienced users who know what they are doing, preferably in a separate | ||
- | The exact cause of the crash is not known, but in most cases it can be prevented | + | **• Changing scaling algorithm** (Works as intended in 24 February 2019 and later builds)\\ |
+ | Using nearest-neighbour or integer scaling will improve display quality when a low resolution emulator screen | ||
+ | scale_integer true | ||
+ | scale_nearest true | ||
- | Download: http:// | + | **• Enlarging window size** (22 September 2020 and later builds)\\ |
+ | Enlarge SheepShaver window while preserving guest screen resolution. At next launch, the window will appear twice the set resolution when this line is added to the preferences file: | ||
+ | mag_rate 2 | ||
- | **CD-ROMs in OSX 10.8 (Mountain Lion) and later**\\ | + | **• Guest gamma ramp pass on to the host** |
- | OSX 10.8 and later prevent mounting of physical CD-ROMs in SheepShaver. Use CD disk images instead.\\ | + | With this feature enabled, the guest gamma settings will be passed on to the host. This could improve color and brightness accuracy, but only when guest gamma settings and host screen properties match. The guest gamma settings will usually not match with modern screens. There are three possible settings: |
+ | gammaramp off | ||
+ | gammaramp on | ||
+ | gammaramp fullscreen | ||
+ | The default is " | ||
- | To create a disk image: \\ | + | **• Port forwarding |
- | - Mount the CD in OSX \\ | + | For instance: |
- | - Start Disk Utility (in the / | + | redir tcp: |
- | - Select the CD in the list on the left\\ | + | See this forum topic: https://www.emaculation.com/ |
- | - Click New Image in the tool bar (in newer Disk Utility versions use New Image from the File menu)\\ | + | |
- | - Choose DVD/CD master for the format\\ | + | |
- | - Click Save\\ | + | |
- | - Place the image file where you want to use it and then lock the file in the OSX Finder (checkbox in the Finder Info panel for the file).\\ | + | |
- | - Use the SheepShaver preferences editor to add the image to the volumes list. Shut down and restart SheepShaver. The CD will show up on the desktop.\\ | + | |
- | In some cases, when the CD has a special format or when the software insists that the original CD needs to be present, you need to use the **Virtual DVD-ROM/CD Utility** to get a CD image to mount in SheepShaver. | + | **• Set custom window title** (27 February 2021 and later builds)\\ |
+ | By adding a prefs item title one can choose | ||
+ | title SheepShaver Mac OS 9.0.4 | ||
+ | |||
+ | **• Shorten the sound buffer** (17 March 2021 and later builds)\\ | ||
+ | Shortening the the length of the sound buffer can prevent delayed and choppy sound in some applications but will increase CPU use. The default setting is: | ||
+ | sound_buffer 0 | ||
+ | Setting the value to 1 will halve the length of the sound buffer, setting the value to 2 will again halve the length, and so forth. | ||
- | Download: http:// | + | **• File name encoding in " |
+ | Classic MacOS files in the shared folder with non-MacRoman file names will show incorrect or garbled file names in the " | ||
- | - Start SheepShaver.\\ | + | 1: Japanese\\ |
- | - Install the Virtual DVD-ROM/CD Utility\\ | + | 2: Chinese Traditional\\ |
- | - Create a new volume with the preferences editor, large enough to hold the contents of the CD image you will create. For one CD image, 800 Mb should be enough. You can create a larger volume to hold more such CD images.\\ | + | 3: Korean\\ |
- | - Shut down and restart SheepShaver. The new disk image will need to be initialized.\\ | + | 4: Arabic\\ |
- | - Use the preferences editor to add the CD image you created earlier in OSX (see above) to the volumes list.\\ | + | 5: Hebrew\\ |
- | - Shut down SheepShaver, | + | 6: Greek\\ |
- | - Launch the Virtual DVD-ROM/CD Utility, click the button " | + | 7: Cyrillic\\ |
- | - Save the new image to the large volume you created for this purpose.\\ | + | 25: Chinese Simplified |
- | - Unmount the first CD volume from MacOS, remove the CD image from the volumes list, save, and shut down SheepShaver.\\ | + | |
- | - Start again SheepShaver and launch the Virtual DVD-ROM/CD Utility, click the button "Mount Toast .ati file as Virtual DVD-ROM" | + | |
- | ==== 11 February | + | For instance, adding this line to the preferences file will correct Japanese characters: |
+ | name_encoding 1 | ||
+ | When " | ||
+ | A full list of encodings can be found here: https:// | ||
+ | |||
+ | **• Startup with mouse cursor grabbed** (28 February | ||
+ | The mouse cursor grabbing feature (toggle with Control-F5, see above) is normally off by default. It will be on by default if this line is added to the prefs file: | ||
+ | init_grab true | ||
+ | |||
+ | (The mouse grabbing feature will not work if the hardware cursor is enabled, see above.) | ||
+ | |||
+ | |||
+ | ===== Uninstalling SheepShaver ===== | ||
=== === | === === | ||
- | **On PPC machines**\\ | + | To uninstall SheepShaver, |
- | These later builds appear | + | |
- | http://www.xs4all.nl/ | + | Depending on your SheepShaver history, SheepShaver may have written up to 10 small files in various locations in your Home folder. If you want to also delete all of these files, run the " |
+ | =====Known issues===== | ||
- | (That build will present on PPC an " | + | ==== All 2018 and later builds ==== |
- | **On Intel machines**\\ | + | === === |
- | After minimizing or hiding the SheepShaver window and again bringing it back in view, colors in the window will not be displayed correctly. It can be resolved by forcing the emulator to redraw its screen by changing (and changing back) the color depth setting in Monitors control panel or from the color depth control strip tile. | + | |
- | If you find this issue very disturbing | + | **Crash at startup**\\ |
+ | On some host machines | ||
- | http://www.xs4all.nl/~ronaldpr/ | + | Most of these crashes can be prevented by checking “Ignore Illegal Memory Accesses” in Miscellaneous tab in SheepShaver settings as advised in the configuration directions above. When it is impossible to start SheepShaver because of the crash, you can move the startup volume temporarily to a different location. Then you can launch SheepShaver to the screen with blinking question mark and access Preferences/Settings. |
+ | |||
+ | **Bug with the mount image as CD-ROM feature**\\ | ||
+ | Unintended behaviour when you try to remove/eject a virtual CD-ROM from within SheepShaver which under some circumstances can only be resolved by quitting SheepShaver. | ||
+ | |||
+ | This issue can be avoided by only adding and removing disk images as CD-ROM in the Volumes list in SheepShaver settings. (As always: After a change in settings, quit SheepShaver and launch it again for the change to take effect.) | ||
+ | |||
+ | **Note:** This bug affects disks mounted as CD-ROM by adding them to the volumes list and checking the CDROM box in SheepShaver Preferences/Settings. It does not affect disks that are dynamically mounted and unmounted as CD-ROM while SheepShaver is running. (See above about this feature that is available in the 10 August 2023 and later builds.) | ||
+ | ==== Version 2.4 (9 July 2018) build ==== | ||
+ | |||
+ | === === | ||
- | **In 64-bit mode in Snow Leopard**\\ | + | **Cursor issues when switching between window mode and full-screen |
- | Serious cursor problems with clicking in the menu bar in full-screen mode. Use SheepShaver in 32-bit mode if you want to use it full-screen. | + | When you switch from window to full-screen mode using Control-Return before |
- | ==== 1 February 2014 build ==== | + | When you switch from full-screen to window mode using Control-Return, |
+ | ==== Version 2.5 builds | ||
=== === | === === | ||
- | When you switch from window to full-screen mode using Ctrl-Return before you used the mouse cursor in the emulator at least once, you may loose the cursor. One click on the desktop or pressing the control key suffices to bring back the cursor. | + | **CapsLock issue**\\ |
+ | If SheepShaver is launched while CapsLock is active, typed text may not correctly reflect | ||
+ | One press on the CapsLock key will correct the issue. |