How danbyumagic/gbrunch works
GBRUNCH builds a local, recovery-derived Googlebook OS compatibility image and deploys it to an external USB trial or, experimentally, an internal dual-boot layout. The user-facing loop begins in the Linux toolbox: prepare the official recovery, build locally, trial-boot the result, then return to collect diagnostics. Separate capabilities cover toolbox persistence, SSD/userdata maintenance, QEMU research and AMD graphics investigation. The README documents the broad workflow; source excerpts show selected assembly, install and storage calls, so unsampled subsystem links are omitted where their wiring is not established.
Main entry points: dualboot_installer.py Internal installer · inspect_recovery.py Recovery inspection · trial.py USB trial deployment · assemble_native_android.py Compatibility image assembly
Components 18
Linux Toolbox
- Toolbox desktop
toolkit/live/root/opt/gbrunch/dashboard.py - Persistent workspace
toolkit/live/root/opt/gbrunch/storage.py
Image Preparation
- Recovery inspection
tools/inspect_recovery.py - Compatibility image assembly
tools/assemble_native_android.py - QEMU lab assembly
tools/assemble_external_lab.py - Compatibility probe
tools/build_compat_probe.py
Deployment and Boot
- USB trial deployment
toolkit/live/root/opt/gbrunch/trial.py - Internal installer
tools/dualboot_installer.py - Googlebook boot menu
tools/googlebook_boot_menu.py
Diagnostics and Maintenance
- Hardware reports
toolkit/live/root/opt/gbrunch/report.py - Userdata maintenance
tools/maintain_userdata_guest.py - External SSD maintenance
tools/maintain_external_ssd_macos.py
Research Integrations
- AMD source preflight
tools/build_amd_kernel_modules.py - AMD source provenance
tools/amd_source_provenance.py - Windows VM launcher
vm/windows/launch.py - VM asset manifest
vm/windows/make_manifest.py
Other components
- Laptop user
- Googlebook OS
Connections 22
- Laptop user → Toolbox desktop: uses
README.md - Toolbox desktop → Recovery inspection: starts recovery prep
- Recovery inspection → Compatibility image assembly: inspects recovery
tools/assemble_native_android.py - Laptop user → Compatibility image assembly: prepares image
README.md - Compatibility image assembly → Googlebook OS: produces local image
README.md - Laptop user → USB trial deployment: requests USB trial
README.md - USB trial deployment → Persistent workspace: uses workspace
toolkit/live/root/opt/gbrunch/trial.py - USB trial deployment → Internal installer: calls deployment helpers
toolkit/live/root/opt/gbrunch/trial.py - USB trial deployment → Googlebook OS: deploys trial for boot
README.md - Laptop user → Internal installer: requests internal install
README.md - Internal installer → Recovery inspection: imports GPT reader
tools/dualboot_installer.py - Internal installer → Googlebook boot menu: renders boot menu
tools/dualboot_installer.py - Internal installer → Googlebook OS: installs boot path
README.md - Laptop user → Hardware reports: collects logs
README.md - Laptop user → External SSD maintenance: maintains SSD
README.md - External SSD maintenance → Userdata maintenance: runs isolated maintenance
- QEMU lab assembly → Recovery inspection: imports GPT reader
tools/assemble_external_lab.py - Laptop user → Compatibility probe: runs VM probe
- Compatibility probe → Recovery inspection: imports GPT reader
tools/build_compat_probe.py - Laptop user → AMD source preflight: investigates AMD
README.md - AMD source preflight → AMD source provenance: uses provenance checks
- VM asset manifest → Windows VM launcher: imports launcher helper
vm/windows/make_manifest.py