---

About the Project

AluminiumOS is a new OS made from Google for the new Googlebooks, still not released, and its based on Android 17 for arm64 devices, but using QEMU and emulating the android boot stages and disk we can boot it on X86_64 devices!

Objective: While the immediate milestone is achieving a rock-solid emulated boot, the ultimate, long-term horizon explores the thrilling possibility of running this system natively on PC hardware.

Status [WIP]

Important

What Works: The image boots flawlessl in terminal and has video output!

Bugs

1. RILd: Host features like wifi or bluetooth are very probably unfunctional, but is untested

---

Features and things that do work

• QEMU Emulation Core — Sculpting a bespoke environment tailored to trick the ARM-focused GSI into running seamlessly on x86/x64 instruction sets.
• GICv3 Driver Support — Precision-handling of complex GICv3 system interrupts and critical boot-stage initializations.
• Advanced Logger — Tracks system lifecycles locally inside logs/. Easily silence it by passing the -l flag.
• Interactive Build Menu — Fire up a streamlined, user-friendly compilation menu via -b, or run individual scripts directly.
• Dynamic Image Updates — Need to swap out the super or disk partitions? Toggle the automated update menu via -u to handle backend modifications instantly.
• Trusty TEE Sandbox — Fully modular security layer. Compile Trusty from source, download pre-made binaries with -t, or bypass it entirely using -n.
• Stage-1 Init Debugger — Trapped in a bootloop? Drop right into a raw interactive console at the earliest phase of Android init using the -d flag.
• Centralized Command Center — No more digging through nested folders. The master script.sh controls every single lifecycle process out of the box.
• Help Menu — Drop the -h flag (or run the script with zero arguments) to pull up a cleanly formatted manual of all system flags.
• WIP but Functional — Currently boots successfully using custom manual adaptations for the Comet ramdisk and kernel (Cuttlefish orchestration is coming next!).

---

TODO list

• Achieve a successful boot
• Build with trusty and GICv3
• Eliminate video bug
• ELiminate all the rest of bugs (bt, wifi, ...)
• Boot with cuttlefish ramdisk and kernel
• Execute it natively without a host OS (impossible??)

---

Installation

• Copy or download the install.sh file and execute it or clone the repo with submodules and install qemu manually

---

Links

• XDA Thread: AluminiumOS in x86/x64 PCs (WIP) - For bug reports, questions or any information. Any contribution its appreciated!
• My contact: my telegram or my group chat- For errors or info that cannot be published on the main XDA thread

Disclaimer

• The submodule in GitLab has been obtained from MysticLeaks on Telegram and its property of him or Google INC, the creator of this module denieds any credit or responsability over them
• The scripts or files on this repo like init.sh or create_disk.sh are

---

Credits <3

• Mystic Leaks for the leaked ALOS image
• AOSP for trusty source code and qemu for trusty binary
• Magisk for the magiskboot binary
• QEMU for the framework that makes this project possible
• Android CI for cuttlefish files
• Google for comet files
• All the XDA threads and web pages about documenting ARM64 in QEMU, GICv3 and android boot process for their amazing info
• Waveipfy Vercel for the animated logo