BasiliskII builds for Mac OS X, links and downloads

About BasiliskII, a 68k Mac emulator for Windows, MacOSX, and Linux that can run System 7.x through MacOS 8.1.

Moderators: Cat_7, Ronald P. Regensburg

User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Currently recommended BasiliskII builds for MacOSX/OSX/macOS:
See also the information below the download links!

• SDL2 port, 28 February 2024, universal (x86_64 and arm64) from github.com/kanjitalk755/macemu source
Universal, will run natively on both Intel and Apple Silicon
Recommended for macOS 10.13 (High Sierra) through 14 (Sonoma)
Download: https://www.emaculation.com/basilisk/Ba ... 240228.zip

This build:
New advanced feature with prefs item "init_grab true". See setup guide.

• SDL2 port, 1 August 2021, universal (x86_64 and arm64) from github.com/kanjitalk755/macemu source
Recommended for Mac OS X 10.9 (Mavericks) through macOS 10.12 (Sierra)
Download: https://www.emaculation.com/basilisk/Ba ... 210801.zip

• SDL2 port, 4 May 2019, Intel 64-bit from github.com/kanjitalk755/macemu source
Works on Mac OS X 10.7 (Lion) through macOS 10.12 (Sierra)
Download: https://ronaldpr.home.xs4all.nl/basilis ... 190504.zip

• For the above SDL2 port builds:
- If you have an existing BasiliskII setup, you can simply replace the application with the new application.
- If you use an older BasiliskII_keycodes file, you will also need to replace that file with this new one: https://ronaldpr.home.xs4all.nl/basilis ... ycodes.zip

• Older builds
A variety of older builds can be found in the next post.

For a new BasiliskII setup a BasiliskIIGUI application and a keycodes file are needed:
- BasiliskIIGUI is 32-bit only. It can be used up to macOS 10.14 (Mojave). Download: https://www.emaculation.com/basilisk/BasiliskIIGUI.zip
- Basilisk II GUI (beta) can be used in macOS 10.13 (High Sierra) and later. See this forum topic: viewtopic.php?f=6&t=10454
- Unless you use an USA-English keyboard, you will also need a BasiliskII_keycodes file. Download: https://ronaldpr.home.xs4all.nl/basilis ... ycodes.zip
- For more information see the revised setup manual: https://www.emaculation.com/doku.php/ba ... _osx_setup

BasiliskII Disk Image Chooser (with thanks to our member "emendelson")
Selecting and managing disk image files can be done in the volumes list in the old BasiliskIIGUI, but this AppleScript application is easier to use for that purpose.
Originally introduced in this topic: viewtopic.php?f=6&t=5455
Download: https://www.emaculation.com/basilisk/Ba ... hooser.zip

HFSUtilsGUI (with thanks to our member "sentient06")
Creates HFS (and HFS+) disk image files. Still works in macOS 10.15 Catalina.
Originally presented in this topic: viewtopic.php?f=1&t=8337&p=51502
Download: https://www.emaculation.com/basilisk/HFSUtilsGUI.zip


Setup manuals:

This setup manual in E-maculation wiki explains how to set up BasiliskII with System 7.5.3:
Setup manual: http://www.emaculation.com/doku.php/bas ... _osx_setup

This guide describes printing in SheepShaver and BasiliskII:
http://www.emaculation.com/doku.php/she ... k_printing

This guide describes setting up AppleTalk for Basilisk (OS X):
http://www.emaculation.com/doku.php/app ... heepshaver
Last edited by Ronald P. Regensburg on Thu Feb 29, 2024 1:18 pm, edited 65 times in total.
Reason: Posted the 28 February 2024 build
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

When I posted my March 2014 build I hoped to bring some order in all the various BasiliskII builds floating around. But it appeared that some games suffer from extreme stuttering in that build. Those games do run smoothly in builds by vasi, though.

Discussion in this topic: http://www.emaculation.com/forum/viewto ... f=6&t=8297

Here are all the builds made available publicly between 2009 and 2014:

1. Compiled from cebix/macemu source:

October 2009 UB build by me (10.4 and up), with PPC-only GUI included:
http://www.xs4all.nl/~ronaldpr/basilisk ... 091004.zip

October 2011 builds by vasi (10.6 and up, 32-bit):
BasiliskII: https://github.com/downloads/vasi/b2gui ... I-10.6.zip
BasiliskIIGUI: https://github.com/downloads/vasi/b2gui ... I-10.6.zip

March 2013 builds by vasi (10.6 and up, 32-bit, with sparsebundle support):
BasiliskII: https://www.dropbox.com/sh/krq4jq9dsrem ... II.app.zip
BasiliskIIGUI: https://www.dropbox.com/sh/krq4jq9dsrem ... UI.app.zip

March 2014 build by me (10.6 and up, 32-bit, with sparsebundle, cursor grabbing toggle, and window-fullscreen toggle support) now with October 2011 GUI included.
http://www.xs4all.nl/~ronaldpr/basilisk ... 140301.zip


2. Compiled from dsumorok/macemu source:

July 2013 builds by Cat_7 with with special support for simplified AppleTalk setup on wired networks. These builds are for 10.8 and up, are 64-bit, and have sparsebundle, cursor grabbing toggle, window-fullscreen toggle support. See topic: http://www.emaculation.com/forum/viewto ... f=6&t=8067
Cat_7 notes: These builds do not stem from the official source code repository and will most likely not be updated when the official source code changes.
Last edited by Ronald P. Regensburg on Wed Nov 07, 2018 8:02 pm, edited 6 times in total.
Reason:  
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

