Skip to main content

tpk_ar

A Python port of AssetRipper/Tpk, primarily for use in UnityPy.

This is maintained as a separate project to ensure forward compatibility for older UnityPy versions against potential breaking changes in the original code.

Rather than acting as an exact mirror of the upstream project, this port focuses solely on providing a Tpk format parser with a stable, backward-compatible API.

Options

The brotli and lz4 dependencies are optional. To handle compressed Tpk files, install the package with the required extras:

pip install "tpk_ar[brotli]"
pip install "tpk_ar[lz4]"
pip install "tpk_ar[full]"  # Installs both

Development

TODO

  • Parser
  • Dumper (for saving extracted type tree information of games)
  • Native Extension (C++, for performance)

Benchmarking

To measure the cost of loading a TPK file and inspect the same code path in snakeviz, install the dev extras:

uv sync --extra dev

Run the timing benchmark against the bundled uncompressed sample:

uv run python benchmarks/bench_load.py

Generate a profile for the same load path, then open it in snakeviz:

uv run python benchmarks/profile_load.py
uv run snakeviz profiles/uncompressed.prof

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tpk_ar-0.2.4.tar.gz (10.8 kB view details)

Uploaded Source

File details

Details for the file tpk_ar-0.2.4.tar.gz.

File metadata

  • Download URL: tpk_ar-0.2.4.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tpk_ar-0.2.4.tar.gz
Algorithm Hash digest
SHA256 d64897e5a0bcddd58e8a7d4dd922f372da984a0f98bc3b460ec869aab906ee78
MD5 01a1372b55d8c6e04fb127561860a787
BLAKE2b-256 fa02654a73cbd323970b5c1551881968dbadec1d697984fff5fdd33b66764dfc

See more details on using hashes here.

Provenance

The following attestation bundles were made for tpk_ar-0.2.4.tar.gz:

Publisher: release.yml on K0lb3/tpk_ar

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.4 This release

1 file

0.2.3

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page