letterbomb


Nameletterbomb JSON
Version 4.0 PyPI version JSON
download
home_page
SummaryA fork of the classic Wii hacking tool from fail0verflow
upload_time2023-10-21 21:50:08
maintainer
docs_urlNone
authorWhoAteMyButter
requires_python>=3.10
licenseMIT
keywords letterbomb letter bomb wii failoverflow fail0verflow fail overflow fail 0verflow exploit wii hack hacking jailbreak jailbreaking
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ✉️💣 LetterBomb

<div align="center">

<h3>A fork of the classic Wii hacking tool from <a href="https://github.com/fail0verflow">fail0verflow</a>.</h3>

[![CI/CD](https://img.shields.io/gitlab/pipeline/whoatemybutter/letterbomb/master?label=ci%2Fcd)](https://gitlab.com/whoatemybutter/letterbomb/-/pipelines)
[![PyPI downloads](https://img.shields.io/pypi/dd/letterbomb)](https://pypi.org/project/letterbomb)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Pylint](https://img.shields.io/badge/pylint-10.00/10-ffbf48)](https://pylint.pycqa.org/en/latest/)
[![License](https://img.shields.io/badge/license-MIT-a51931)](https://spdx.org/licenses/MIT.html)
[![PyPI version](https://img.shields.io/pypi/v/letterbomb)](https://pypi.org/project/letterbomb/)
[![GitLab version](https://img.shields.io/gitlab/v/release/22300251?sort=semver)](https://gitlab.com/whoatemybutter/mcfonts/-/releases)

<a href="https://gitlab.com/whoatemybutter/letterbomb"><img src="assets/upscaled.png" width="250" align="center"/></a>

</div>

---

## Table of Contents

- [Installation](#installation)
    - [PyPi](#pypi-recommended)
    - [Manual](#manual-web-server-development)
- [Improvements](#improvements-over-original)
- [Usage](#usage)
    - [Python](#python)
    - [CLI](#cli)
- [Documentation](#documentation)
- [Original source code](#original-source-code)
- [License](#license)

## Installation

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

#### Manual: **(web server, development)**
```shell script
git clone https://gitlab.com/whoatemybutter/letterbomb.git
cd letterbomb
python -m build
```

## Improvements over original

|                | *WhoAteMyButter's*   | fail0verflow's          |
|----------------|----------------------|-------------------------|
| Networking     | Optional             | Required                |
| CLI            | Yes                  | No                      |
| OS support     | Linux, Windows, Mac  | Linux                   |
| Logging        | Yes                  | Yes, dependent on Flask |
| API            | Yes                  | No                      |
| 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.10+                | 2.7 only                |
| License        | MIT                  | MIT                     |
| Documentation  | Yes                  | No                      |

## Usage

#### Python

```python
import letterbomb

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

# Write to stream, include HackMii:
letterbomb.write(mac="mac address", region="region letter")
# Write to stream, exclude HackMii:
letterbomb.write(mac="mac address", region="region letter", pack_bundle=False)

# To log debug messages
letterbomb.LOGGING_LEVEL = letterbomb.logging.DEBUG
# To log output to a file
letterbomb.LOGGING_FILE = "log.txt"
```

#### CLI

```shell
# Help
python3 -m letterbomb -h

# To include HackMii, output and create a ZIP
python3 -m letterbomb MAC REGION -b -o output.zip

# To enable debug logging
python3 -m letterbomb MAC REGION -g debug -o output.zip

# To use a file for logging output instead
python3 -m letterbomb MAC REGION -l logfile.txt -o output.zip

# To stream bytes instead, and include HackMii (-b)
python3 -m letterbomb MAC REGION -b

# To stream bytes instead, and exclude HackMii
python3 -m letterbomb MAC REGION
```

#### Web service

```shell script
git clone https://gitlab.com/whoatemybutter/letterbomb.git
cd letterbomb/web
python -m flask run
```

Obtaining a copy of `letterbomb` through PyPI will not have the web service included.

## Documentation

**Most casual users should refer to the [ReadTheDocs page](https://letterbomb.rtfd.io).**

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

```shell script
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:

```shell script
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](https://wiibrew.org/wiki/LetterBomb).

## 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 the [MIT liense](https://mit-license.org/). ([included file](https://gitlab.com/whoatemybutter/letterbomb/-/raw/master/LICENSE.txt))

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "letterbomb",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "",
    "keywords": "letterbomb,letter bomb,wii,failoverflow,fail0verflow,fail overflow,fail 0verflow,exploit,wii hack,hacking,jailbreak,jailbreaking",
    "author": "WhoAteMyButter",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/76/c3/7d6df2728a6950b7061b908baaad3f8afc17eec3939fde60fb7a616694a3/letterbomb-4.0.tar.gz",
    "platform": null,
    "description": "# \u2709\ufe0f\ud83d\udca3 LetterBomb\n\n<div align=\"center\">\n\n<h3>A fork of the classic Wii hacking tool from <a href=\"https://github.com/fail0verflow\">fail0verflow</a>.</h3>\n\n[![CI/CD](https://img.shields.io/gitlab/pipeline/whoatemybutter/letterbomb/master?label=ci%2Fcd)](https://gitlab.com/whoatemybutter/letterbomb/-/pipelines)\n[![PyPI downloads](https://img.shields.io/pypi/dd/letterbomb)](https://pypi.org/project/letterbomb)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Pylint](https://img.shields.io/badge/pylint-10.00/10-ffbf48)](https://pylint.pycqa.org/en/latest/)\n[![License](https://img.shields.io/badge/license-MIT-a51931)](https://spdx.org/licenses/MIT.html)\n[![PyPI version](https://img.shields.io/pypi/v/letterbomb)](https://pypi.org/project/letterbomb/)\n[![GitLab version](https://img.shields.io/gitlab/v/release/22300251?sort=semver)](https://gitlab.com/whoatemybutter/mcfonts/-/releases)\n\n<a href=\"https://gitlab.com/whoatemybutter/letterbomb\"><img src=\"assets/upscaled.png\" width=\"250\" align=\"center\"/></a>\n\n</div>\n\n---\n\n## Table of Contents\n\n- [Installation](#installation)\n    - [PyPi](#pypi-recommended)\n    - [Manual](#manual-web-server-development)\n- [Improvements](#improvements-over-original)\n- [Usage](#usage)\n    - [Python](#python)\n    - [CLI](#cli)\n- [Documentation](#documentation)\n- [Original source code](#original-source-code)\n- [License](#license)\n\n## Installation\n\n#### [PyPi](https://pypi.org/project/letterbomb): **(recommended)**\n```shell script\npython3 -m pip install -U letterbomb\n```\n\n#### Manual: **(web server, development)**\n```shell script\ngit clone https://gitlab.com/whoatemybutter/letterbomb.git\ncd letterbomb\npython -m build\n```\n\n## Improvements over original\n\n|                | *WhoAteMyButter's*   | fail0verflow's          |\n|----------------|----------------------|-------------------------|\n| Networking     | Optional             | Required                |\n| CLI            | Yes                  | No                      |\n| OS support     | Linux, Windows, Mac  | Linux                   |\n| Logging        | Yes                  | Yes, dependent on Flask |\n| API            | Yes                  | No                      |\n| Exceptions     | Yes                  | No                      |\n| Packaging      | GitLab, PyPI         | Git                     |\n| Dependencies   | None (Flask for web) | Flask, geoip2           |\n| Pylint         | 10.00/10.00          | 4.65/10.00              |\n| Python version | 3.10+                | 2.7 only                |\n| License        | MIT                  | MIT                     |\n| Documentation  | Yes                  | No                      |\n\n## Usage\n\n#### Python\n\n```python\nimport letterbomb\n\n# Write to file, include HackMii:\nletterbomb.write(mac=\"mac address\", region=\"region letter\", output_file=\"letterbomb.zip\")\n# Write to file, exclude HackMii:\nletterbomb.write(mac=\"mac address\", region=\"region letter\", pack_bundle=False, output_file=\"letterbomb.zip\")\n\n# Write to stream, include HackMii:\nletterbomb.write(mac=\"mac address\", region=\"region letter\")\n# Write to stream, exclude HackMii:\nletterbomb.write(mac=\"mac address\", region=\"region letter\", pack_bundle=False)\n\n# To log debug messages\nletterbomb.LOGGING_LEVEL = letterbomb.logging.DEBUG\n# To log output to a file\nletterbomb.LOGGING_FILE = \"log.txt\"\n```\n\n#### CLI\n\n```shell\n# Help\npython3 -m letterbomb -h\n\n# To include HackMii, output and create a ZIP\npython3 -m letterbomb MAC REGION -b -o output.zip\n\n# To enable debug logging\npython3 -m letterbomb MAC REGION -g debug -o output.zip\n\n# To use a file for logging output instead\npython3 -m letterbomb MAC REGION -l logfile.txt -o output.zip\n\n# To stream bytes instead, and include HackMii (-b)\npython3 -m letterbomb MAC REGION -b\n\n# To stream bytes instead, and exclude HackMii\npython3 -m letterbomb MAC REGION\n```\n\n#### Web service\n\n```shell script\ngit clone https://gitlab.com/whoatemybutter/letterbomb.git\ncd letterbomb/web\npython -m flask run\n```\n\nObtaining a copy of `letterbomb` through PyPI will not have the web service included.\n\n## Documentation\n\n**Most casual users should refer to the [ReadTheDocs page](https://letterbomb.rtfd.io).**\n\nSome may want to build the documentation manually. To do this:\n\n```shell script\ngit clone https://gitlab.com/whoatemybutter/letterbomb.git\ncd letterbomb/docs\nmake html\nxdg-open _build/html/index.html\n```\n\nIf you prefer one-liners, there is one below:\n\n```shell script\ngit clone https://gitlab.com/whoatemybutter/letterbomb.git && cd letterbomb/docs && make html && xdg-open _build/html/index.html\n```\n\nBefore re-building the documentation, you should also run `make clean` to prevent stale files from remaining in newer builds.\n\nTo read about the exploit itself in more detail, please [read this article](https://wiibrew.org/wiki/LetterBomb).\n\n## Original source code\n\n* The *original* source code can be found at https://github.com/fail0verflow/letterbomb.\n* The *original* website can be found at https://please.hackmii.com.\n\n**Note:** *Original code likely will not work out-of-the-box.*\n\n## License\n\nLetterBomb is licensed under the [MIT liense](https://mit-license.org/). ([included file](https://gitlab.com/whoatemybutter/letterbomb/-/raw/master/LICENSE.txt))\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A fork of the classic Wii hacking tool from fail0verflow",
    "version": "4.0",
    "project_urls": {
        "Changelog": "https://gitlab.com/whoatemybutter/letterbomb/-/blob/master/CHANGELOG.md",
        "Documentation": "https://letterbomb.readthedocs.io",
        "Source": "https://gitlab.com/whoatemybutter/letterbomb"
    },
    "split_keywords": [
        "letterbomb",
        "letter bomb",
        "wii",
        "failoverflow",
        "fail0verflow",
        "fail overflow",
        "fail 0verflow",
        "exploit",
        "wii hack",
        "hacking",
        "jailbreak",
        "jailbreaking"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9dabeda74b5184ef7976e8c80dd01fd69c2aabede3279fb3eed982d363ec3f80",
                "md5": "29af2478ba5330f250183fcaed79c31d",
                "sha256": "6465341b4d4e253ed065568f0b861a45e04ee985789058a3d08b952e9af57afe"
            },
            "downloads": -1,
            "filename": "letterbomb-4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "29af2478ba5330f250183fcaed79c31d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 4663256,
            "upload_time": "2023-10-21T21:50:06",
            "upload_time_iso_8601": "2023-10-21T21:50:06.697238Z",
            "url": "https://files.pythonhosted.org/packages/9d/ab/eda74b5184ef7976e8c80dd01fd69c2aabede3279fb3eed982d363ec3f80/letterbomb-4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "76c37d6df2728a6950b7061b908baaad3f8afc17eec3939fde60fb7a616694a3",
                "md5": "16bce4c53c1f2c4126dafccf5f6ca37d",
                "sha256": "cdefcae6ee2112ba38176ed3ae38a998c06f2bfa196767deb45d3a8620f6e525"
            },
            "downloads": -1,
            "filename": "letterbomb-4.0.tar.gz",
            "has_sig": false,
            "md5_digest": "16bce4c53c1f2c4126dafccf5f6ca37d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 4664128,
            "upload_time": "2023-10-21T21:50:08",
            "upload_time_iso_8601": "2023-10-21T21:50:08.947768Z",
            "url": "https://files.pythonhosted.org/packages/76/c3/7d6df2728a6950b7061b908baaad3f8afc17eec3939fde60fb7a616694a3/letterbomb-4.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-21 21:50:08",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "codeberg": false,
    "gitlab_user": "whoatemybutter",
    "gitlab_project": "letterbomb",
    "lcname": "letterbomb"
}
        
Elapsed time: 0.73938s