How mercuryworkshop/sh1mmer works
SH1MMER is a ChromeOS RMA-shim modification toolkit, with a companion browser-based builder. The principal workflow is to supply a raw RMA shim, build a modified image, flash and boot it on a Chromebook, then use the resulting shim interface. The repository also includes firmware/GPT image utilities and separate legacy and beautiful-world shim runtimes. README documents the build and boot sequence; the source excerpts show Python utility relationships and the browser builder’s emulator setup. Other runtime wiring is not shown, so uncertain links are omitted.
Main entry points: wax4web.js Wax4Web interface · image_tool.py Image manipulation · wax.sh Wax build entry · sh1mmer_main.sh Shim main interface
Components 21
Image building
- Wax build entry
wax/wax.sh - Kernel checks and archives
wax/kernarchive.sh
Image utilities
- Image manipulation
wax/lib/py/image_tool.py - GPT operations
wax/lib/py/pygpt.py - FMAP codec
wax/lib/py/fmap.py - Firmware settings
wax/lib/py/netboot_firmware_settings.py
Shim runtime
- Shim bootstrap
wax/sh1mmer_bw/bootstrap/noarch/init_sh1mmer.sh - Shim init
wax/sh1mmer_bw/init - Shim main interface
wax/sh1mmer_bw/root/noarch/usr/sbin/sh1mmer_main.sh - Beautiful World GUI
wax/sh1mmer_bw/root/noarch/usr/sbin/sh1mmer_gui.sh - Options and payloads
wax/sh1mmer_bw/root/noarch/usr/sbin/sh1mmer_optionsSelector.sh - Payload launcher
wax/sh1mmer_bw/root/noarch/usr/sbin/sh1mmer_payload.sh - Payload collection
wax/payloads
Browser builder
- Wax4Web interface
wax4web/wax4web.js - v86 emulator
wax4web/libv86.js - Emulator assets
wax4web
Other components
- Builder / user
- Raw RMA shim
- USB flasher
- Chromebook
- Built image download
Connections 22
- Builder / user → Raw RMA shim: provides
README.md - Builder / user → Wax build entry: runs build
README.md - Raw RMA shim → Wax build entry: input image
README.md - Wax build entry → Image manipulation: builds image
- Image manipulation → GPT operations: uses GPT utility
wax/lib/py/image_tool.py - Image manipulation → FMAP codec: uses FMAP codec
wax/lib/py/image_tool.py - Image manipulation → Firmware settings: imports settings
wax/lib/py/image_tool.py - Wax build entry → Kernel checks and archives: checks kernel
- Builder / user → USB flasher: flashes image
README.md - USB flasher → Chromebook: writes image
README.md - Chromebook → Shim bootstrap: boots shim
README.md - Shim bootstrap → Shim init: starts runtime
- Shim init → Shim main interface: starts interface
- Shim main interface → Beautiful World GUI: offers GUI
- Shim main interface → Options and payloads: offers options
- Options and payloads → Payload launcher: launches payloads
- Payload launcher → Payload collection: runs scripts
- Builder / user → Wax4Web interface: opens builder
- Wax4Web interface → v86 emulator: starts emulator
wax4web/wax4web.js - Wax4Web interface → Emulator assets: loads assets
wax4web/wax4web.js - Wax4Web interface → Raw RMA shim: uploads shim
wax4web/wax4web.js - Wax4Web interface → Built image download: offers image
wax4web/wax4web.js