Infinite Mac
80's and 90's era classic Macs that load instantly in a browser and have access to a large software library. The full collection is at infinitemac.org. Shortcuts are available for System 6, System 7, Mac OS 8, Mac OS 9 and KanjiTalk (Japanese). For a high-level overview and the backstory, see the launch blog post and subsequent ones.
Development
This project uses Git LFS, ensure that the LFS tooling is installed before cloning the repo.
This project uses submodules, use git clone --recursive https://github.com/mihaip/infinite-mac.git
to clone it (or run git submodule update --init --recursive
if you have an existing checkout).
Common development tasks, all done via npm run
:
start
: Run local dev server (will be running at http://localhost:3127). Depends on having disk images built (import-disks
needs to be run at least once).import-emulator <emulator>
: Copy generated WebAssembly from an emulator submodule (only necessary if modifying the emulator cores, see below for how to rebuild them). The following emulators are supported:basiliskii
: Basilisk II from https://github.com/mihaip/macemusheepshaver
: SheepShaver from https://github.com/mihaip/macemuminivmac-Plus
: Mini vMac variants from https://github.com/mihaip/minivmac
import-disks
: Build disk images for serving. Copies base OS images for the above emulators, and imports other software (found inLibrary/
) into an "Infinite HD" disk image. Chunks disk images and generates a manifest for serving. This requires the macOS versions of Basilisk II and Mini vMac to be installed, since they are used as part of the image building process.
Common deployment tasks (also done via npm run
)
build
: Rebuild for either local use (in thebuild/
directory) or for Cloudflare Worker usepreview
: Serve built assets locally using Vite's server (will be running at https://localhost:4127)worker-dev
: Preview built assets in a local Cloudflare Worker (requires a separatebuild
invocation, result will be running at http://localhost:3128)worker-deploy
: Deploy built assets to the live version of the Cloudflare Worker (requires a separatebuild
invocation)
Dependencies
Dependencies can be installed with:
npm install
pip3 install -r requirements.txt
npm run build-xadmaster
Building the emulators
Basilisk II, SheepShaver and Mini vMac are the original 68K and PowerPC emulators that enable this project.They are hosted in separate repos and are included via Git submodules. Rebuilding them is only required when making changes to the emulator core, the generated files are in src/emulator
and included in the Git repository.
To begin, ensure that you have a Docker image built with the Emscripten toolchain and supporting libraries:
docker build -t macemu_emsdk .
Open a shell into the Docker container:
docker run --rm -it -v `realpath macemu`:/macemu -v `realpath minivmac`:/minivmac -v `realpath dingusppc`:/dingusppc --entrypoint bash macemu_emsdk
Once in that container, you can use a couple of helper scripts to build them:
Basilisk II
cd /macemu/BasiliskII/src/Unix
# Bootstrap Basilisk II, to generate the CPU emulator code
./_embootstrap.sh
# Switch into building for WASM
./_emconfigure.sh
# Actually compile Basilisk II targetting WASM
make -j8
Once it has built, use npm run import-emulator basiliskii
from the host to update the files in src/emulator
.
SheepShaver
cd /macemu/SheepShaver/src/Unix
# Configure for building for WASM
./_emconfigure.sh
# Actually compile SheepShaver targetting WASM
make -j8
Once it has built, use npm run import-emulator sheepshaver
from the host to update the files in src/emulator
.
Mini vMac
See this page for the full set set of build options (and this one for more estoeric ones).
cd /minivmac
# Configure for building for WASM
./emscripten_setup.sh
# This configures the Mac Plus model by default, alternative outputs can be
# configured with additional arguments:
# - `-m 128K -speed z`: Mac 128K (uses 1x speed by default to be more realistic)
# - `-m 512Ke`: Mac 512ke
# - `-m SE`: Mac SE
# - `-m II`: Mac II
# Actually compile Mini vMac targetting WASM
make -j8
Once it has built, use npm run import-emulator minivmac-<model>
from the host to update the files in src/emulator
.
DingusPPC
cd /dingusppc
mkdir -p build
cd build
emcmake cmake -DCMAKE_BUILD_TYPE=Release ..
make dingusppc -j8
Once it has built, use npm run import-emulator dingusppc
from the host to update the files in src/emulator
.