Aurora Porter

Adaptive Treble-style GSI generator — produces a portable system.img from any Android ROM.

Aurora Porter is a pure system-image generator that takes a stock ROM (for vendor expectations) and a target ROM (for framework), and generates a single Treble-compatible system.img that boots on the stock device vendor.

---

Philosophy

Aurora Porter thinks like Project Treble, not like a ROM kitchen.

Keeps from stock device	Replaces with target framework
vendor partition	/system
kernel & boot image	(untouched)
firmware & HALs	(untouched)
vendor_boot / dtbo / vbmeta	(untouched)
ODM hardware stack	(untouched)

Aurora Porter never touches vendor, boot, kernel, firmware, or hardware layers. It only re-packs the Android framework layer — the part you actually want to change.

---

Quick Start

# Prerequisites: Python 3.12+, Linux/WSL2
# Required external tools: mkfs.erofs / mke2fs + e2fsdroid

# Install
pip install aurora-porter

# Generate a GSI
aurora-porter stock-ROM.zip custom-ROM.zip

# Output: workspace/output/system.img

Options

Flag	Description
--debug	Verbose debug output
--permissive	Build with permissive SELinux
--clean	Clean workspace before starting
--keep-workspace	Keep workspace after completion
--analyze-only	Analyze only, don't build

---

Internal Pipeline

stock ROM             target ROM
    ↓                      ↓
extract vendor       extract framework
expectations              ↓
(SELinux, VINTF,     sanitize hardware
 HAL configs,         bindings
 OEM quirks)               ↓
    ↓                 rewrite properties
    ├────────────────► inject overlays
    │                 merge SELinux
    │                 resolve VNDK deps
    │                      ↓
    │                 build system.img
    │                 (EROFS / EXT4)
    ▼
ONE portable system.img

6 Phases

Phase	Name	What happens
0	Intake	Parse both ROM ZIPs, detect metadata (API level, arch, OEM)
1	Analysis	Compare compatibility, analyze vendor/VINTF/APEX structure
2	Extract Framework	Extract system/system_ext/product from target, merge tree
3	Sanitize	Remove hardware bindings, rewrite props, inject overlays
4	Analyze Libraries	Check VNDK/LL-NDK dependency compatibility
5	Build	Repack merged tree as EROFS or EXT4 system.img

---

Architecture

aurora/
├── cli/main.py          # Click CLI, 6-phase pipeline
├── core/                # Base classes, config, exceptions
├── engines/             # Processing engines
│   ├── intake.py        # RomIntakeEngine
│   ├── payload.py       # PayloadExtractionEngine
│   ├── filesystem.py    # FilesystemEngine (mount, extract)
│   ├── gsi_repack.py    # GSIRepackEngine (system.img builder)
│   ├── elf_analyzer.py  # ELF dependency scanner
│   ├── shared_lib.py    # VNDK/LL-NDK dependency analyzer
│   ├── hal_sanitizer.py # Hardware binding sanitizer
│   └── bootloop.py      # Boot diagnostics
├── analyzers/           # Analysis modules
│   ├── rom_analyzer.py  # Stock vs target comparison
│   ├── vendor.py        # Stock vendor structure analysis
│   ├── vintf.py         # VINTF manifest analysis
│   └── apex.py          # APEX container analysis
├── patchers/            # Adaptation engines
│   ├── selinux.py       # SELinux policy merging
│   ├── props.py         # GSI property rewriting
│   ├── overlay.py       # RRO overlay injection
│   └── auto_patch.py    # Orchestrated patch pipeline
├── profiles/            # OEM knowledge base
│   ├── oem.py           # Samsung, Xiaomi, OnePlus, Google profiles
│   └── quirks.py        # Chipset-specific workarounds
├── plugins/             # Plugin system
└── utils/               # Helpers, subprocess, Android constants

---

Output

The only artifact is:

output/system.img

Optionally (based on detected compatibility):

output/system-erofs.img
output/system-ext4.img
output/system-sparse.img

---

Compatible Devices

Any Treble-compatible Android device (Android 8.0+ with Project Treble).

Vendor	Status	Notes
Google	Reference	Acts as official GSI baseline
Samsung	Supported	RKP/CFP must be disabled in kernel
Xiaomi	Supported	MIUI-specific overlay adaptation
OnePlus	Supported	Alert Slider and FOD workarounds
Nothing	Experimental	Minimal testing
Huawei	Unsupported	Kirin bootloader restrictions

---

Research & Design

• Project Treble
• GSI Architecture
• VNDK
• SELinux
• Phhusson GSI
• TrebleDroid

---

License

GPL-3.0-only