01-03-2014: Posted the new March 1, 2014 build.
02-03-2014: Replaced the included GUI in the download. (The originally included March 2013 GUI erroneously depends on external X11-related files.)
02-03-2014: Added list of all publicly available builds since 2009.
03-03-2014: Added link to current discussion.
10-08-2016: Removed outdated comment that the 2013 GUI build will only run with X11/XQuartz installed.
Last edited by Ronald P. Regensburg on Wed Aug 10, 2016 11:58 am, edited 2 times in total.
Reason:  
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 64-bit SDL2 port, July 2018 build.
Posted the 64-bit SDL2 port, May 2019 build.
Last edited by Ronald P. Regensburg on Sat May 04, 2019 11:11 am, edited 1 time in total.
Reason:  
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the notarized SDL2 port, built by our member emendelson 8 September 2019
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the notarized SDL2 port, built by our member emendelson 10 October 2019
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted a new notarized SDL2 port build, built with SDL2 2.0.9. The previous notarized build was created with SDL2 2.0.10 and appeared to have a serious CapsLock issue.
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 4 December 2019 build.
Again with SDL2 2.0.10, now with CaspLock issue solved.
Disturbing message in Catalina "would like to receive keystrokes from any application" solved.
New "78" icon.
Last edited by Ronald P. Regensburg on Thu Dec 05, 2019 10:50 am, edited 1 time in total.
Reason:  
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 9 December 2019 build.
Instability that was introduced in the 4 December 2019 build solved.
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 12 January 2020 build, recommended for macOS 10.13 (High Sierra) through 10.15 (Catalina).

'Unix' shared folder issue (loss of file resource forks) with APFS file system on host solved.
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 8 Mach 2020 build, recommended for macOS 10.13 (High Sierra) through 10.15 (Catalina).

This build now has etherhelper support.
See also this topics: https://www.emaculation.com/forum/viewt ... f=6&t=8067
and discussion here: https://www.emaculation.com/forum/viewt ... 477#p65477
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 16 May 2020 build, recommended for macOS 10.13 (High Sierra) through 10.15 (Catalina).

Long standing bug in SDL2 port , not writing the ~/.basilisk_ii_xpram file, fixed.
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 10 August 2020 build.

- With bin/cue support by our member Elyus (see topic: https://www.emaculation.com/forum/viewt ... =bin%2Fcue )
- With etherhelper support
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 22 September 2020 build that adds two new advanced features;
- Option to enlarge the window while preserving guest screen resolution.
- Option to pass on guest gamma settings to the host

See SheepShaver setup manual for information about advanced features here: https://www.emaculation.com/doku.php/sh ... uilds_only
With the exception of "hardwarecursor" and "cpuclock", these features are also available in BasiliskII SDL2 builds.
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 31 January 2021 build.

Edit: This build was withdrawn because of issues.
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted 2 February 2021 build.

- Fix for freeze at startup in 31 January 2021 build
- Various fixes
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted 7 February build.

- Improved fix for 'Unix' shared folder issue where resource forks would not be saved on a host with APFS file system
- Will now play a file "startup.wav" if present in the BasiliskII folder
- Does allow redirect with slirp networking (See this forum topic: viewtopic.php?f=6&t=7782)
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted 27 February 2021 build.

- Minor cosmetic issue during startup in fullscreen mode solved for Macs with Metal capable GPU. (The issue remains for older non-Metal Macs.)
- Adds another advanced feature: Option to set a custom window title with a prefs item "title". (See setup manual for information.)
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted 1 March 2021 build.

- Cosmetic issue during startup in fullscreen mode now also solved for non-Metal Macs
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted 17 March 2021 build.

- "Lines to Scroll" (mousewheellines) can be set to negative values, thus reversing the scroll direction. (For now an advanced feature, see setup manual for information.)
- Adds another advanced feature: Option to shorten the sound buffer length with a prefs item "sound_buffer". (See setup manual for information.)
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted 28 April 2021 build.

- Universal (fat) binary, x86_64 and arm64.
- New prefs item "name_encoding" to correct non-MacRoman file names in "Unix" shared folder. (See Advanced features in setup manual.)
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Added note about inaccurate FPU emulation when running on Apple Silicon natively.
See also: viewtopic.php?p=70596#p70596
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted 14 June 2021 universal build.

- In this build the FPU issue on Apple Silicon is solved.
- JIT Compiler is not functional anymore on Apple Silicon, JIT settings will be ignored.
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Posted the 1 August 2021 universal build.

- Fix for Caps Lock key not working
(The issue was introduced in February 2021 and later builds by a change in SDL2 2.0.14 that was noticed only recently.)
User avatar
Ronald P. Regensburg
Expert User
Posts: 7821
Joined: Thu Feb 09, 2006 10:24 pm
Location: Amsterdam, Netherlands

Re: BasiliskII builds for Mac OS X, links and downloads

Post by Ronald P. Regensburg »

Several users reported that the 1 August 2021 universal build crashes on Intel Macs. Please try this latest Intel-only build instead:
Download: https://www.emaculation.com/basilisk/Ba ... 210421.zip
(The Caps Lock key issue was not yet solved in this build.)
Locked