Snapintosh/Snapintosh

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/Snapintosh/Snapintosh.svg?style=card)](https://bestofgithub.dev/repo/Snapintosh/Snapintosh)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/Snapintosh/Snapintosh.svg)](https://bestofgithub.dev/repo/Snapintosh/Snapintosh)

Loading README…

Area	State
macOS desktop on the A16	Boots to the desktop with GPU acceleration. Rendering is correct: the pixel checks across the desktop test scenes pass.
Smoothness	In progress. Interaction is usable but not yet smooth. The target is a steady ~60 Hz first and the panel's 120 Hz later.
Input	The built-in keyboard and touchpad work, including trackpad gestures, Mission Control and app switching.
Wi-Fi (QCC2072)	Scanning, a WPA2 connection, DHCP and ping work through a host-proxy harness driven from the Mac. Joining from the macOS Wi-Fi menu does not work yet.
Storage	macOS is installed on, and boots from, the internal NVMe.
Other hardware	Audio, cameras, Bluetooth, sleep and external displays are not supported.

Path	Contents
`compat/`	the EL2 monitor: SPTM/TXM contracts, CPU, interrupt, timer and device emulation, the GPU ring and SMMU mediation, the NVMe backend
`shadow/`	the page-table walker and the 16 KiB guest to 4 KiB hardware shadow tables
`probes/`	the code that runs on the target (loader, monitor entry) and the host-side image builder and runner
`tools/`	firmware acquisition, kernelcache analysis, the boot-cycle tool (`cycle.py`), build helpers and the native test suites
`gpu/adreno-kext/`	the AdrenoX2 kext (`kext/`, submodule SnapAdreno), the AdrenoMetal plug-in (`plugin/`, submodule SnapMetal) and the shared register and contract headers (`include/`)
`gpu/air2ir3/`	the AIR to ir3 shader compiler (submodule air2ir3)
`gpu/agx*`	an earlier virtual-AGX model, kept for reference
`drivers/`	SnapI2CHID (`snap-i2c-hid/`, submodule SnapI2CHID), the QCC2072 Wi-Fi controller (`snap-qcc2072/`, submodule SnapQCC2072), the boot framebuffer, a loader test
`config/`	monitor feature flags and guest launchd jobs
`build/`	generated output (gitignored, apart from the AuxKC link helpers)
`docs/`	design and reference documentation

Repository	Mounted at	Contents
Snapintosh	(this repository)	EL2 monitor (`probes/`, `compat/`, `shadow/`), `tools/`, docs
q1n1	`../q1n1` (separate checkout)	UEFI EL2 proxy and loader, a fork of Asahi Linux's m1n1
SnapAdreno	`gpu/adreno-kext/kext`	Adreno X2-90 IOGPU and display kernel driver
SnapMetal	`gpu/adreno-kext/plugin`	Metal driver plug-in (`AdrenoMetal.bundle`)
air2ir3	`gpu/air2ir3`	AIR to Mesa ir3 shader compiler kit
SnapI2CHID	`drivers/snap-i2c-hid`	I2C-HID keyboard, touchpad and precision-touchpad driver
SnapQCC2072	`drivers/snap-qcc2072`	QCC2072 Wi-Fi driver (work in progress)

Read	For
docs/STATUS.md	what works, known issues, roadmap
docs/ARCHITECTURE.md	how the layers fit together, including the GPU stack and Wi-Fi
docs/BUILDING.md	building the monitor, kexts, plug-in and compiler
docs/RUNNING.md	a boot cycle with `tools/cycle.py`
docs/KERNEL-PATCHES.md	the opt-in kernel patches and why each exists
docs/BOOT-CHAIN.md	how a stock macOS kernel boots on this SoC
docs/FULL-INSTALL.md	installing to and booting from the internal NVMe
docs/COMPATIBILITY.md	guest/host boundaries and pinned profiles
gpu/air2ir3/README.md	the shader compiler
docs/WORKSPACE-LAYOUT.md	local inputs, generated output and what is never committed
docs/GUI-BOOT-ROADMAP.md	the path from the first kernel instruction to the desktop

Snapintosh