Skip to content
Darwin/macOS emulation layer for Linux
Branch: master
Clone or download
Latest commit a06b207 Mar 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
Developer Developer dir improvements Sep 3, 2018
cmake Resolve some symbol issues for xcodebuild Mar 17, 2019
debian Initial fix to get dkms working on kernel upgrades Feb 16, 2018
kernel-include Fix mach_error_string() Jun 3, 2018
misc Cleanup benchmarks, misc and tools directories Feb 26, 2016
platform-include Fixes for xcodebuild (#488) Mar 17, 2019
rpm Fedora 29 cleanup Mar 18, 2019
src Update submodule (Linux 4.20+ support) Mar 18, 2019
tools Make darling-stub-gen work with indirect symbols Mar 18, 2019
.gitignore RPM's building at least... Jan 23, 2018
.gitmodules Build SecurityTokend private framework Jan 15, 2019
CMakeLists.txt Allow specifying a different compiler Jan 11, 2019 Add contributors file Apr 6, 2017

Stories in Ready


Darling logo

Darling is a runtime environment for OS X applications.

Please note that no GUI applications are supported at the moment.


Darling uses many Git submodules, so a plain clone will not do.

git clone --recurse-submodules

Updating sources:

git pull
git submodule init
git submodule update

Build Instructions

For complete instructions, visit DarlingHQ Wiki.


Darling has support for DPREFIXes, which are very similar to WINEPREFIXes. They are virtual “chroot” environments with an macOS-like filesystem structure, where you can install software safely. The default DPREFIX location is ~/.darling, but this can be changed by exporting an identically named environment variable. A prefix is automatically created and initialized on first use.

Please note that we use overlayfs for creating prefixes, and so we cannot support putting prefix on a filesystem like NFS or eCryptfs. In particular, the default prefix location won't work if you have an encrypted home directory.

Hello world

Let's start with a Hello world:

$ darling shell echo Hello world
Hello world

Congratulations, you have printed Hello world through Darling's OS X system call emulation and runtime libraries.

Installing software

You can install .pkg packages with the installer tool available inside shell. It is a somewhat limited cousin of OS X's installer:

$ darling shell
Darling [~]$ installer -pkg mc-4.8.7-0.pkg -target /

If you have previously downloaded the Midnight Commander package from Rudix, you can now run mc to start MC for OS X. For easier installation, install the Rudix Package Manager. Note that not all Rudix packages may work under Darling.

You can uninstall and list packages with the uninstaller command.

Working with DMG images

DMG images can be attached and deattached from inside darling shell with hdiutil. This is how you can install Xcode along with its toolchain and SDKs (note that Xcode itself doesn't run yet):

Darling [~]$ hdiutil attach Xcode_7.2.dmg
Darling [~]$ cp -r /Volumes/Xcode_7.2/ /Applications
Darling [~]$ export SDKROOT=/Applications/
Darling [~]$ echo 'void main() { puts("Hello world"); }' > helloworld.c
Darling [~]$ /Applications/ helloworld.c -o helloworld
Darling [~]$ ./helloworld
Hello world

Congratulations, you have just compiled and run your own Hello world application with Apple's toolchain.

You can’t perform that action at this time.