This projects implements parsers for various file formats can be found in Nintendo games. It has been written to support research, and it is also used in a viewer tool.
Installation
This package can be installed with pip3 install jungle-package.
Python 3.13 or later is required.
Testing
Every parser that is implemented in this package must be sound and complete. This means that, given an arbitrary file from a Nintendo game, decoding and reencoding that file must always produce the original file again.
This can be tricky to implement for some file formats (especially if Nintendo's tooling is inconsistent or has quirks), but it is a hard requirement for this repository. A test.py script has been written to verify this. If you come across a file in a game that should be supported by this repository, but fails the test, feel free to reach out on discord or contribute research.
Supported Formats
The following file formats are currently supported by this library:
| Library | Format | Extensions | Description |
|---|---|---|---|
| Multiple | BYAML | .byml / .byaml / .bgyml |
Binary YAML |
| AAL | BAATN | .baatn |
Audio attenuators |
| AAL | BAMETA | .bameta |
Audio metadata |
| AAL | BARS | .bars |
Audio resources |
| AAL | BARSLIST | .barslist |
Audio resource lists |
| AGL | PMAA | .bagl* |
Graphics parameters |
| CAS | BAEV | .baev |
Animation event archive |
| GFD | Gfx2 | .gtx / .gsh |
Textures and shaders |
| LMS | MSBP | .msbp |
Message projects |
| LMS | MSBT | .msbt |
Messages |
| NW4F | BFWAV | .bfwav |
Wave files |
| SEAD | SARC | .sarc |
Archives |
| SEAD | SZS | .szs |
Yaz0 compression |
| XLINK | SLINK | .slink |
Sound links |
| Switch | BDF | .bdf |
Certificate list |
For some file formats, only specific versions are currently supported.
Contributing
The best way to contribute is to reverse engineer file formats and provide documentation for them. New documentation can be submitted as a pull request to the Nintendo file formats wiki. Bug fixes and corrections to existing documentation are also more than welcome.
If you would like to chat about Nintendo's file formats in general, feel free to join the Discord server.
1 maintainer
Metadata
1 maintainer
Release files for jungle-package 0.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| jungle_package-0.0.4.tar.gz | 52.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jungle_package-0.0.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 111.4 kB
Release files / jungle_package-0.0.4.tar.gz
| Download URL | jungle_package-0.0.4.tar.gz |
|---|---|
| Size | 52.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ad1732d04ee0feae1a13407b54e9e4a3f7ae68fbe52383be754c96bde2a3a5f3
|
|
BLAKE2b-256 checksum How to use checksums |
5c4910f1010b849dbf4e8ba4c96e4f1453d727b46cca3087dbcad1eb2c6cb88f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Release files / jungle_package-0.0.4-py3-none-any.whl
| Download URL | jungle_package-0.0.4-py3-none-any.whl |
|---|---|
| Size | 59.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
91ee462271c825a356034fd7c024db7b1d7cd6b24843b991c57593fc8e179277
|
|
BLAKE2b-256 checksum How to use checksums |
d0bb08764a6957c49ee74dde28af2341d8583e2892f0c83bbc878aa882d99d97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Security for jungle-package 0.0.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
