DoesItOmarchy
Search Ctrl K

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.

Get OmaBoot? Live Browse Intel Macs

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 uncertain note 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.

    ↑↓ moveEnter openTab completeEsc close