MX Mac

MX Mac Manual

Upstream and contributing

The fork's rule is that a change lives as close to upstream as it can. Every layer the fork touches has an upstream, and each has its own way of taking changes.

Layer Upstream How changes flow
Desktop runtime omacom/omarchy General fixes are sent upstream; Apple-specific code stays behind omarchy-hw-apple-silicon.
Packages omacom/omarchy-pkgs aarch64 PKGBUILDs are contributed directly, as plain recipes with arch=(aarch64). The fork's lanes, planner and image builder stay in the fork.
Kernel aurora-silicon/linux, branch aurora-wip Pull requests from the fork's kernel tree. The first two, a display crossbar selector fix and a stale DisplayPort link fix, are merged.
Boot, firmware, engine Asahi Linux m1n1 and asahi-scripts used unmodified. U-Boot is built with a silent console. The installer engine is Asahi's installer repackaged with downstream patches (v0.9.2-omarchy.17).
Compositor hyprwm/Hyprland, hyprwm/aquamarine Issues and patches filed by the maintainer.

What stays in the fork

These stay here until the fork is archived; the convergence spec moves this work to omacom repositories.

  • The macOS installer app and its release tooling.
  • The Mac image builder, the release lanes and the acceptance harness.
  • omarchy-mac-boot and the Apple Silicon hardware fixes.
  • The linux-aurora lane recipes and their pins.
  • The signed channel model: catalogs, trust root, immutable releases.

Naming

Identifiers the fork owns are named mac, not asahi: omarchy-mac-boot, build-mac-image, mac-image-<n>. Names that belong to the Asahi project keep their name: linux-asahi, asahi-scripts, [asahi-alarm], uboot-asahi. Older asahi-quattro release names remain because their releases are immutable.

Contributing

The fork is feature-frozen: it takes security and boot fixes only. New Apple Silicon work goes to omacom/omarchy-mac on quattro-upstream, as set out in the convergence spec, and installer work to omacom/omarchy-mac-installer.

  • Bugs: open an issue on omarchy-mx-mac with the details from Hardware support.
  • Runtime changes: security and boot fixes only, as pull requests against main on omarchy-mx-mac. Anything Apple-specific must run behind omarchy-hw-apple-silicon and come with a migration if it changes installed systems.
  • Packages: security and boot fixes to this fork's packages go to asahi-quattro on omarchy-pkgs. New recipes go to omacom/omarchy-pkgs.
  • Reviews: designs and code are reviewed before merge, and boot-critical changes need hardware evidence from a test Mac.

Licence

Omarchy MX Mac is released under the same MIT licence as Omarchy. The Asahi installer engine, m1n1 and U-Boot keep their own licences.