macOS builds can be created using the Meson buildsystem, compiled using the Clang or GCC compilers, and provided with dependencies using the Homebrew or MacPorts package managers.
We recommend using Homebrew and Clang, because Apple's Core SDKs can be used only with Apple's fork of Clang compiler.
Before installing either Homebrew or MacPorts, the Apple's Xcode tools need to be installed and the license agreed to:
- Install the command line tools:
xcode-select --install
and accept the license agreement - Install software updates: Apple menu > System Preferences > Software Update > "Updates are available: command line tools for Xcode" Click Update Now to proceed.
- Install build dependencies using either Homebrew or MacPorts.
-
Install Homebrew: https://brew.sh.
-
Install dependencies and related tools:
brew install ccache cmake libpng meson libslirp \ opusfile pkg-config python3 sdl2 sdl2_net
-
Add brew to your shell path:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> "$HOME"/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)"
-
Install MacPorts: https://www.macports.org/install.php
-
Install dependencies and related tools:
sudo port -q install ccache cmake fluidsynth libpng libsdl2 \ libsdl2_net meson opusfile pkg-config python3 \ libslirp
Once you have depenendcies installed using either environment, clone and enter the repository's directory:
cd
mkdir -p src
cd src
git clone https://github.com/dosbox-staging/dosbox-staging.git
cd dosbox-staging
meson setup build
ninja -C build
See more build options in BUILD.md.
-
Allow the terminal to get keyboard events, which will let you launch dosbox from the command line.
In System Settings > Privacy > Input Monitoring > Terminal (enable)
-
Launch DOSBox Staging:
cd src/dosbox-staging/ ./build/dosbox