Metadata-Version: 2.4
Name: tiptoi-tools
Version: 0.1.0
Summary: Tiptoi GME inspection and extraction tools.
Author-email: Jeremy Retailleau <jeremy.retailleau@gmail.com>
License-Expression: MIT
Project-URL: Repository, https://github.com/buddly27/tiptoi-tools
Project-URL: Changelog, https://github.com/buddly27/tiptoi-tools/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/buddly27/tiptoi-tools/issues
Keywords: tiptoi,gme,cli
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click<9,>=8.3.1
Requires-Dist: PyYAML<7,>=6.0.3
Requires-Dist: miniaudio<2,>=1.60
Provides-Extra: dev
Requires-Dist: ruff>=0.14.0; extra == "dev"
Dynamic: license-file

# tiptoi-tools

Python CLI for inspecting, extracting, and building Ravensburger Tiptoi GME files.

## Installation

```bash
pip install tiptoi-tools
```

## Usage

```bash
# Show file information
tiptoi-tools file.gme info

# Export to YAML and media files
tiptoi-tools file.gme export

# Build GME from YAML
tiptoi-tools file.yaml build

# Play audio by OID or media index
tiptoi-tools file.gme play 123
tiptoi-tools file.gme play @456
```

## Commands

| Command | Description |
|---------|-------------|
| `info` | Show GME file metadata and structure |
| `export` | Export to YAML with media files |
| `build` | Build GME from tttool-compatible YAML |
| `play` | Play audio by OID or media index |
| `scripts` | Browse and search scripts |
| `games` | List games and their structure |
| `oids` | Explore OID relationships |

## Acknowledgments

This project is inspired by and compatible with [tttool](https://github.com/entropia/tip-toi-reveng), the original Tiptoi reverse-engineering toolkit created by Joachim Breitner ([@nomeata](https://github.com/nomeata)). The GME file format documentation and YAML schema originate from the tttool project.

## License

MIT
