KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #codex #claude-code #cli #react #mcp #open-source #deepseek-harness #dsh-plugin #ai

ZenCompress

★ 80 Open GitHub ↗

Fine-grain texture compression for glTF 3D assets

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ZenCompress
A fine-grain GUI texture compression tool for glTF created by Ethan Michalicek and [Paradowski Creative](https://paradowski.com). Read more about this tool and its benefits in [our introductory blog post](https://paradowski.com/stories/introducing-zencompress-for-gltf).

Alternatively, check out this video walkthrough by technical artist Colin Freeman:

[![A YouTube how-to video by Colin Freeman](https://img.youtube.com/vi/6cXMXlOFwf4/0.jpg)](https://www.youtube.com/watch?v=6cXMXlOFwf4)

![image](https://raw.githubusercontent.com/paradowskicreative/ZenCompress/master/docs/capy.png)

## How to use
ZenCompress operates on "glTF Separate" exports from Blender, where a geometry .bin, a human-readable .gltf meta file, and texture files are all exported separately. As an example asset, we'll open [this .blend file](./docs/Handle_Glove_v004.blend), which contains test geometry and .png textures for compression.

![image](https://raw.githubusercontent.com/paradowskicreative/ZenCompress/master/docs/image.png)

In most recent Blender versions, go to File > Export > glTF 2.0, and select "glTF Separate," optionally including a folder name to stash textures (otherwise textures are included in the same path as the exported .gltf file).

![image](https://raw.githubusercontent.com/paradowskicreative/ZenCompress/master/docs/export-settings.png)

Once exported, open either our Windows or Mac version of the release executable, and click the `...` elipses button next to "IMPORT" to select the .gltf file you've just exported

![image](https://raw.githubusercontent.com/paradowskicreative/ZenCompress/master/docs/gltf-open.png)

After selecting the file, click the "Import glTF" button to import it into the compression tool. Once it loads, feel free to select compression settings, and toggle compression per-texture (or use the texture type buttons to toggle compression for all Diffuse textures, or all Lightmaps, etc). Users can select between ETC1S which encodes faster and has a higher compression ratio, or UASTC, which can handle transparency and produces fewer artifaces on gradient-like images (learn more about these distrinctions in our introductory blog post).

![image](https://raw.githubusercontent.com/paradowskicreative/ZenCompress/master/docs/gltf-glove.png)

Once your desired settings are selected, click the `...` elipses button next to "EXPORT" to name your export .glb file. Once named, click "Export .glb" to begin the compression and conversion process. The "INFO" log will give you progress indicators - the larger the image, the longer encoding will take.

![image](https://raw.githubusercontent.com/paradowskicreative/ZenCompress/master/docs/gltf-export.png)

The output can then be loaded into, for example, A-Frame's KTX2 loader example, found in that repo at `./examples/test/model.html`, or any three.js or A-Frame project that uses the KTX2 loader script.

![image](https://raw.githubusercontent.com/paradowskicreative/ZenCompress/master/docs/running.png)
 
 ## Credits and Licensing
 ZenCompress was created by Ethan Michalicek and Paradowski Creative, and has been open sourced under the MIT license attached in this repo.

ZenCompress

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README