A fork of the classic Wii hacking tool from fail0verflow
Project description
✉️💣 LetterBomb
A fork of the classic Wii hacking tool from fail0verflow.
Table of Contents
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)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
letterbomb-3.0.0.tar.gz
(4.8 MB
view hashes)
Built Distribution
Close
Hashes for letterbomb-3.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4684c512c7dc9f0c5ab880651090d988f657b1fbb314eb362efb4b97eda39770 |
|
MD5 | f74f3c046b03552cecada2b7cf746c1b |
|
BLAKE2b-256 | 95a91aa9ced4b6ab36ce56af692f61222924b8468a232107376d70a16495ffb4 |