// READY TO USE

Badge Apps

Browse 8 badge apps. 6 ship ready to boot. We also maintain 2 sideloadable builds below when you want to expand the catalog.

Built-In & Ready

All apps come installed and configured on your badge from day one.

Fully Customizable

Many apps can be customized through simple config files.

Open Source Code

All source code is accessible and documented for learning and modification.

Built-In Apps

Badge

Badge

Digital conference badge from GitHub profile. Live API data: followers, repos, contributions. WiFi required.

Flappy Mona

Flappy Mona

Flappy Bird clone with gravity physics. Parallax scrolling backgrounds. Procedural obstacle generation.

Gallery

Gallery

Photo viewer with thumbnail carousel. 7-image preview strip. Auto-hiding UI after 2s inactivity.

Mona's Quest

Mona's Quest

IR beacon scavenger hunt. Find 9 Universe stations using infrared signals. Real-time progress tracking.

Monapet

Monapet

Virtual pet simulator. Manage three stats: happiness, hunger, cleanliness. Autonomous movement + mood animations.

Monasketch

Monasketch

Etch-A-Sketch style drawing app. D-pad controls cursor for pixel art. Mona reacts to cursor position.

Loadable Apps

Copy these folders from the badger/home repository into `/apps/` on your badge to try additional community builds.

Commits

Commits

MANUAL LOAD

Breakout-style brick field using GitHub greens. Auto-play targeting and lives counter.

Snake

Snake

MANUAL LOAD

Classic snake re-skinned with GitHub commit squares and four-direction controls.

Badge Filesystem Structure

Understanding where your apps live and how to access them.

Apps Directory Structure 

/Volumes/BADGER/
├── apps/
│   ├── badge/
│   │   ├── __init__.py
│   │   └── icon.png
│   ├── commits/
│   │   ├── __init__.py
│   │   └── icon.png
│   ├── flappy/
│   │   ├── __init__.py
│   │   ├── mona.py
│   │   ├── obstacle.py
│   │   └── assets/
│   ├── gallery/
│   │   ├── __init__.py
│   │   ├── icon.png
│   │   ├── images/
│   │   └── thumbnails/
│   ├── menu/
│   │   ├── __init__.py
│   │   ├── icon.py
│   │   └── ui.py
│   ├── monapet/
│   │   ├── __init__.py
│   │   ├── icon.png
│   │   ├── mona.py
│   │   ├── ui.py
│   │   └── assets/
│   ├── quest/
│   │   ├── __init__.py
│   │   ├── beacon.py
│   │   ├── icon.png
│   │   ├── ui.py
│   │   └── assets/
│   ├── sketch/
│   │   ├── __init__.py
│   │   ├── icon.png
│   │   ├── ui.py
│   │   └── assets/
│   ├── snake/
│   │   ├── __init__.py
│   │   └── icon.png
│   └── startup/
│       ├── __init__.py
│       └── frames/
├── assets/
│   ├── fonts/
│   ├── icons.png
│   └── mona-sprites/
├── main.py
└── secrets.py

Accessing Apps

Apps can be launched from the badge menu or inspected directly from the REPL: 

import os
os.listdir('/apps')

# example: run flappy from a REPL session
exec(open('/apps/flappy/__init__.py').read())

Customizing Apps

Most apps expose straight Python or asset files you can tweak while mounted: 

# Edit via USB file access
# example: adjust Monapet UI text
edit('/apps/monapet/ui.py')

💡 Pro Tips

  • • Mount the badge drive (typically `/Volumes/BADGER`) to read and edit `/apps/` and shared assets
  • • Always back up config files before making changes
  • • Check each app's documentation page for detailed customization options
  • • Use the badge's file manager app to browse and edit files on-device