Skip to content
akshaynexusPublic

About

iOS 27 next to One UI on a rooted Galaxy S24 Ultra, switched the way OneOS switches Androids

Resources

Contributing

Stars

14 stars

Watchers

1 watching

Forks

Repository files navigation

OneiOS

iOS 27 next to One UI on a rooted Samsung Galaxy S24 Ultra — switched to and back the way OneOS switches Androids. Nothing flashed, the image lives in a folder, One UI's kernel keeps running.

Status: experimental, under active development. On the phone it boots to the Home Screen (unlock works, GPU-composited at 40–60 fps, touch works) and returns to One UI. See what works and known issues below — both are kept honest.

OneOS's guests are Android systems that run unchanged on One UI's Linux kernel. iOS's userland needs Apple's kernel (XNU), so OneiOS runs a source-built XNU as a process on One UI's kernel (runtime/xnuhost): iOS's processes are Linux processes whose system calls and faults go to it. How it fits together: docs/architecture.md.

Quick start

Prerequisites: Linux x86_64 PC, the pinned Apple IPSW pieces (fetched, never committed), NDK 28.2, Rust 1.95+, qemu-aarch64. Full flow: docs/building.md.

P=iphone18,2-ios27.0.1-24A446
scripts/fetch/fetch.sh --list "$P"          # compare the profile with Apple's IPSW (~1 MiB)
scripts/bg.sh fetch scripts/fetch/fetch.sh "$P"   # the IPSW members from Apple, into inputs/
kernel/fetch.sh                             # the kernel's sources at the commits of kernel/pins.sh
scripts/bg.sh image scripts/image/build.sh "$P" --kernel out/kernel/24A446/kernel.kc
scripts/bg.sh kernel-hosted env HOSTED_OUT=me kernel/build-hosted.sh
scripts/bg.sh prelink env KERNEL=out/kernel/current-hosted-me/xnu.macho kernel/prelink/build.sh
runtime/build.sh STAGE                       # -> STAGE/bin/xnuhost and helpers

Long jobs run in tmux via scripts/bg.sh NAME COMMAND...; check them with scripts/bg.sh -s NAME.

What works

Area Phone (S24 Ultra) PC (qemu-aarch64) Notes
Boot to Home Screen Yes — lock screen, swipe unlock, apps shown (hosted 0035–0037) Yes — launchd, SpringBoard, backboardd docs/booting §6
GPU compositing Yes, 40–60 fps via virtio-gpu Yes, frames captured docs/gpu.md
Touch + buttons Yes Scripts (--input-script) HID via kernel event driver
Battery Published to iOS Stand-in tested Real readings on phone
Wi-Fi Joins; scan rate cut 20→5/min (reuse works); late-enable merged, phone proof pending Sim radio (wifi=sim) docs/hardware.md
Haptics / keyboard Fix merged, phone proof pending Host-tested Typing drives Preferences 100%+ (the overheat path); XPC-timeout cause proven from iOS log
Interrupts / Mach RPC — Verified: 41k host-call IPIs vs 110 trapped oneios-perf rpc:/0081: lines
Return to One UI Yes — chord, SIGKILL backstop n/a Never touches side keys, realtime, or /sys/power
Host test suites n/a All green (loader, xnuhost, bridges, display, prelink audit 0 failures) runtime/host-tests.sh

Known issues

Issue State Tracking
SpringBoard died once on unlock (missing process identity assertion) Historical, not reproduced since git history, agents board
Typing overheats the phone (Preferences 100%+, the main bug) Prime suspect hapticd XPC timeouts; preset fix merged (hosted 0078), phone proof pending; thermal: + oneios-cpu-sys: lines added for diagnosis docs/hardware.md §5
Wi-Fi scan slow; enable waits on configd (~3 min) Scan reuse 20→5/min works; result/join latency still slow on phone (cause open); enable fix merged (oneios-wifi-up), phone proof pending docs/hardware.md
Audio: MMAP start gap, lateness metric Landed on PC, phone proof pending docs/hardware.md
HEVC encode: no real frame encoded yet Guest side staged, stand-in tested PR #59
Camera capture device (iOS side) Not built docs/hardware.md
Auto-brightness via light sensor Attaches, no readings through it yet docs/hardware.md
Shared-region protect no-op count still 0 Optimization unproven kernel README "0080"
Mac kernel panics in first 2 s Old news, Mac runtime boots with Linux kernel.kc kernel/prelink/README.md
Kernels built from main between the A56 merge (b2fa083) and 2026-11-21 died at launchd (mach_ports_lookup() failed: -300, panic initproc exited) Fixed: hosted 0068 is opt-in (oneios-legacy-registered-ports=1); PC boot to SpringBoard again kernel/patches/oneios-hosted/README.md (A56 section)
Never goals Passcode, Face ID, Wallet, calls, SMS —

