Metadata-Version: 2.4
Name: panorama-tools
Version: 0.0.3
Summary: A viewer for file formats found in Nintendo games
Author-email: Yannik Marchand <ymarchand@me.com>
License-Expression: GPL-3.0-only
Project-URL: Repository, https://github.com/kinnay/Panorama.git
Project-URL: Issues, https://github.com/kinnay/Panorama/issues
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt6
Requires-Dist: QtAwesome
Requires-Dist: ninty
Requires-Dist: psutil
Requires-Dist: zstd
Requires-Dist: jungle-package==0.0.2
Dynamic: license-file

This project implements a viewer for various file formats that are seen in Nintendo games.

## Installation
This tool can be installed as follows: `pipx install panorama-tools`.

After installation, the tool can be started by executing `panorama`.

## Features
After launching the tool, you can import files or folder into the workspace. This allows you to browse through files in a tree, including files that are stored in archives. After selecting a file in the tree, the contents of the file are displayed on the screen. In addition to file-specific widgets, a hex viewer is shown that displays the raw contents of the file, even for files that would otherwise not be supported. In addition, all files can be extracted from archives.

The following file formats currently have a plugin implemented for them:

| Library | Format | Extensions | Description |
| --- | --- | --- | --- |
| Multiple | [BYAML](https://nintendo-formats.com/libs/common/byaml.html) | `.byml` / `.byaml` | Binary YAML |
| AAL | [BAMETA](https://nintendo-formats.com/libs/aal/bameta.html) | `.bameta` | Audio metadata |
| AAL | [BARS](https://nintendo-formats.com/libs/aal/bars.html) | `.bars` | Audio resources |
| AAL | [BARSLIST](https://nintendo-formats.com/libs/aal/barslist.html) | `.barslist` | Audio resource lists |
| AGL | [PMAA](https://nintendo-formats.com/libs/agl/pmaa.html) | `.bagl*` | Graphics parameters |
| LMS | [MSBP](https://nintendo-formats.com/libs/lms/msbp.html) | `.msbp` | Message project files |
| LMS | [MSBT](https://nintendo-formats.com/libs/lms/msbt.html) | `.msbt` | Message files |
| NW4F | [BFWAV](https://nintendo-formats.com/libs/nw/bfwav.html) | `.bfwav` | Wave files |
| SEAD | [SARC](https://nintendo-formats.com/libs/sead/sarc.html) | `.sarc` | Archives |
| SEAD | [SZS](https://nintendo-formats.com/libs/sead/yaz0.html) | `.szs` | Yaz0 compression |
| Other | [ZSTD](https://facebook.github.io/zstd) | `.zs` | Zstd compression |

## Screenshots
<div style="float: left">
  <img src="https://github.com/user-attachments/assets/ed5ef941-2e95-4a62-b0d4-1924d8d36dc7" width="750" />
  <img src="https://github.com/user-attachments/assets/ed895f53-a9f7-4c21-8151-0f720d63a337" width="750" />
</div>
