A fork of the classic Wii hacking tool from fail0verflow
Project description
✉💣 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)
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-2.0.1.tar.gz
(4.8 MB
view hashes)
Built Distribution
Close
Hashes for letterbomb-2.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e9ab8fccf19d1a6b30b3483630d14f8d1bcaeb674ab1920aa8212a1dda6d851f |
|
MD5 | 10f701ee1b44360dbb26e4d492761ffd |
|
BLAKE2b-256 | 2be17774a83546aa5fffb89f35c135afb2e34f28c59881b41eb02edfb4016238 |