aarvsn / PS5Droid

# PS5Droid
**Native Android runtime research for jailbroken PlayStation 5 consoles.**
PS5Droid is an open-source systems-research project that investigates —
step by step, with test evidence — what it would take to run Android
application components directly inside a native PS5 homebrew payload.
It is *not* a Linux boot, a VM, an emulator image, or a Waydroid port,
and it does **not** claim to run Android apps today. Every capability
this repository ships is either tested on the host, implemented against
verified console APIs but not yet console-executed, or honestly marked
not implemented / blocked.
Waydroid is used as an *architectural reference* only (see
`docs/waydroid-analysis.md`); no Waydroid
code is imported. Low-level console facts come from the open-source
ps5-payload-sdk ecosystem.
## Current status
| Area | Status |
|---|---|
| Portable platform layer (memory, threads, fs, IPC) | **Implemented and tested (host)** |
| Linux ABI dispatch experiment (guest fd table, epoll/eventfd, mmap/brk/futex subset) | **Implemented and tested (host)** |
| Compatibility matrix (77 syscalls: 22 emulated / 2 partial / 53 unsupported) | **Implemented and tested (host)** |
| Capability probes + runtime manager with structured blockers | **Implemented and tested (host)** |
| Android image manifest + SHA-256 + read-only ext4 superblock probe | **Implemented and tested (host)** |
| Launcher UI model + 8x8 framebuffer font | **Implemented and tested (host)** |
| Native PS5 payload (`ps5droid.elf`, video-out + pad + user service) | **Implemented, NOT tested on console** |
| PS5 PKG packaging | **Not implemented** (ELF-payload path only) |
| Linux binary loading / bionic re-hosting (Milestone 4) | **Implemented and tested (host)** |
| Binder re-hosting (Milestone 5) | **Implemented and tested (host)** |
| APK package inspection (Milestone 6) | **Implemented and tested (host)** |
| Audio output | **Not implemented** (explicitly reported unsupported) |
| Vulkan / GPU-accelerated Android graphics | **Blocked** (no Vulkan driver for homebrew; proprietary AGC/GNM only) |
Build status: host build + 40 unit tests green (gcc and clang, ASan/UBSan
clean). The PS5 target is cross-built in CI only when explicitly
requested, using the official open-source SDK.
## Architecture in one page
 [code] 
* **platform/** — portable memory/thread/fs/display/input primitives;
 the PS5 backend uses ps5-payload-sdk facilities with hand-maintained,
 provenance-documented firmware declarations.
* **compat/** — accepts Linux x86_64 syscall numbers and executes a
 small, honestly classified subset (anonymous memory, clocks, futex
 wait/wake, streams); everything else returns `-ENOSYS` with an
 explanation. The verified Linux→FreeBSD number mapping (e.g. mmap
 9→477) is data in `src/compat/linux_abi.h`.
* **android/** — image handling (manifest, SHA-256, ext4 superblock
 probe; no mounting is possible on Orbis) and the runtime manager whose
 start attempt always reports structured, reasoned