Skip to content

USOSP/darling

This branch is 359 commits behind darlinghq/darling:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

b2a6375 · Oct 4, 2022
May 4, 2021
May 29, 2021
Sep 9, 2022
Apr 22, 2022
Mar 3, 2022
Oct 4, 2022
Jun 24, 2022
Aug 14, 2018
Sep 9, 2022
Sep 9, 2022
Feb 26, 2016
Feb 12, 2021
Oct 4, 2022
Feb 26, 2016
Sep 9, 2022
Aug 15, 2012
Jan 3, 2020
Oct 4, 2022
Sep 6, 2022
Apr 6, 2017
Oct 22, 2012
Jan 4, 2021

Repository files navigation

Darling

Darling logo

Darling is a runtime environment for macOS applications.

Please note that most GUI applications will not run at the moment.

Download

Packages for some distributions are available for download under releases.

Build Instructions

For build instructions, visit Darling Docs.

Prefixes

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 /

The Midnight Commander package from the above example is available for download.

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
/Volumes/Xcode_7.2
Darling [~]$ cp -r /Volumes/Xcode_7.2/Xcode.app /Applications
Darling [~]$ export SDKROOT=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk
Darling [~]$ echo 'void main() { puts("Hello world"); }' > helloworld.c
Darling [~]$ /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang helloworld.c -o helloworld
Darling [~]$ ./helloworld
Hello world

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

Working with XIP archives

Xcode is now distributed in .xip files. These can be installed using unxip:

cd /Applications
unxip Xcode_11.3.xip

About

Darwin/macOS emulation layer for Linux

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 40.7%
  • Objective-C 31.5%
  • C++ 19.6%
  • Roff 2.5%
  • Assembly 2.3%
  • Shell 1.3%
  • Other 2.1%