Skip to content

Apple's open-source XNU kernel on Android phones: its own loader and drivers, Metal on the Adreno. Runs from RAM; a reboot gives the phone back to Android.

C

main is the branch: every link and clone without -b hakios; CHANGELOG: the sources a build is made of, at the top

shimoku74bbe70cd5f0c8
diff --git a/CHANGELOG.md b/CHANGELOG.md
index c5227e1..7dbe6d0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,8 +3,22 @@
What changed, newest first. One line a change: the part of the system, then what is different for whoever runs it.
The commits say how; `docs/` says why.
+## Sources
+
+What a build is made of, and where each part is fetched from. Nothing of these is kept in the repositories but the
+changes to it; the scripts named fetch the release and put the changes on.
+
+- the kernel: Apple's [XNU](https://github.com/apple-oss-distributions/xnu), tag `xnu-8796.121.2` (the release the Darwin 16.5 user space was built from) -- `xnu/apply.sh`, the changes in `xnu/hakios.patch` and `xnu/files/`, the drivers in `drivers/`
+- the data volume: Apple's [HFS Plus](https://github.com/apple-oss-distributions/hfs), tag `hfs-627.100.6` -- `xnu/hfs/hfs.sh`, the changes in `xnu/hfs/hfs.patch`
+- the boot: [U-Boot](https://source.denx.de/u-boot/u-boot) `v2026.07` -- `hakios-uefi/u-boot/apply.sh`, the changes in `hakios-uefi/u-boot/hakios.patch` and `files/`; the device's part in `hakios-sm7325/u-boot/`
+- the UEFI (the other way to start): [Project Silicium's Mu-Silicium](https://github.com/Project-Silicium/Mu-Silicium) at `e51cd877e31c` -- `hakios-uefi/apply.sh`
+- the GPU's OpenGL ES: [Mesa](https://archive.mesa3d.org/) 25.0.7, the freedreno driver for the Adreno -- `tools/mk-mesa.sh`, the changes in `tools/mesa/`
+- the build tools: Apple's [libdispatch](https://github.com/apple-oss-distributions/libdispatch), [libpthread](https://github.com/apple-oss-distributions/libpthread) and [AvailabilityVersions](https://github.com/apple-oss-distributions/AvailabilityVersions), [bootstrap_cmds](https://github.com/markmentovai/bootstrap_cmds), [unifdef](https://github.com/fanf2/unifdef), the [macOS 13.3 SDK](https://github.com/joseluisq/macosx-sdks) and the [iPhoneOS 16.5 SDK](https://github.com/theos/sdks) -- `xnu-deps/setup.sh`
+- not fetched by anything here: the Darwin 16.5 user space, which you lay out from your own IPSW (`sysimage/`), and the phone's own firmware, pulled from its Android (`fw-*`)
+
## 2026-10-30
+- repositories: `main` is the branch of `hakios-xnu-kernel` -- what was `hakios` and then `u-boot`; `hakios` is gone, `git clone` needs no `-b`
- site: a Changelog page, this file
- site: the commands to start with clone the public repository (`hakios-xnu-kernel`, branch `hakios`); `oosexgang/hakios` is private and cloned for nobody
- site: the documentation synced, with the guide to installing beside Android and the U-Boot page in the table of contents
diff --git a/README.md b/README.md
index 1bdd84d..782f727 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,7 @@ back to its own Android. The one thing written by default is the loader's own lo
## Quick start
```sh
-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios
+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakios
cd hakios
make doctor # what this machine lacks, and what to do
make qemu-open # the open kernel in QEMU: nothing of Apple's, nothing of a phone's
@@ -61,7 +61,7 @@ make phone SECS=600 # a 10-minute session on the phone, in RAM
| Repository | What |
|---|---|
-| [hakios-xnu-kernel](https://github.com/oosexgang/hakios-xnu-kernel/tree/hakios) | **common**: the kernel port, every common driver, the loader, user space, the tools, this documentation, and `devices/qemu` |
+| [hakios-xnu-kernel](https://github.com/oosexgang/hakios-xnu-kernel/tree/main) | **common**: the kernel port, every common driver, the loader, user space, the tools, this documentation, and `devices/qemu` |
| [hakios-sm7325](https://github.com/oosexgang/hakios-sm7325) | POCO X5 Pro 5G: its defconfig, status, UEFI platform, firmware script, and its SoC's layer (`soc/`: the Qualcomm SC7280 family) |
| [hakios-uefi](https://github.com/oosexgang/hakios-uefi) | the firmware that starts the loader: Mu-Silicium with HakiOS's boot path, banner and name, and HakiOS's U-Boot (`u-boot/`) |
| [hakios-metal](https://github.com/oosexgang/hakios-metal) | Metal's command model on the Adreno, through the kernel's GPU driver |
@@ -70,7 +70,7 @@ make phone SECS=600 # a 10-minute session on the phone, in RAM
into `devices/` and `uefi/`. One repository per device: it carries its SoC's layer, and `tools/hakios-device.py new` makes one. [How the repositories fit](docs/porting/repositories.md).
```sh
-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios && cd hakios
+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakios && cd hakios
tools/hakios-device.py sync # the SoC, device and UEFI repositories, at the revisions the manifest names
```
diff --git a/README.uk.md b/README.uk.md
index 913cbab..98dae45 100644
--- a/README.uk.md
+++ b/README.uk.md
@@ -76,7 +76,7 @@ HakiOS — це адаптація ядра Darwin (відкритий XNU ві
Linux x86-64, близько 12 ГБ на диску, 7-Zip 23 або новіший, `lz4`, `qemu-system-aarch64`, `edk2-aarch64`.
```sh
-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios
+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakios
cd hakios
make doctor # чого бракує цьому комп'ютеру (дисплей QEMU, UEFI, пам'ять) і що робити
make unpack IPSW=~/ваш.ipsw # ваш власний IPSW Darwin userland 16.5, потрібне розпаковується (7,4 ГБ)
diff --git a/README.zh.md b/README.zh.md
index 1a380d3..25bf3e8 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -68,7 +68,7 @@ Linux 电脑上的 QEMU(`virt`,aarch64)里运行,不需要任何 Apple
Linux x86-64,约 12 GB 磁盘,7-Zip 23 或更新,`lz4`,`qemu-system-aarch64`,`edk2-aarch64`。
```sh
-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios
+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakios
cd hakios
make doctor # 检查本机缺什么(QEMU 显示设备、UEFI 固件、内存)以及怎么办
make unpack IPSW=~/your.ipsw # 你自己获取的 Darwin userland 16.5 IPSW,解包所需部分(7.4 GB)
diff --git a/docs/concepts/architecture.md b/docs/concepts/architecture.md
index b51168c..c3ae7b1 100644
--- a/docs/concepts/architecture.md
+++ b/docs/concepts/architecture.md
@@ -58,7 +58,7 @@ device's. A device's defconfig is three lines: the common kernel, its SoC's frag
| `/private/var` | only with `ufs_write=1 var_store=1` | the partition `darwin`, which you create yourself (`tools/userdata-carve.py` prints the commands; it changes nothing) |
| anything else | never | the loader refuses every other write; `tools/provenance.allow` lists each piece of code that can write, and why |
-[LEGAL.md](https://github.com/oosexgang/hakios-xnu-kernel/blob/hakios/LEGAL.md) has the same, with what is and is not distributed.
+[LEGAL.md](https://github.com/oosexgang/hakios-xnu-kernel/blob/main/LEGAL.md) has the same, with what is and is not distributed.
## Where the code is
diff --git a/docs/devices/qemu.md b/docs/devices/qemu.md
index 9ecc076..674512a 100644
--- a/docs/devices/qemu.md
+++ b/docs/devices/qemu.md
@@ -9,7 +9,7 @@
| SoC | `none` |
| Configuration | `make qemu_defconfig` |
| Maintainer | the HakiOS developers (README.md) |
-| Repository | [`devices/qemu/`](https://github.com/oosexgang/hakios-xnu-kernel/tree/hakios/devices/qemu) |
+| Repository | [`devices/qemu/`](https://github.com/oosexgang/hakios-xnu-kernel/tree/main/devices/qemu) |
## What works
diff --git a/docs/getting-started/qemu.md b/docs/getting-started/qemu.md
index 5a35f7d..712f61b 100644
--- a/docs/getting-started/qemu.md
+++ b/docs/getting-started/qemu.md
@@ -5,7 +5,7 @@
The kernel, a placeholder loader and a tiny raw-syscall user space: **nothing of Apple's and nothing of any phone's**.
```sh
-git clone -b hakios https://github.com/oosexgang/hakios-xnu-kernel.git hakios
+git clone https://github.com/oosexgang/hakios-xnu-kernel.git hakios
cd hakios
tools/hakios-device.py sync # the SoC, device and UEFI repositories (the open kernel needs none of them; the rest does)
make doctor # what this machine lacks, and what to do
diff --git a/docs/index.md b/docs/index.md
index 61c9d82..85dd847 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -46,7 +46,7 @@ Android. What is and is not written to a phone: [Architecture](concepts/architec
| Repository | What |
|---|---|
-| [hakios-xnu-kernel](https://github.com/oosexgang/hakios-xnu-kernel/tree/hakios) | **common**: the kernel port, every common driver, the loader, user space, the tools, this documentation, and `devices/qemu` |
+| [hakios-xnu-kernel](https://github.com/oosexgang/hakios-xnu-kernel/tree/main) | **common**: the kernel port, every common driver, the loader, user space, the tools, this documentation, and `devices/qemu` |
| [hakios-sm7325](https://github.com/oosexgang/hakios-sm7325) | POCO X5 Pro 5G: its defconfig, status, UEFI platform, firmware script, and its SoC's layer (`soc/`: the Qualcomm SC7280 family) |
| [hakios-uefi](https://github.com/oosexgang/hakios-uefi) | the firmware that starts the loader: Mu-Silicium with HakiOS's boot path, banner and name, and HakiOS's U-Boot (`u-boot/`) |
| [hakios-metal](https://github.com/oosexgang/hakios-metal) | Metal's command model on the Adreno, through the kernel's GPU driver |
diff --git a/docs/porting/drivers.md b/docs/porting/drivers.md
index a11b809..ccc05c4 100644
--- a/docs/porting/drivers.md
+++ b/docs/porting/drivers.md
@@ -91,5 +91,5 @@ The boot log says `hakios-kernel: N drivers built in (... nt36672 ...)`, and `sy
## 5. Write down what it does
The driver's head says what has been seen (on the phone, in QEMU, compiled only). The device's `device.conf` has a `status` line
-for the part it makes work. [docs/driver-review](https://github.com/oosexgang/hakios-xnu-kernel/tree/hakios/docs/driver-review)
+for the part it makes work. [docs/driver-review](https://github.com/oosexgang/hakios-xnu-kernel/tree/main/docs/driver-review)
holds the audits of the common drivers: a new common driver gets one before it is relied on.
diff --git a/tools/docs-gen.py b/tools/docs-gen.py
index 3e2808d..c5a6c99 100755
--- a/tools/docs-gen.py
+++ b/tools/docs-gen.py
@@ -15,7 +15,7 @@ import sys
HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE)
-REPO = "https://github.com/oosexgang/hakios-xnu-kernel/blob/hakios/"
+REPO = "https://github.com/oosexgang/hakios-xnu-kernel/blob/main/"
MARK = {"works": "works", "partial": "partly", "missing": "no"}
HEADER = "<!-- Made by tools/docs-gen.py from %s. Do not edit: change that, then run tools/docs-gen.py. -->\n\n"
diff --git a/tools/hakios-device.py b/tools/hakios-device.py
index 3576778..3fdb454 100755
--- a/tools/hakios-device.py
+++ b/tools/hakios-device.py
@@ -263,7 +263,7 @@ NEW_README = """# {title} ({name})
A HakiOS device repository: what is true of this device and of no other. The kernel, the loader, the drivers and the tools are
the common repository's; the {soc} family's facts are in `soc/`, carried with the device. How the three are put together:
-[docs/porting/repositories.md](https://github.com/oosexgang/hakios-xnu-kernel/blob/hakios/docs/porting/repositories.md).
+[docs/porting/repositories.md](https://github.com/oosexgang/hakios-xnu-kernel/blob/main/docs/porting/repositories.md).
| File | What |
|---|---|