FAQ
General Questions
Can I run macOS apps on ravynOS?
No - not yet. This is a major goal and we're working towards it. So far, only trivial CLI programs (e.g, small things in Swift) have been able to run.
Is this... legally sketchy?
No. Consider projects like ReactOS, a from-scratch effort to create an OS compatible with Microsoft Windows, GNUstep, which provides an open implementation of Cocoa APIs and other things, or Darling, a compatibility layer for running Darwin (macOS) binaries on Linux. ravynOS is similar and stands on the shoulders of many such projects.
All code used is freely available under open source licenses. No proprietary elements like fonts, icons, trademarks, etc can be used. Original code must be written using "clean room" techniques - that is, from public documentation like developer guides by people who have never seen the proprietary code - and released under the FreeBSD license or the MIT license.
What programming languages does ravynOS use?
The goal is to use a small core set of languages as much as possible: the "C" family (C, C++, Objective-C, and Objective-C++), Swift, Python, Java, and shell scripts. This should cover most needs.
I can code in those! How can I help?
Great! Take a look at the issues list to find something that interests you, or contact mszoek.
I don't code but this looks awesome! Can I still help?
Absolutely! There will be art, documentation, testing, UX and UI work, release management, project management, legal advice, hosting, and many other ways to contribute. This project is huge and help is very welcome. Check out the issues for ideas on how to contribute, or contact mszoek.
Can I support the project financially?
You sure can! I've signed up for GitHub Sponsors to make monthly sponsorship easy. You can also make a contribution via PayPal.
This is a huge effort. Y'all must be crazy!
Yes. Here's to the crazy ones... because the people who are crazy enough to think they can change the world are the ones that do.
In all seriousness, though, it's not my first rodeo. I have no illusions about the scale of building an OS or how long projects like Haiku, ReactOS or GNUStep took to get usable. This is just something I like doing in my Copious Spare Time™ and that I hope will be useful someday.
I've always liked Apple's design and elegance, but am not thrilled with the direction of recent macOS® or how closed the hardware has become. And I'm a big believer in open source. So ... let's build something that feels as elegant, without all the lock-in, and maybe (just maybe) I can get it to a point that reasonably useful Mac apps build & run on it. And if not, we'll build a lot of cool pieces along the way and learn a ton. I'm OK with that.
What is ravynOS's mascot?
ravynOS’s mascot is a raven named Muninn. The name is a reference to one of Odin’s two ravens, Huginn and Muninn ("mind and will")
Troubleshooting
ravynOS won't boot on my hardware. What can I do?
The Darwin-based versions of ravynOS are very new and as such lack the same variety of hardware compatibility that was seen on FreeBSD-based releases. As such, it will take a while before most hardware is able to run ravynOS effectively. In the meantime, however, you're free to play with the system in a Virtual Machine.
How do I report a bug?
Please file issues on our GitHub Issues page. Include as much detail as possible: your hardware or VM specifications, what you were doing when the issue occurred, and any error messages you saw.