Devices

Primary target: the rooted Galaxy S24 Ultra. S25 Ultra, S26 Ultra and Galaxy A-series run in forks; portable work lands here. Full map: docs/forks.md.

Device Status Best result
Galaxy S24 Ultra Galaxy S24 Ultra (SM-S928, SM8650) — this repo Boots to Home Screen, returns to One UI Daily driver target
Galaxy S25 Ultra Galaxy S25 Ultra (SM-S938, SM8750) — s25ver snapshot, denis fork (mirror) Ported: Oryon topology fix, probe tool, metal fixes Big-only-SoC bug fixed for all
Galaxy S26 Ultra Galaxy S26 Ultra (SM-S988, SM8850) — YMGPwcca/OneiOS ~600 s iOS run on device Haptics + backend tests ported
Galaxy A56 Galaxy A56 (SM-A566E, Exynos 1580) — Musicalista/OneiOS-A56 iOS 16.5 to lock screen on device GPU template, bootstrap, triage tools

Device photos: official Samsung product images (samsung.com, Samsung Newsroom press kits), © Samsung Electronics — used for device identification. A56 photo: Captainmorlypogi1959 via Wikimedia Commons (CC BY-SA 4.0).

Layout

docs/architecture.md  how the parts fit; docs/building.md  how to build and test; docs/*.md  each part in detail
docs/forks.md         device forks: what runs where, what was ported back, the multi-device pattern
profiles/             the pinned IPSW profile (iPhone18,2 iOS 27.0.1 24A446)
scripts/fetch/        fetch only the needed IPSW members from Apple's CDN (never from here)
scripts/image/        build the image set (manifest, SHA-256, .tar.zst)
userland/             iOS 27 root and Data tweaks (the image hook), guest helpers, the camera plug-in
kernel/               XNU 12377 (UniXNU / Droid-VM fork) built on Linux; oneios-hosted/ patches; prelink/ (kernel.kc)
runtime/              xnuhost and its loader, the display helper, the hardware bridges, the runtime package
drivers/              iOS-side drivers for the bridges (CPU, network, Bluetooth, haptics, audio, brightness, camera)
oneos/                the contract with the OneOS fork (akshaynexus/OneOS, branch oneios)

Rules

  • No Apple files in git or in releases. IPSWs, cryptexes, kernelcaches, kexts, kernel.kc and every image built from them stay in out/ and inputs/ (git-ignored). Scripts fetch them from Apple and build them on the owner's machine. Releases carry only this project's own code (scripts, runtime binaries, the OneOS patches). The default kernel is built locally (it links Apple's corecrypto); a release carries only the hosted ONEIOS_CRYPTO=original xnu.macho (no Apple code in it), which each phone prelinks into its own kernel.kc (docs/releases.md).
  • Long jobs run in tmux: scripts/bg.sh NAME COMMAND....
  • Every change updates the docs that describe it: CLAUDE.md.

License

No license file yet — all rights reserved until the owner adds one.

Credits

OneOS (fahadalijaved) and OneLineage (WeWaffles): the container hot-switch. MysticGSI: the image build model. UniXNU and Droid-VM: XNU on non-Apple ARM64, drm2kgsl, the guest drivers. iOSPlus10: XNU and iOS userland on Qualcomm phones, haptics and brightness. Darling: Mach and XNU on Linux.

About

iOS 27 next to One UI on a rooted Galaxy S24 Ultra, switched the way OneOS switches Androids

Resources

Contributing

Stars

14 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages