Bring nostalgia to your desktop, run Mac OS 9.22 version from your current apple laptop or desktop using qemu pcc emulator software!


====== Requirements ======

  * XCode
  * [[:brew]]
  * [[http://macos9lives.com/smforum/index.php?topic=2109.0|ISO of MacOS 9.22]] put it to **~/emulation/iso/** folder

====== Prepare source ======
<code>
mkdir ~/emulation
cd ~/emulation
git clone -b screamer https://github.com/mcayland/qemu qemu-screamer
cd qemu-screamer
./configure --target-list="ppc-softmmu" \
              --audio-drv-list="coreaudio"
make -j4
</code>

====== Create HD for Mac OS 9 ======

<code>
cd ~/emulation
mkdir data
./qemu-screamer/build/qemu-img create -f qcow2 data/macos92.img 60G
</code>


====== Install Mac OS 9 ======

<code>
cd ~/emulation
./qemu-screamer/build/ppc-softmmu/qemu-system-ppc \
    -L ~/emulation/qemu-screamer/build/pc-bios \
    -cpu "g4" \
    -M mac99,via=pmu \
    -m 512 \
    -hda ~/emulation/data/macos92.img \
    -cdrom ~/emulation/iso/Mac\ OS\ 9.2.2\ Universal\ Inst.iso \
    -boot d \
    -g 1024x768x32 \
    -device usb-kbd \
    -device usb-mouse
</code>

{{::macos9emulation-quemu-ppc_pav1.png?600|}}

{{::macos9emulation-quemu-ppc_pav2.png?600|}}

Once it starts up, you will be able to run Disk Initializer to format your hard drive image. Go ahead and do that, using Mac OS HFS Extended as the file system. One partition is good.

After initializing the disk, run Apple System Restore with the Mac OS 9 Lives disk image as the source and your disk as the destination. This will take a minute to restore. Once done, shut down the emulated system (Special Menu -> Shut Down).

====== Boot Mac OS 9 ======

<code>
cd ~/emulation
./qemu-screamer/build/ppc-softmmu/qemu-system-ppc \
    -L ~/emulation/qemu-screamer/build/pc-bios \
    -cpu "g4" \
    -M mac99,via=pmu \
    -m 512 \
    -hda ~/emulation/data/macos92.img \
    -boot c \
    -g 1024x768x32 \
    -device usb-kbd \
    -device usb-mouse
</code>


====== App bundle script ====== 

The script will look like app and will launch virtual machine of your MacOS 9.22 installation immediately. You must first install [[appify]] script on your system. Now create this shell script and **appify** it.

<code>
#!/usr/bin/env sh

~/emulation/qemu-screamer/build/ppc-softmmu/qemu-system-ppc \
    -L ~/emulation/qemu-screamer/build/pc-bios \
    -cpu "g4" \
    -M mac99,via=pmu \
    -m 512 \
    -hda ~/emulation/data/macos92.img \
    -boot c \
    -g 1024x768x32 \
    -device usb-kbd \
    -device usb-mouse
</code>

Save it as **macos9**, give it a executable permissions and appify it:
<code>
chmod +x macos9 
appify macos9 macos-9
</code>

{{::macos9emulation-quemu-ppc_pav3.png?400|}}

The corresponding app bundle will be created. It will be easier to run virtual machine now. You can also [[https://9to5mac.com/2021/11/08/change-mac-icons/|change its icon]] to [[https://macosicons.com/|look more nicer]].

{{::macos9emulation-quemu-ppc_pav4.png?400|}}

Then you can drop it to the desktop or dock and enjoy!


====== Useful tips ======

===== Extensions optimization =====

  * [[Mac OS 9 System Extensions optimization guide]]

===== Blue screen after install =====

It can be easily turned off by pressing CMD+Q

===== Mouse escape from qemu =====

Press CTRL+ALT+G

===== 256 Colours =====

To support 256 colours you will need to add a bios driver. See the [[https://www.emaculation.com/forum/viewtopic.php?f=34&t=9518|EMaculation forums]] for instructions; it involves replacing a file in the pc-bios directory with an older version that still supports 256 colours.

===== Change screen resolution =====

You can change resolution from MacOS 9 Main menu Apple > Control Panels > Monitors.




----


  * [[https://www.jamesbadger.ca/2018/11/07/emulate-mac-os-9-with-qemu/|Original source]]

{{keywords>macos classic, emulation,macos9 emulation,macos emulation,vintage mac emulation,old mac emulation,emulator,powerpc emulator}}