💿 AluminiumOS

---

📌 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!

💡 The Vision: 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.

⚡ Current Status

Important

What Works: The image boots flawlessl in terminal!

Bugs

1. Graphics: Display output is currently unavailable due to missing virtio drivers in the kernel (fixing it rn!)
2. Cuttlefish kernel/ramdisk: For injecting the drivers the ramdisk and kernel of cuttlefish are needed, but 'init' its rejecting its fstabs
3. Audio: Probably due to the same error as graphics, sound isnt avaliable right now

---

🚀 Features

• 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 all the bugs (video, audio, keymint, etc)
• Boot with cuttlefish ramdisk and kernel
• Execute it natively without a host OS (impossible??)

---

🔗 Links

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

❤️ Credits

• 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