Mariani is a native macOS UI for AppleWin, by way of Andrea's Raspberry Pi port.
![Mariani Screenshot](https://private-user-images.githubusercontent.com/95387068/245941111-b9ce556f-d3eb-4d0a-9617-b5fb27211b84.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ0NTUwNTgsIm5iZiI6MTcyNDQ1NDc1OCwicGF0aCI6Ii85NTM4NzA2OC8yNDU5NDExMTEtYjljZTU1NmYtZDNlYi00ZDBhLTk2MTctYjVmYjI3MjExYjg0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MjMlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODIzVDIzMTIzOFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTQxZmRkNTgyYmZhMjI2M2ViN2FiOTkwNjE2ODc1ZmFmZmJlOGMyMDgwNzRkNTMyYWJmNTdhNmUwNzcyZWRlMDkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.M7tCudDjbkdWHNunVmS5JDLmpaQguuiWBbiuCNCzUxo)
But if what you want is a macOS command-line app, you can build that too with the instructions below.
- Native, universal macOS UI
- Screen recording
- Copy screenshot to pasteboard
- Disk image browser, including syntax-highlighted listings for Applesoft and Integer BASIC, as well as hex viewer for other file types
- Floppy and hard disk image creation
- Full-screen support
- Debugger and memory viewer (including a live viewer for the current BASIC program!) in separate windows
- AppleScript support
- Numeric keypad joystick emulation
Mariani should now be broadly useful, so please report any issues you run into. The following AppleWin feature is not yet supported:
Experimental support for printers is available in a branch. It needs considerable upstream support and is unmaintained.
The easiest way to build Mariani is to satisfy the dependencies using Homebrew. After you install Homebrew, pick up the required packages below:
brew install Boost libslirp
Now grab the source code:
git clone https://github.com/sh95014/AppleWin.git --recursive
Load up the Xcode project, and build the "Mariani" target for "My Mac".
"Mariani Universal" is the target used to build a universal (x86 and ARM) app, and will not build out of the box. Homebrew does not support universal libraries, so you'll have to follow these instructions on an Apple Silicon Mac to install the x86 versions of the relevant libraries. Here's a handy script to combine them into universal shared libraries:
#!/bin/sh
lipo -create -arch arm64 /opt/homebrew/lib/$1 -arch x86_64 /usr/local/homebrew/lib/$1 -output $1
You'll need to run that script for everything that the "StaticWrapper Universal" target needs to link against, which are currently libintl.a
, libglib-2.0.a
, libslirp.a
, and libboost_program_options.a
. The Xcode project expects them to be placed in ../universal/
relative to itself but you can change that to your liking.
sa2 is the binary produced by Andrea's port. It's not the focus of this repository but it's a more "faithful" AppleWin and very useful to compare behaviors and bugs.
sa2 needs more external libraries than Mariani, which you can grab for macOS using Homebrew. After you install Homebrew, pick up the required packages below:
brew install cmake pkgconfig libyaml minizip libslirp libpcap Boost sdl2 sdl2_image
Next, you'll probably want to generate an Xcode project to take advantage of source code indexing and finding the lines of code with warnings or errors. The parameters assume you just want the imgui frontend:
git clone https://github.com/sh95014/AppleWin.git --recursive
cd AppleWin
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=RELEASE -DBUILD_SA2=ON -G Xcode ..
open applewin.xcodeproj
The project should now launch in Xcode. Select the ALL_BUILD
target and build. You can look under Products
in the left pane to see where it is, because unfortunately Xcode does not seem to be able to run and debug the binary directly.
Or, you can follow basically the same instructions as in Linux, but in this case also simplified to build only the sa2 frontend:
git clone https://github.com/sh95014/AppleWin.git --recursive
cd AppleWin
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=RELEASE -DBUILD_SA2=ON ..
make
Note that some of the settings (most of the ones stored in ~/.applewin/applewin.conf
) will affect both Mariani and sa2.