Mac Emulation
This repository contains the BasiliskII and SheepShaver projects. It is an attempt to centralize the individual development efforts that have gone on in the absence of the original cebix/macemu repository owner.
The cxmon project has been split from this repository.
Goal of this fork
Many of the architectures on which this codebase originally ran are no longer in production, and several are not readily testable with modern distributed CI/CD services. It is the opinion of this maintiner that such a situation is an existential threat to the future of the project as a whole:
- if testing requires the use of antique hardware or usage of bespoke 3rd-party testing services for old architectures, we can't provide continuous integration of pull requests
- if we can't provide continuous integration of pull requests, we can't make informed decisions about accepting patches
- if we can't make informed decisions about accepting patches, the project can't evolve from open-source contributions
As such, be prepared to offer tests (or guidance on how to perform automated testing) on any contributions.
To date, the following architectures are functioning with a bare minimum of continuous integration testing. These are the only architectures that will be maintained, unless other CI services for other architectures can be added.
| Target | Options | Windows MinGW | OSX | Linux |
|---|---|---|---|---|
| BasiliskII | 32-bit, no JIT | - | - | - |
| BasiliskII | 32-bit, JIT | - | ||
| BasiliskII | 64-bit, no JIT | - | - | |
| BasiliskII | 64-bit, JIT | - | - | - |
| SheepShaver | 32-bit, no JIT | - | - | |
| SheepShaver | 32-bit, JIT | - | - | |
| SheepShaver | 64-bit, no JIT | - | - | - |
| SheepShaver | 64-bit, JIT | - | - |
Deprecated platforms
| OS | CI Status |
|---|---|
| FreeBSD | 💰 Costs Money |
| BeOS R4 (PowerPC and x86) | 📉 No longer available |
| AmigaOS 3.x | 📉 No longer available |
How To Build
These builds need the SDL2 framework/library to be installed.
.travis.yml and appveyor.yml contain the build scripts for CI. More generally, here are the steps:
BasiliskII
macOS
- Open BasiliskII/src/MacOSX/BasiliskII.xcodeproj
- Set Build Configuration to Release
- Build
Linux(x86)
$ cd macemu/BasiliskII/src/Unix
$ ./autogen.sh
$ make
MinGW32/MSYS
$ cd macemu/BasiliskII/src/Windows
$ ../Unix/autogen.sh
$ make
SheepShaver
macOS
- Open SheepShaver/src/MacOSX/SheepShaver.xcodeproj
- Set Build Configuration to Release
- Build
Linux(x86)
$ cd macemu/SheepShaver
$ make links
$ cd src/Unix
$ ./autogen.sh
$ make
MinGW32/MSYS
$ cd macemu/SheepShaver
$ make links
$ cd src/Windows
$ ../Unix/autogen.sh
$ make
Bug reports
You found a bug? Well, open an issue in this repo, supplying as much information as possible (operating system and versions of Basilisk II and MacOS being used, relevant hardware information, the exact steps to reproduce the bug, etc.)
I also strongly suggest reading this before posting a bug report: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html
Support
There is no point in sending questions about ROM files and how/where to get them.
These are almost certainly outdated
The official Basilisk II home page is at http://www.uni-mainz.de/~bauec002/B2Main.html
The Basilisk II project page on SourceForge is at http://sourceforge.net/projects/basilisk/
If you have problems, you may want to visit the Basilisk II forums: http://sourceforge.net/forum/?group_id=2123
There is also a mailing list for Basilisk II users: http://lists.sourceforge.net/lists/listinfo/basilisk-user
And another mailing list for Basilisk II developers: http://lists.sourceforge.net/lists/listinfo/basilisk-devel
Some general advice about asking technical support questions can be found at http://www.catb.org/~esr/faqs/smart-questions.html
Keeping this in mind will greatly increase your chances of getting a useful answer.