Contribute
Report a test result
Run Omarchy on your Intel Mac and tell everyone what works. One test fills in a whole configuration, and every diagnostic report helps the next person decide.
Diagnostic reports arrive through OmaBoot? Live, a comprehensive Intel Mac test suite for Omarchy. You start your Mac from a USB stick, nothing is installed, and it identifies your exact configuration, walks you through each check, and submits the report for review. Its first release is coming soon.
Check your Mac's page
Until OmaBoot? Live's first release, the most useful thing you can do is check that your Mac's model page matches your hardware. If it doesn't, open an issue on GitHub with the output of lspci -nn and lsusb.
Help fix what doesn't work
#WeCanFixEverything. Fixes happen upstream, where every Mac gets them: the Linux kernel's mailing lists and subsystem maintainers, t2linux for T2 and Apple hardware, Omarchy's repositories (omacom/omarchy, and omacom/omarchy-pkgs for its kernel) and Arch Linux packaging. Each failed result shows what the Mac reported: start there.
OmaBoot? carries a few fixes for testing, before they land upstream; the fixes page lists them and where each comes from. Once a fix ships in Omarchy, a new passing report is what turns the result green.
For test-tool authors
If you build a tool that tests Omarchy on Macs, it can send diagnostic reports straight to this site. Register your tool for a source key, show testers the required notice, and post reports in our format; maintainers review each one before it counts. The API page has the details, and anyone can read the catalog and results there as JSON.
Fix or improve the catalog
The catalog is plain YAML in the DoesItOmarchy repository: one file per model identifier in data/macs/, shared components in data/components/. Corrections come in as pull requests, and doiomad validate checks every change in CI.
- Cite a source for every fact: Apple Tech Specs, EveryMac, or a hardware probe from a real machine.
- If you're unsure, record your best value with an
uncertainnote rather than guessing. - Configuration IDs are permanent. Rename one by moving the old ID to
aliases, never by deleting it.
See CONTRIBUTING.md for the full rules.