3DS Badge Minter

Pick badges, mix in your own PNGs, and compile them into BadgeData.dat + BadgeMngFile.dat for your 3DS HOME Menu. Run it from a terminal menu or a web app.

The 3DS holds 1,000 badges / 100 sets at once. This tool lets you choose which, add custom PNG badges, unlock infinite quantities, and set app shortcuts for your region.

What you need

Two things in the resources/ folder. The first you supply once; the second downloads itself.

1. A decryption key. Required to read badge data. Dump boot9.bin from your own console with GodMode9 and put it in resources/. (Alternatives: a 32-char hex BOSS key in resources/boss_key.txt, or pass --key HEX.)
2. The badge data. Run ./badges.sh --download to fetch the official sets into resources/.

Python 3.8+ is the only dependency; the first ./badges.sh run installs the rest into .venv automatically.

# put boot9.bin in resources/ first, then:
./badges.sh --download     # download official badges
./badges.sh check          # (optional) verify the files are genuine

Compile

Terminal: ./badges.sh

Key	Action
↑/↓ or j/k	Move
g / G	Jump to top / bottom
Space	Toggle set
a / n	Select all / none
Enter	Compile
q	Quit

Web: ./badges.sh prep && ./badges.sh web, then open http://localhost:8443/. Tick sets, pick a region, click Build. Re-run prep after changing anything in custom/ or resources/.

Compiled files land in output/.

Install on your 3DS

1. Copy output/BadgeData.dat and BadgeMngFile.dat to your SD card at /3ds/SimpleBadgeInjector/.
2. Run simple-badge-injector from the Homebrew Launcher and choose inject badge data.

Custom badges

One folder per set in custom/, PNGs inside. They're mixed in alongside the official sets. See custom/README.md.

Commands

Run ./badges.sh help for the full guide. The essentials:

Command	Does
./badges.sh	Terminal compiler
./badges.sh --download	Download official badges
./badges.sh prep / web	Build the web index, then serve it on port 8443
./badges.sh validate	Check the compiled output
./badges.sh clean	Delete regenerable caches/output
./badges.sh cia <extract|scan|compare|cab-keys>	Rebuild pc_*.zip from your own .cia dumps (advanced)

License

GPL-3.0. See LICENSE. Covers the code only; you supply your own badge data. Not affiliated with Nintendo.