letterbomb 3.1.0

A fork of the classic Wii hacking tool from fail0verflow

✉️💣 LetterBomb

A fork of the classic Wii hacking tool from fail0verflow.

Table of Contents

• Installation
  • PyPi
  • Manual
• Improvements
• Images
• Usage
  • Python
  • CLI
• Documentation
• Original source code
• License

Installation

PyPi: (recommended)

python3 -m pip install -U letterbomb

Manual: (development)

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

Improvements over original

	WhoAteMyButter's	fail0verflow's
Networking	Optional	Required
CLI	Yes	No
OS support	*nix, Windows, Mac	*nix
Logging	Yes, Flask, logging	Yes, dependent on Flask
Exceptions	Yes	No
Packaging	Gitlab, PyPi	Git
Dependencies	None (Flask for web)	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

# Write to file, include BootMii:
letterbomb.write_zip(mac="mac address", region="region letter", pack_bundle=True, output_file="letterbomb.zip")
# Write to file, exclude BootMii:
letterbomb.write_zip(mac="mac address", region="region letter", pack_bundle=False, output_file="letterbomb.zip")

# Write to stream, include BootMii:
letterbomb.write_stream(mac="mac address", region="region letter", pack_bundle=True)
# Write to stream, exclude BootMii:
letterbomb.write_stream(mac="mac address", region="region letter", pack_bundle=True)

# 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

# To stream bytes instead, include BootMii
python3 -m letterbomb mac_address region -b -i

# To stream bytes instead, useful for piping
python3 -m letterbomb mac_address region -i

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/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/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.

Original source code

• The original source code can be found at https://github.com/fail0verflow/letterbomb.
• The original 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)