---
id: etcpak
version: "0.9.15"
license: MIT License Copyright (c) 2021 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
---

# etcpak — python wrapper for etcpak

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

## What it is and what it does

etcpak is a Python wrapper around the wolfpld/etcpak C++ texture compression library. It provides functions to compress raw image data (in RGBA or BGRA format) into GPU-friendly texture compression formats: BC1 and BC3 (DXT variants), ETC1 and ETC2 (Ericsson Texture Compression), and ASTC. The library is designed for real-time or batch texture encoding in graphics pipelines, game engines, and image processing workflows.

The package requires image data as raw bytes in a specific channel order (RGBA for DXT, BGRA for ETC), along with width and height dimensions. It exposes compression functions with optional dithering variants. The wrapper is thin and direct—it maps closely to the underlying C++ API with minimal abstraction. Installation requires Python 3.7 or later and depends on archspec; pre-built wheels are available for most platforms.

Use it for:

- Batch-compress game textures to BC3/DXT5 format for real-time rendering on desktop platforms.
- Convert images to ETC2 format for mobile game assets before deployment.
- Generate multiple compressed texture variants from a single source image for format comparison.
- Integrate texture encoding into asset pipelines that require GPU-compatible formats.
- Compress RGBA image data to BC1 with optional dithering for memory-constrained environments.

## Worth the install?

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

Compresses image data into GPU-friendly texture formats (BC1, BC3, ETC1, ETC2) via Python bindings to the etcpak C++ library.

Yes, if you need to compress image data into GPU texture formats (BC, ETC, ASTC) and are comfortable with the thin wrapper's direct API and byte-order requirements. The library is stable, permissively licensed, and has broad platform coverage. Install friction is moderate due to compiled wheels, but pre-built binaries are available. Maintenance is aging—no active development beyond the latest release—so expect no new features or rapid bug fixes, but the core functionality is mature and unlikely to break.

## Install

pip install etcpak
uv add etcpak
poetry add etcpak

## Installing etcpak

Before you install: Medium install friction due to compiled binary wheels; however, pre-built wheels cover most common platforms (x86_64, ARM, PyPy). Last release was 2025-08-11, but the project shows aging maintenance signals with no activity beyond that release.

License in practice: MIT License permits unrestricted use, modification, and distribution with minimal obligations—suitable for both open-source and commercial projects.

Quickstart:

pip install etcpak

import etcpak

# compress raw RGBA bytes to BC3
compressed = etcpak.compress_bc3(img_data, width, height)

Image data must be in the exact channel order required by each format (RGBA for DXT functions, BGRA for ETC functions); image dimensions must be multiples of 4 for most formats.

Verify before relying:

- Whether archspec is actually used at runtime or is a build-time-only dependency
- Performance characteristics compared to other texture compression libraries
- Whether ASTC compression is fully implemented despite being listed in keywords

## Package facts

- License: MIT License Copyright (c) 2021 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: 149.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

texture compression, image format conversion, BC1 BC3 DXT compression, ETC1 ETC2 compression, GPU texture encoding, RGBA to compressed format, real-time texture compression, texture-compression, gpu-formats, image-encoding

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