Customize Your Badge. Make it weird.
Step-by-step recipes for retinting the OS, writing your first app, or wiring extra sensors. Each hack is one Markdown file on the repo — copy, paste, deploy.
Set Your GitHub Handle
beginnerEdit secrets.py so the badge app pulls your live GitHub profile stats.
Add Your Photo to Gallery
beginnerDrop a PNG into apps/gallery/assets/raw/, deploy, watch it land in the carousel.
Add the Commits Brick-Breaker
beginnerInstall the Commits arcade so you can bat merge balls through a wall of green squares.
Theme the OS in your colours
beginnerEdit oreoOS/theme.py to retint the whole UI in a single commit.
Build an IR-Quest beacon
intermediateWire a TSOP38 to a spare ESP and beam tokens to nearby badges.
Tilt-to-scroll any app
intermediatePull the MPU6050 accel readings into your update() and remap UP/DOWN.
Ship your first app
intermediatemanifest.json + main.py — 30 lines, lands in the drawer.
Self-host OTA updates
advancedPoint the OTA module at your own GitHub fork — ship private builds to your badge.
Spin a PCB
advancedUse the KiCad project in /docs/hardware/ as a starting point for a v2 board.
Got an idea for a hack?
Write it up as Markdown, drop it in docs/hacks/, send a PR. We'll surface it here.
