Skip to content

Repository files navigation

BrewMate

Automated 3DS homebrew installation tool. Point it at your 3DS SD card, select your console type and firmware, and BrewMate handles the exploit chain, payload fetching, and on-console instructions.

Features

  • Automatic console/firmware detection from SD card ID0
  • MSET9 exploit automation for 3DS/New3DS on firmware 11.0-11.4
  • Payload fetching from GitHub releases with caching
  • SD card structure validation and backup before modifications
  • Post-install verification with NAND backup enforcement
  • Cross-platform — Windows, macOS, Linux

Legal

BrewMate ships zero Nintendo code. It fetches open-source payloads (Luma3DS, boot9strap, SafeB9SInstaller, GodMode9, FBI) from their official repositories. Running homebrew on your own console is legal. This tool is for educational and personal use only.

Usage

python brewmate.py

# Or specify mode:
python brewmate.py setup      # Setup stock console (MSET9)
python brewmate.py finalize   # Finalize CFW installation

Requirements

  • Python 3.11+
  • 3DS with stock firmware (11.0-11.4) or pre-hacked with CFW
  • SD card (FAT32, recommended 8GB or larger)
  • Internet connection (for payload downloads)

Workflow

Setup (Stock Console)

  1. Insert 3DS SD card into computer
  2. Run BrewMate → select console type + firmware
  3. BrewMate prepares the SD card with MSET9 exploit
  4. Reinsert SD card, follow on-console instructions
  5. Continue to Finalization step

Finalize (Post-CFW)

  1. Reinsert SD card into computer
  2. Run BrewMate → Finalize mode
  3. Verifies CFW installation, installs essential homebrew
  4. Prompts for NAND backup (critical!)
  5. Done — enjoy CFW

Architecture

  • exploits.py — Firmware/console matrix for MSET9 offsets
  • sdcard.py — SD card detection, ID0 parsing, CFW check
  • profile.py — Console profile data structure
  • payloads.py — Fetch and cache payloads from GitHub
  • builder.py — Write exploit/payload data to SD
  • steps.py — On-console instruction rendering
  • verify.py — Post-install checks and finalization
  • brewmate.py — TUI orchestration

Support

For issues or questions, refer to 3ds.hacks.guide and the Luma3DS wiki.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages