Metadata-Version: 2.1
Name: letterbomb
Version: 1.2
Summary: A fork of the classic Wii hacking tool from fail0verflow
Home-page: https://gitlab.com/whoatemybutter/letterbomb
Author: WhoAteMyButter
Author-email: 4616947-whoatemybutter@users.noreply.gitlab.com
Maintainer: WhoAteMyButter
Maintainer-email: 4616947-whoatemybutter@users.noreply.gitlab.com
License: GPLv3+
Download-URL: https://gitlab.com/whoatemybutter/letterbomb/-/archive/master/letterbomb-master.zip
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# Letterbomb

### A fork of the classic Wii hacking tool from [fail0verflow](https://github.com/fail0verflow)

<a href="https://gitlab.com/whoatemybutter/letterbomb"><img src="https://i.imgur.com/llzHJiw.png" width="250"/></a>

*([Letterbomb source](https://github.com/fail0verflow/letterbomb), [Webservice](https://please.hackmii.com), [WiiBrew Wiki](http://wiibrew.org/wiki/LetterBomb), [PyPi](https://pypi.org/project/letterbomb))*

## Installation
* [PyPi](https://pypi.org/project/letterbomb): **(recommended)**
```shell script
python3 -m pip install letterbomb
```

* Manual: **(development)**
```shell script
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          |
|-------------------|---------------------|-------------------------|
| Network required  | No                  | Yes                     |
| 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            | 9.45/10.00          | 4.65/10.00              |
| Python version    | 3.6+                | 2.7 only                |

## Images

<img src="https://i.imgur.com/EuBlJbF.png" width=300 />
<img src="https://i.imgur.com/B1Wb2uo.png" width=300 />
<img src="https://i.imgur.com/LjZh24c.png" width=300 />
<img src="https://i.imgur.com/YYG9XnU.png" width=300/>

## Usage
* Python:
```python
import letterbomb

# To include BootMii:
letterbomb.__main__(mac="mac address", region="region letter", pack_bundle=True, output_file="letterbomb.zip")
# To exclude BootMii
letterbomb.__main__(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:
```shell script
# 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
```

## License
Letterbomb is licensed under [GPLv3+](https://www.gnu.org/licenses/gpl-3.0.txt). ([included file](https://gitlab.com/whoatemybutter/letterbomb/-/raw/master/LICENSE.txt))

