# Troubleshooting

## SheepShaver doesn't boot

SheepShaver should boot all MacOS versions >=7.5.2, except MacOS X. However, your mileage may vary. If it doesn't boot, try again with extensions disabled (by pressing the shift key) and then remove some of these extensions: "MacOS Licensing Extension", Speed Doubler, 68k FPU extensions and MacsBug.

## The colors are wrong in 16 or 32 bit graphics modes

If you're running SheepShaver on a BeBox, the only graphics modes that have the right colors are the 8 bit modes (this is actually a hardware problem and has to do with frame buffers being little-endian on the BeBox), unless you are using a Matrox Milennium I/II.

You should also be aware that not all graphics cards support 16 bit modes under BeOS (especially S3 cards don't). Check the BeOS "Screen" preferences application to see if your card does.

## SheepShaver appears to be very slow

- Don't use the window modes, the fullscreen modes are much faster.
- If you nevertheless want (or have) to use a window mode, you should set the color depth in MacOS to the same as the BeOS workspace you are running SheepShaver on (e.g. if you are on a 16-bit workspace, set the color depth in MacOS to "Thousands"). Also, set the window refresh rate to a low value (high values like 30Hz will make SheepShaver (and BeOS) slower, not faster!).

## Full-screen mode doesn't work

If your machine uses the "IXMicro" BeOS video driver (TwinTurbo cards), you will have to disable the "QuickDraw Acceleration" in the "Video" pane of the SheepShaver settings.

## Ethernet doesn't work

- Is the Ethernet set up under BeOS? Ethernet will not work in SheepShaver if you didn't set it up in the BeOS "Network" preferences.
- If you're using TCP/IP on the MacOS side, you have to set up different IP addresses for the BeOS and for the MacOS.
- Try disabling AppleTalk in the BeOS Network preferences (there might be conflicts between BeOS AppleTalk and SheepShaver networking).

## SheepShaver crashes, but yesterday it worked

Try the "Zap PRAM File" item in the main menu of the SheepShaver preferences editor. When you are using a ROM file and switching to a different ROM version, you have to zap the PRAM file or SheepShaver might behave very weird.

## Known incompatibilities

- MacOS programs or drivers which access Mac hardware directly are not supported by SheepShaver.
- Speed Doubler, RAM Doubler, 68k FPU emulators and similar programs don't run under SheepShaver.
- MacsBug is not compatible with SheepShaver.
- If you want to run RealPC on a BeBox, you have to disable one CPU in the "Pulse" application or it will crash.

## Known bugs

- The QuickTime 2.5 Cinepak codec crashes the emulator.
- Programs that use InputSprockets crash the emulator when in window mode.
- The mouse cursor hotspot in window mode is not correct.