# Fruit Jam Mac Emulator
## Overview
What's the first thing you want to do with your Fruit Jam? Run a Mac emulator of course! Intrepid CircuitPython core developer [jepler](https://learn.adafruit.com/u/jepler) forked the [pico-mac emulator](https://github.com/adafruit/pico-mac) and made it run smoothly like fresh jam spread on toast for the Fruit Jam. This means video output via HSTX, PIO USB, PSRAM support and even audio output from the onboard I2S DAC.
The pico-mac emulator embeds the [umac Mac 128K emulator](https://github.com/evansm7/umac) to run on a Raspberry Pi Pico/Pico2. It's been tested with System 2.0 up to System 7.5.5 for a wide range of emulation options.
The Adafruit fork of the emulator [provides pre-compiled UF2's](https://github.com/adafruit/pico-mac/releases) that you can drag and drop onto the Fruit Jam to get started right away. This guide provides a disk image ( **.IMG** file) that you can use or you can bring your own.
## Parts
Featured
### Adafruit Fruit Jam - Mini RP2350 Computer
[Adafruit Fruit Jam - Mini RP2350 Computer](https://www.adafruit.com/product/6200)
We were catching up on a recent [hackaday hackchat with eben upton](https://hackaday.io/event/202122-raspberry-pi-hack-chat-with-eben-upton) and learned some fun facts: such as the DVI hack for the RP2040 was inspired by
In Stock
[Buy Now](https://www.adafruit.com/product/6200)
[Related Guides to the Product](https://learn.adafruit.com/products/6200/guides)
Featured
### 512MB micro SD Memory Card
[512MB micro SD Memory Card](https://www.adafruit.com/product/5252)
Add storage in a jiffy using this **512MB** microSD card. Preformatted to FAT32, so it works out of the packaging with our projects. Works great with any device in the Adafruit shop that uses microSD cards. Ideal for use with Feathers, data loggers, or small Linux SBCs (not good...
In Stock
[Buy Now](https://www.adafruit.com/product/5252)
[Related Guides to the Product](https://learn.adafruit.com/products/5252/guides)
Featured
### Mini Chiclet Keyboard - USB Wired - Black
[Mini Chiclet Keyboard - USB Wired - Black](https://www.adafruit.com/product/1736)
Add a good quality, slim keyboard to your Raspberry Pi, Beagle Bone Black, or other single-board-computer with this sleek black chiclet keyboard. It's a full QWERTY keyboard with a USB cable and is compatible with all operating systems. We tried many keyboards to find one that felt...
In Stock
[Buy Now](https://www.adafruit.com/product/1736)
[Related Guides to the Product](https://learn.adafruit.com/products/1736/guides)
Featured
### USB Wired Mouse - Two Buttons plus Wheel
[USB Wired Mouse - Two Buttons plus Wheel](https://www.adafruit.com/product/2025)
This is a mouse. A nice, simple mouse. No bells or whistles. Just a mouse.
But that doesn't mean it's not the best simple mouse! We compared a few and liked this one quite a bit. It's optical for good resolution and precision, has two...
In Stock
[Buy Now](https://www.adafruit.com/product/2025)
[Related Guides to the Product](https://learn.adafruit.com/products/2025/guides)
Featured
### Pink and Purple Woven USB A to USB C Cable - 2 meters long
[Pink and Purple Woven USB A to USB C Cable - 2 meters long](https://www.adafruit.com/product/5044)
This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also made for USB C for our modernized breakout boards, Feathers and more. [If you want something just like it but for Micro B, we have a B...](https://www.adafruit.com/product/4111)
Out of Stock
[Buy Now](https://www.adafruit.com/product/5044)
[Related Guides to the Product](https://learn.adafruit.com/products/5044/guides)
Featured
### 7" Display 1280x800 (720p) IPS + Speakers - HDMI/VGA/NTSC/PAL
[7" Display 1280x800 (720p) IPS + Speakers - HDMI/VGA/NTSC/PAL](https://www.adafruit.com/product/1667)
Yes, this is an adorable small HDMI television with incredibly high resolution **and built in 3W stereo speakers**! We tried to get the smallest possible HDMI/VGA display with high-res, high-contrast visibility. The visible display measures only 7" (17.8cm) diagonal, and the TFT comes...
In Stock
[Buy Now](https://www.adafruit.com/product/1667)
[Related Guides to the Product](https://learn.adafruit.com/products/1667/guides)
# Fruit Jam Mac Emulator
## Software Prep
There are two steps to running the pico-mac emulator on the Fruit Jam: the pico-mac firmware and a Mac HFS image on a microSD card. The firmware is available as a precompiled UF2 in the [GitHub repository in the latest release.](https://github.com/adafruit/pico-mac/releases)
[Pre-compiled pico-mac UF2 files](https://github.com/adafruit/pico-mac/releases)
There are a few UF2 files to choose from with different resolution and overclock settings:
- 400kB or 4096kB (the latter uses PSRAM, and may perform slower overall but can run more software)
- 512x342 or 640x480 desktop resolution (512x342 is more compatible but has black screen margins)
- Overclocked or not (overclocked may run faster but may be less reliable)
Choose whichever one suits your emulation needs and proceed to put the Fruit Jam into bootloader mode. To enter the bootloader, hold down the **BOOT/**** BUTTON #1 button **(highlighted in red below), and while continuing to hold it (don't let go!), press and release the **reset button **(highlighted in blue below).**Continue to hold the BOOT/BUTTON #1 button until the RP2350 drive appears!**
Info: If you're using the .IMG file below, use the **pico-mac-adafruit\_fruit\_jam-4096k-512x342-psram-oc.uf2**
**Drag and drop the pico-mac UF2 file** that you chose onto the Fruit Jam. The RP2350 drive will disappear. Next, you'll prep the microSD card.
## microSD Card
You'll need to set up a Mac HFS disk image ( **.IMG** file) on a FAT-formatted microSD card. There are a lot of disk images for Mac emulation on [archive.org](https://archive.org/). The image below has been tested with the pico-mac emulator on a Fruit Jam and has popular shareware software included if you want to retreat quickly to the early 90's.
[macImage.zip](https://cdn-learn.adafruit.com/assets/assets/000/138/817/original/macImage.zip?1754490678)
After formatting your microSD card, save your **.IMG** file onto it. If you want the image to be **read-only** , save it as **umac0ro.img**. If you want to be able to **read and write** to the image, you'll save it as **umac0w.img**. The **.IMG** file should be the only file on the microSD card.
The ONLY file that should be on the microSD card is the **.IMG** file. Sometimes macOS adds hidden metadata files and folders on mass storage devices. If you find you're having issues booting into the image and you're using macOS, check the card for these files.
Warning: The ONLY file that should be on the microSD card is the .IMG file! Make sure to delete any extra hidden files or folders.
## Advanced Hackers Enter Here
If these steps to Mac emulation were too easy for you and you need to experience the trial and error of compilation and corrupted files then check out the options below for deep rabbit holes to burrow into in the pursuit of the ideal retro Mac experience.
### Build-Your-Own pico-mac (Advanced)
There are [build instructions for pico-mac](https://github.com/adafruit/pico-mac?tab=readme-ov-file#build) if you want to build your own UF2 file instead of using the pre-compiled UF2 images. You will need the [Pico/RP2040 SDK](https://github.com/raspberrypi/pico-sdk) setup on your machine.
### Customizing the Disk Image (Advanced)
If you want to customize your disk image, you'll want to run an emulator on your desktop computer so that you can load software from your file system onto it. The [Mini vMac emulator](https://www.gryphel.com/c/minivmac/dnld_std.html) works really well for this. Documentation about this emulator is available from the [Gryphel Project](https://www.gryphel.com/c/minivmac/index.html).
When the emulator starts up, you'll load the disk image that you want to build on. You can install additional software onto the image and then try out the **.IMG** file with the pico-mac emulator on the Fruit Jam. You will need to rename the **.IMG** file as either **umac0ro.img** or **umac0w.img** on the microSD card.
# Fruit Jam Mac Emulator
## Hardware Prep
To experience the vintage beeps of the Mac, plug in the oval speaker JST plug into the speaker port on the Fruit Jam.
Then, attach the top plate to the Fruit Jam with the three included screws.
Plug an HDMI cable into the DVI port on the Fruit Jam for video output to a monitor or TV. Use a USB-C cable for powering the Fruit Jam.
Grab a USB keyboard and mouse and plug them into the USB ports on the Fruit Jam.
Insert the microSD card with the Mac HFS volume that you prepped on the Software page into the microSD slot on the Fruit Jam.
Now you're ready to boot back into the early 90's!
# Fruit Jam Mac Emulator
## Use
You've got your UF2 loaded, your disk image on the microSD card and the Fruit Jam hardware gathered. It's time for some Mac emulation!
Flip the Fruit Jam **ON/OFF** switch to **ON**. You should hear the **BEEP** from the onboard speaker to let you know that the Mac is booting. Then, you'll see the desktop load.
Now its time to kick back and relax with a session of Crystal Quest.
Or maybe Battle Chess?
When you're ready to take a break, save your screen with some flying toasters or vibe with Fish! from the After Dark 2 collection.
## Guide Products
### Adafruit Fruit Jam - Mini RP2350 Computer
[Adafruit Fruit Jam - Mini RP2350 Computer](https://www.adafruit.com/product/6200)
We were catching up on a recent [hackaday hackchat with eben upton](https://hackaday.io/event/202122-raspberry-pi-hack-chat-with-eben-upton) and learned some fun facts: such as the DVI hack for the RP2040 was inspired by
In Stock
[Buy Now](https://www.adafruit.com/product/6200)
[Related Guides to the Product](https://learn.adafruit.com/products/6200/guides)
### 512MB micro SD Memory Card
[512MB micro SD Memory Card](https://www.adafruit.com/product/5252)
Add storage in a jiffy using this **512MB** microSD card. Preformatted to FAT32, so it works out of the packaging with our projects. Works great with any device in the Adafruit shop that uses microSD cards. Ideal for use with Feathers, data loggers, or small Linux SBCs (not good...
In Stock
[Buy Now](https://www.adafruit.com/product/5252)
[Related Guides to the Product](https://learn.adafruit.com/products/5252/guides)
### Mini Chiclet Keyboard - USB Wired - Black
[Mini Chiclet Keyboard - USB Wired - Black](https://www.adafruit.com/product/1736)
Add a good quality, slim keyboard to your Raspberry Pi, Beagle Bone Black, or other single-board-computer with this sleek black chiclet keyboard. It's a full QWERTY keyboard with a USB cable and is compatible with all operating systems. We tried many keyboards to find one that felt...
In Stock
[Buy Now](https://www.adafruit.com/product/1736)
[Related Guides to the Product](https://learn.adafruit.com/products/1736/guides)
### USB Wired Mouse - Two Buttons plus Wheel
[USB Wired Mouse - Two Buttons plus Wheel](https://www.adafruit.com/product/2025)
This is a mouse. A nice, simple mouse. No bells or whistles. Just a mouse.
But that doesn't mean it's not the best simple mouse! We compared a few and liked this one quite a bit. It's optical for good resolution and precision, has two...
In Stock
[Buy Now](https://www.adafruit.com/product/2025)
[Related Guides to the Product](https://learn.adafruit.com/products/2025/guides)
### Pink and Purple Woven USB A to USB C Cable - 2 meters long
[Pink and Purple Woven USB A to USB C Cable - 2 meters long](https://www.adafruit.com/product/5044)
This cable is not only super-fashionable, with a woven pink and purple Blinka-like pattern, it's also made for USB C for our modernized breakout boards, Feathers and more. [If you want something just like it but for Micro B, we have a B...](https://www.adafruit.com/product/4111)
Out of Stock
[Buy Now](https://www.adafruit.com/product/5044)
[Related Guides to the Product](https://learn.adafruit.com/products/5044/guides)
### Slim HDMI Cable - 900mm / 3 feet long
[Slim HDMI Cable - 900mm / 3 feet long](https://www.adafruit.com/product/2421)
Connect two HDMI devices together and save space with this slim, high quality HDMI cable. It has nice molded grips for easy installation and is 914mm long (~3 feet). Sporting a teeny 4mm diameter this cable stays out of your way!
We also have slim HDMI cables at
No Longer Stocked
[Buy Now](https://www.adafruit.com/product/2421)
[Related Guides to the Product](https://learn.adafruit.com/products/2421/guides)
### 7" Display 1280x800 (720p) IPS + Speakers - HDMI/VGA/NTSC/PAL
[7" Display 1280x800 (720p) IPS + Speakers - HDMI/VGA/NTSC/PAL](https://www.adafruit.com/product/1667)
Yes, this is an adorable small HDMI television with incredibly high resolution **and built in 3W stereo speakers**! We tried to get the smallest possible HDMI/VGA display with high-res, high-contrast visibility. The visible display measures only 7" (17.8cm) diagonal, and the TFT comes...
In Stock
[Buy Now](https://www.adafruit.com/product/1667)
[Related Guides to the Product](https://learn.adafruit.com/products/1667/guides)
## Related Guides
- [Using a Mouse with USB Host](https://learn.adafruit.com/using-a-mouse-with-usb-host.md)
- [Using a Keyboard with USB Host](https://learn.adafruit.com/using-a-keyboard-with-usb-host.md)
- [Adafruit Fruit Jam](https://learn.adafruit.com/adafruit-fruit-jam.md)
- [Deco Two-Key Feather Macro Pad](https://learn.adafruit.com/deco-two-key-keypad-macropad-circuitpython-feather.md)
- [Fruit Jam Sega Genesis](https://learn.adafruit.com/fruit-jam-sega-genesis.md)
- [Apple IIe Fruit Jam Enclosure](https://learn.adafruit.com/apple-iie-fruit-jam-enclosure.md)
- [Larsio Paint Music](https://learn.adafruit.com/larsio-paint-music.md)
- [MCUME Emulators on Fruit Jam](https://learn.adafruit.com/mcume-emulators-on-fruit-jam.md)
- [CircuitPython Chiptune Player](https://learn.adafruit.com/circuitpython-chiptune-player.md)
- [Intel 286 Emulator on Fruit Jam](https://learn.adafruit.com/intel-286-emulator-on-fruit-jam.md)
- [Return to The Matrix with the Metro RP2350 or Fruit Jam](https://learn.adafruit.com/return-to-the-matrix-with-the-metro-rp2350.md)
- [Talking HAL 9000 with RP2040 Prop Maker Feather](https://learn.adafruit.com/hal-9000-rp2040-prop-maker.md)
- [LED Matrix Alarm Clock](https://learn.adafruit.com/led-matrix-alarm-clock.md)
- [Tandy 1000 Keyboard to USB with CircuitPython](https://learn.adafruit.com/tandy-1000-keyboard-to-usb-with-circuitpython.md)
- [Tile-Matching Game on the Fruit Jam and Metro RP2350](https://learn.adafruit.com/tile-matching-game-on-the-adafruit-metro-rp2350.md)
- [ESP-NOW Walkie Talkies](https://learn.adafruit.com/esp-now-walkie-talkies.md)
- [Owl IR TV Remote](https://learn.adafruit.com/owl-ir-tv-remote.md)