open hardware, open invitation

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

beginner

Edit secrets.py so the badge app pulls your live GitHub profile stats.

5 minTry this hack

Add Your Photo to Gallery

beginner

Drop a PNG into apps/gallery/assets/raw/, deploy, watch it land in the carousel.

8 minTry this hack

Add the Commits Brick-Breaker

beginner

Install the Commits arcade so you can bat merge balls through a wall of green squares.

15 minTry this hack

Theme the OS in your colours

beginner

Edit oreoOS/theme.py to retint the whole UI in a single commit.

10 minTry this hack

Build an IR-Quest beacon

intermediate

Wire a TSOP38 to a spare ESP and beam tokens to nearby badges.

30 minTry this hack

Tilt-to-scroll any app

intermediate

Pull the MPU6050 accel readings into your update() and remap UP/DOWN.

25 minTry this hack

Ship your first app

intermediate

manifest.json + main.py — 30 lines, lands in the drawer.

45 minTry this hack

Self-host OTA updates

advanced

Point the OTA module at your own GitHub fork — ship private builds to your badge.

1 hTry this hack

Spin a PCB

advanced

Use the KiCad project in /docs/hardware/ as a starting point for a v2 board.

4 hTry this hack

Got an idea for a hack?

Write it up as Markdown, drop it in docs/hacks/, send a PR. We'll surface it here.

Open hacks folder on GitHub