Modernized 68k Macintosh emulator for Apple Silicon Macs. This version has been updated to compile and run on modern macOS with Apple Silicon (M1/M2/M3) processors.
- Apple Silicon Support: Fully compatible with M1, M2, and M3 Macs
- Modern Xcode Project: Updated to use latest Xcode toolchain
- SDL2 Integration: Uses Homebrew's SDL2 for audio and video
- ARM64 Native: Runs natively on ARM architecture (no Rosetta required)
- Xcode (latest version from Mac App Store)
- Command Line Tools:
xcode-select --install
- Homebrew: Install from brew.sh
- SDL2:
brew install sdl2
You need a Macintosh ROM file to run the emulator:
- Supported: Macintosh II, Quadra, Centris, Performa ROMs (512KB)
- Classic ROMs (256KB) also supported
- Any filename is acceptable - just specify the path in preferences
-
Open the project:
open src/MacOSX/BasiliskII.xcodeproj
-
Select BasiliskII target
-
Choose Debug or Release configuration
-
Click Build (⌘+B)
# Build Debug version
xcodebuild -project src/MacOSX/BasiliskII.xcodeproj -scheme BasiliskII -configuration Debug build
# Build Release version
xcodebuild -project src/MacOSX/BasiliskII.xcodeproj -scheme BasiliskII -configuration Release buildThe built application will be in:
Build/Debug/BasiliskII.app(Debug)Build/Release/BasiliskII.app(Release)
You need to manually create the preferences file at:
~/.basilisk_ii_prefs
Create this file with the following default content:
# Required
rom /path/to/from_your_old_mac/MAC.ROM
ramsize 134217728 # 128MB RAM
bootdrive 0
bootdriver 0
# Disk/Folder (Optional)
# HFS/HFV disk images
disk /path/to/System7.5.img
disk /path/to/Games.img
#disk /path/to/OregonTrail.img
# Host folder sharing
# extfs /path/to/Shared
# Video/Audio
screen win/640/480/8 # 640x480, 8-bit color
frameskip 0
nosound false
# Network (disabled by default)
nonet true
# Serial ports
seriala /dev/null
serialb /dev/nullUpdate the ROM path in your preferences file to point to your actual Macintosh ROM file:
rom /path/to/from_your_old_mac/MAC.ROM# Command line
./Build/Debug/BasiliskII.app/Contents/MacOS/BasiliskII
# Or GUI
open Build/Debug/BasiliskII.appClassic games like Prince of Persia run perfectly with smooth graphics and sound on Apple Silicon Macs.
The preferences file should include:
# Required
rom /path/to/from_your_old_mac/MAC.ROM
ramsize 134217728 # 128MB RAM
bootdrive 0
bootdriver 0
# Disk/Folder (Optional)
# HFS/HFV disk images
disk /path/to/System7.5.img
disk /path/to/Games.img
#disk /path/to/OregonTrail.img
# Host folder sharing
# extfs /path/to/Shared
# Video/Audio
screen win/640/480/8 # 640x480, 8-bit color
frameskip 0
nosound false
# Network (disabled by default)
nonet true
# Serial ports
seriala /dev/null
serialb /dev/nullEdit ~/.basilisk_ii_prefs to modify settings:
ramsize 268435456 # 256MB RAMscreen win/800/600/16 # 800x600, 16-bit color
screen win/1024/768/32 # 1024x768, 32-bit color# Add HFS disk images
disk /path/to/System7.5.img
disk /path/to/Games.img# Share host folder with emulated Mac
extfs /Users/ay5/Documents/Shared.img- HFS disk images.hfv- Macintosh disk images.dsk- Generic disk images
- System Disk: 500MB - 1GB (for System 7.x)
- Games Disk: 100MB - 500MB
- Documents Disk: 100MB - 1GB
- Check the ROM file path in preferences
- Verify the file exists and is accessible
- Check file permissions
- Use supported ROM (Mac II, Quadra, Centris, Performa)
- Verify ROM file integrity
- Check file size (256KB or 512KB expected)
# Clean and rebuild
xcodebuild clean
xcodebuild -project src/MacOSX/BasiliskII.xcodeproj -scheme BasiliskII build# Reinstall SDL2
brew reinstall sdl2- Increase RAM allocation in preferences
- Use Release build instead of Debug
- Close other applications to free memory
- Try lower resolution or color depth
This Apple Silicon fork is based on the original Basilisk II project. Special thanks to the original contributors who made this emulator possible:
- Orlando Bassotto: FreeBSD support
- Gwenolé Beauchesne: SPARC assembly optimizations, Unix video code, JIT compiler fixes
- Marc Chabanas: Solaris sound support
- Marc Hellwig: audio output, BeOS video code and networking
- Bill Huey: 15/16 bit DGA and 15/16/32 bit X11 window support
- Brian J. Johnson: IRIX support
- Jürgen Lachmann: AmigaOS CyberGraphX support
- Samuel Lander: tile-based window refresh code
- David Lawrence: incremental window refresh code
- Bernie Meyer: original UAE-JIT code
- Nigel Pearson: Mac OS X port
- Lauri Pesonen: Windows NT port
- Bernd Schmidt: UAE 68k emulation
- Michael Z. Sliczniak: Mach memory fault recovery
- and many others...
- Bernd Schmidt for letting us use his UAE 68k emulation
- Daniel Bobbert for technical documentation contributions
- All ShapeShifter and SheepShaver users and beta testers
- Apple Computer Inc., who made writing a Macintosh emulator possible
Modernized for Apple Silicon Macs by Hong-Jun Yoon with:
- ARM64 native support (no Rosetta required)
- Modern Xcode project integration
- SDL2 audio/video framework
- macOS 11+ compatibility
- Enhanced performance optimizations
This project maintains the original Basilisk II license. See COPYING for details.
Note: This is a modernized fork of the original Basilisk II for Apple Silicon Macs. Performance and compatibility may vary depending on your specific hardware and ROM configuration.
For detailed information about ongoing modernization efforts, planned features, and development roadmap, please see:
modernization.md - Complete Apple Silicon modernization roadmap including:
- ✅ Performance optimizations ACHIEVED (20%+ improvement through ARM64 optimizations)
- ✅ Stable video and audio working perfectly
- 🎯 User experience improvements (drag-and-drop, modern preferences) - Next phase
- 📋 Technical debt and code modernization plans
- 🚀 Priority-based task organization and timelines
Current Status: Phase 1 (P0) substantially complete with major performance and stability improvements achieved. Focus now shifting to user experience enhancements and macOS integration features.