---
id: texture2ddecoder
version: "1.0.6"
license: MIT License Copyright (c) 2020 K0lb3 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# texture2ddecoder — a python wrapper for Perfare's Texture2DDecoder

License: permissive · Maintenance: aging · Downloads: 154.2K/mo

## What it is and what it does

texture2ddecoder is a Python wrapper around native texture decompression routines for formats commonly found in game assets and 3D applications. It takes compressed binary texture data (in formats like BC1, BC3, ETC1, ETC2, PVRTC, ASTC, ATC, and Crunch variants) along with dimensions and block parameters, and returns raw BGRA pixel bytes suitable for image reconstruction or further processing.

The package is a thin binding to cross-platform C implementations of these codecs, with no Python runtime dependencies. It's designed for developers who need to extract or convert game textures, analyze asset pipelines, or integrate texture decompression into asset processing workflows. The main gotcha is that decode_pvrtc can segfault on macOS, and the package requires a pre-built wheel for your specific platform and Python version.

Use it for:

- Extract and convert game textures from asset bundles or game files for analysis or modding
- Batch decompress ASTC textures from mobile game assets into standard image formats
- Build asset pipeline tools that need to read compressed textures from game engines
- Integrate texture decompression into game modding or reverse-engineering workflows
- Convert ETC or PVRTC textures from mobile platforms to desktop-compatible formats

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Decodes compressed texture formats (BC, PVRTC, ETC, ASTC, ATC, Crunch) used in game assets and 3D applications, converting them to raw BGRA pixel data.

Yes, if you need to decompress game textures. The package is stable, permissively licensed, has no runtime dependencies, and covers a wide range of compression formats. Install friction is moderate due to platform-specific wheels, but pre-built binaries exist for common platforms. Avoid decode_pvrtc on macOS due to known segfault risk.

## Install

pip install texture2ddecoder
uv add texture2ddecoder
poetry add texture2ddecoder

## Installing texture2ddecoder

Before you install: Medium install friction due to compiled wheels across many platforms. Package is aging (210 days since last release) but repo remains active with recent commits. No runtime dependencies simplifies deployment.

License in practice: MIT-licensed with permissive terms. Underlying codec implementations carry mixed licenses (MIT, public domain, zlib) but all are permissive, so commercial and proprietary use is allowed.

Quickstart:

import texture2ddecoder

data = open("texture_file", "rb").read()
decoded = texture2ddecoder.decode_astc(data, width=512, height=512, block_width=4, block_height=4)

decode_pvrtc can cause segfaults on macOS; compiled wheels required for your platform.

Verify before relying:

- Whether the package handles all modern game engine texture formats or only a subset of the listed codecs
- Performance characteristics when decoding large or many textures in sequence
- Compatibility with texture formats beyond those explicitly documented

## Package facts

- License: MIT License Copyright (c) 2020 K0lb3 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: aging
- Downloads: 154.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

texture decompression, game asset decoder, compressed texture formats, astc decoder, bc texture decompression, etc1 etc2 decoder, crunch texture unpacker, game-assets, texture-compression, binary-codec

[View on SkillFed](https://skillfed.io/packages/texture2ddecoder) · [View on PyPI](https://pypi.org/project/texture2ddecoder/)