nullmoth/1401

macOS on the PC you already own: the reverse of Boot Camp. Free of charge, never for sale. Hardware reports stay local until a log submission is explicitly approved.

Made by NullMoth Systems. Support the work: https://buymeacoffee.com/nullmoth

1401 is new and may not work on every PC. It has been tested end to end on one PC (Intel Core Ultra 5 225F, B860 board, GeForce RTX 5060). If it does not work on yours, set up OpenCore by hand with the OpenCore Install Guide (OpenCore releases). The Mac installer targets macOS 15 on OpenCore; individual GPU, display and application support requires validation.

How the code works, step by step: docs/HOW-IT-WORKS.md.

Maintenance changes: Windows 1.0.24 companion refresh.

1. Unzip 1401-Windows-1.0.24.zip and keep the 1401 folder together. Run 1401.exe (it asks for administrator rights: it reads the hardware and writes the stick).

2. Check this PC, Build the Mac setup, read Your BIOS steps, then Create the macOS stick on a USB stick of 4 GB or more that can be erased. You need internet.

3. Restart, change the BIOS settings 1401 showed you, boot the stick, and pick the macOS installer in the OpenCore menu. In the installer, choose only the intended macOS partition or volume. Do not erase a whole disk containing Windows or other data. Prepare verified backups and recovery media before changing partitions. Format only the intended macOS destination as APFS with Disk Utility, then choose Reinstall macOS. The installer downloads the rest of macOS from Apple.

4. With a supported Turing-or-later NVIDIA card: when macOS is running, open the NullMoth folder on the stick, unzip 1401-Mac-1.0.18.zip and run 1401.app (or download 1401-Mac-1.0.18.dmg). It installs the NVIDIA driver and updates the driver-related OpenCore settings. Keep the 1401 stick plugged in while it runs and every time you start the Mac: OpenCore on that stick is what starts macOS, and it is the config 1401.app changes. The Mac companion does not copy OpenCore onto an internal EFI. Keep its startup stick attached for every restart until that boot setup is separately reviewed.

5. Something went wrong? If the build fails, 1401 shows why and sends the log to nullmothsystems.com after telling you (Cancel keeps it on your PC). If macOS does not start from the stick, boot back into Windows, plug the stick in and open 1401, or click Scan for logs and send them: the stick holds OpenCore's and macOS's startup logs and 1401 sends them. Quote the report ID it shows when you ask for help.

1401 builds with OpCore-Simplify and then applies its own rules. Every rule that fires is recorded in the build result.

python3 tests/corpus/fetch.py          # public Hardware Sniffer reports, pinned by commit
python3 tests/run_corpus.py build      # build + rules + ocvalidate for every machine in the corpus
python3 -m p1401.selftest && python3 -m p1401.guide --selftest && python3 -m p1401.apple --selftest \
  && python3 -m p1401.usbwriter --selftest && python3 -m p1401.scan --selftest && python3 -m p1401.nullmoth --selftest

loader/ is an experimental UEFI boot layer (Rust) tested in QEMU only. The app does not use it; sticks boot with OpenCore.

1401 is free of charge, forever, under the PolyForm Noncommercial License 1.0.0 (LICENSE): use it, change it, share it, but nobody may sell it or use it to make money. Third-party parts keep their own licences (NOTICE.md). The NullMoth name and the moth logo belong to NullMoth Systems and are not licensed.