letterbomb 2.0.0

A fork of the classic Wii hacking tool from fail0verflow

✉💣 LetterBomb

A fork of the classic Wii hacking tool from fail0verflow.

Installation

• PyPi: (recommended)

python3 -m pip install -U letterbomb

• Manual: (development)

git clone https://gitlab.com/whoatemybutter/letterbomb.git
cd letterbomb-master
python setup.py build
python setup.py install

Improvements over original

	WhoAteMyButter's	fail0verflow's
Networking	Not required	Required
CLI	Yes	No
OS support	*nix, Windows, Mac	*nix
Logging	Yes, logging module	Yes, dependent on Flask
Packaging	Git, PyPi	Git
Dependencies	None	Flask, geoip2
Pylint	10.00/10.00	4.65/10.00
Python version	3.6+	2.7 only
License	GPLv3+	MIT
Documentation	Sphinx, docstrings	No

Images

Usage

• Python:

# -*- coding: utf-8 -*-
import letterbomb

# To include BootMii:
letterbomb.write_zip(mac="mac address", region="region letter", pack_bundle=True, output_file="letterbomb.zip")
# To exclude BootMii
letterbomb.write_zip(mac="mac address", region="region letter", pack_bundle=False, output_file="letterbomb.zip")
# To log debug messages
letterbomb.LOGGING_LEVEL = letterbomb.logging.DEBUG
# To log output to a file
letterbomb.LOGGING_FILE = "log.txt"

• CLI:

# Help
python3 -m letterbomb -h

# To include BootMii
python3 -m letterbomb mac_address region -b

# To enable logging debug
python3 -m letterbomb mac_address region -g debug

# To use a file for logging output
python3 -m letterbomb mac_address region -l logfile.txt

Documentation

Most casual users should refer to the ReadTheDocs page.

Some may want to build the documentation manually. To do this:

git clone https://gitlab.com/whoatemybutter/letterbomb.git
cd letterbomb-master/docs
make html
xdg-open _build/html/index.html

If you prefer one-liners, there is one below:

git clone https://gitlab.com/whoatemybutter/letterbomb.git; cd letterbomb-master/docs; make html; xdg-open _build/html/index.html

Before re-building the documentation, you should also run make clean to prevent stale files from remaining in newer builds.

To read about the exploit itself in more detail, please read this article.

Source code

• The source code can be found at https://github.com/fail0verflow/letterbomb.
• The website can be found at https://please.hackmii.com.

Note: Original code likely will not work out-of-the-box.

License

Letterbomb is licensed under GPLv3+. (included file)