Skip to content
This repository was archived by the owner on Nov 8, 2026. It is now read-only.

README.md

Latest commit

 

History

History
106 lines (86 loc) · 5.88 KB

README.md

File metadata and controls

106 lines (86 loc) · 5.88 KB
Raw

ElementaryOS M-Series (Apple Silicon port scaffolding)

Experimental project: build elementary OS (Pantheon, Ubuntu-based, mkosi image builder) for Apple Silicon Macs (M1/M2/…), informed by the Apple Silicon hardware support maintained in omacom/omarchy-mac-pkgs. The original scaffold used the transitional omarchy-mac quattro branch; current package behavior is tracked at the separate main-branch pin in mseries/UPSTREAM-PINS.md.

Current status, open problems and stretch goals: ROADMAP.md. Benchmarks: benchmarks/.

English F5 speech is merged and activated with Nemotron CPU and optional native ANE/MLX engines; seven installed app routes passed within the quiet and memory guards. Read its qualification ledger before speech benchmarks or continuation work. Reuse completed receipts, including failures, and inspect the existing owned queue before starting anything. Current controls and scoped results are in English F5 acceptance.

v0.0.1 is an English STT-only desktop-update candidate. Physical F5 in ChatGPT failed before capture; an accessibility/IBus launcher fix is staged for its next full launch. Post-relaunch human acceptance is pending.

Upstream bases (pinned at first commit — see mseries/UPSTREAM-PINS.md):

Status: booted M1 Pro desktop; factory ISO still unverified

The owner confirms elementary OS 9 boots on a 2021 14-inch M1 Pro using the transformed system. See desktop setup for reproducible Command shortcuts, Pantheon brightness keys, Signal ARM64, CodexBar Linux and its native Wingpanel quota dropdown. The full-height desktop profile adds notch-aware Wingpanel layout and a compact dock with persistent placement. RepoBar for elementary OS is an optional native Wingpanel dashboard for GitHub repository counts, default-branch CI and releases. Ambient keyboard lighting is available through bash mseries/install-keyboard-backlight.sh, using the AOP sensor and UPower.

mkosi.images/apple-silicon/ (arm64-only directory image) carries the ported layer and is wired into the arm64 live ISO profile and the sysupdate image via ExtraTrees. This factory ISO path has not been hardware-verified. See mseries/PORT-MAP.md for the per-fix analysis, mseries/KERNEL-REPORT.md for the kernel verdict, and mseries/BUILD-NOTES.md for what remains. The current audit and prioritized bug-fix list are in mseries/BUG-FIX-ROADMAP.md.

Why a port, not a cherry-pick

omarchy-mac is Arch Linux (pacman, mkinitcpio, Hyprland); elementary is Ubuntu (apt, initramfs-tools, Pantheon/Gala, casper live ISO). Package names, initramfs tooling, and the desktop stack all differ, so each fix is translated to its Ubuntu/mkosi equivalent rather than copied. Hyprland- and pacman-specific pieces are documented as out of scope.

Installation paths

The image factory produces separate boot media. The desktop and local-AI installers under mseries/ also configure a running elementary installation; their individual documentation describes what they install and how to remove it. Cloning the repository alone does not apply those changes.

Local Troubleshooter adds on-device Ornith 1.5 9B log analysis and a task briefing, a native GTK app, and a Wingpanel robot menu with optional crash diagnosis.

Torrential native-port status records the installed ARM64 app, local .deb recipe, successful Ubuntu torrent transfer, and source-license status. The packaging is optional and separate from the factory image.

Layout

Two tracks, one shared hardware layer:

  • Image factory (mkosi.images/apple-silicon/ + arm64 wiring): builds a bootable live ISO in CI. Long-term clean path; blocked on kernel + firmware work (see KERNEL-REPORT.md, KERNEL-SOURCE.md).

  • Transform (transform/elementary-grow.sh, design in mseries/TRANSFORM-DESIGN.md): single command run on a booted omarchy-mac that grows an elementary boot entry alongside the existing system (new subvolume, reused Asahi kernel, additive GRUB entry). Untested — dry-run review on the real machine comes first.

  • mseries/PORT-MAP.md — every omarchy-mac Apple fix, mapped to portable / N-A with reasons.

  • mseries/UPSTREAM-PINS.md — exact upstream commits this is based on.

  • mseries/KERNEL-REPORT.md — Ubuntu generic kernel vs Apple Silicon verdict (boots unaccelerated; daily-driver needs an Asahi kernel).

  • mseries/BUILD-NOTES.md — what is needed to get to a testable arm64 ISO.

  • mseries/USB-C-DOCK-DP-ALT-MODE.md — why USB-C dock video/mouse (Dell WD19S) does not work on stock linux-asahi, with live evidence from a MacBookPro18,3 (M1 Pro) and the fairydust DP-Alt-Mode path.

  • mseries/fairydust/ — helper to build the experimental fairydust DP-Alt-Mode kernel on the Arch/omarchy side.

  • mseries/packages.arm64 — package rationale for the Apple Silicon layer. Includes Signal Desktop (signal-desktop apt repo + Flathub org.signal.Signal) and the DP-Alt-Mode kernel config bits.

  • mkosi.images/apple-silicon/ — the build wiring: mkosi.conf, mkosi.extra/ (final-path config files + resume script), mkosi.postinst.chroot, mkosi.finalize. Arm64-only; wired into mkosi.conf.d/arch.arm64.conf, the liveiso aarch64 profile, and a new mkosi.images/sysupdate/mkosi.conf.d/arch.arm64.conf.

License

Upstream LICENSE (GPLv3) is unchanged and covers the build system this derives from. The mseries/ overlay is contributed under the same license.