Skip to main content

Yummy Optimizer for Gorgeous Assets

Project description

Github Discord PYPI Version Build Status Black License

YOGA is a command-line tool and a library that can:

  • convert and optimize images from various format to JPEG, PNG and WEBP,

  • convert and optimize 3D models from various formats to glTF and GLB.

Images are opened using Pillow and optimized using Guetzli (for JPEGs), Zopflipng (for PNGs) and libwebp (for WEBPs).

3D Models are converted and optimized using assimp. If models contain or reference images, they are processed by YOGA’s image optimizer.

EXAMPLE: Converting and optimizing an image from CLI:

yoga  image  input.png  output.png
yoga  image  --output-format=jpeg  --jpeg-quality=84  input.png  output.jpg
yoga  image  --help

EXAMPLE: Converting and optimizing a 3D model from CLI:

yoga  model  input.fbx  output.glb
yoga  model  --no-graph-optimization  --no-meshes-optimization  --image-output-format=jpeg  --image-jpeg-quality=84  input.fbx  output.glb
yoga  model  --help




  • [NEXT] (changes on master that have not been released yet):

    • Nothing yet :)

  • v1.2.2:

    • Updated the code to not use deprecated constants on newer Pillow versions

    • Various typo fixed (@kianmeng, #45)

    • Added Python 3.11 support

  • v1.2.1:

    • No change: fix an upload error on PYPI

  • v1.2.0:

    • Add color quantization options (based on libimagequant)

    • arm64 and universal2 wheels for macOS

    • x86 and x68_64 wheels for musl-based Linux distro (Alpine,…)

    • MAINTAINERS: New dependency: imagequant

  • v1.1.2:

    • Add flag to CFFI builder to fix MacOS build

  • v1.1.1 (not published):

    • JPEG: ignore invalid values for the orientation tag (#38)

    • Python 3.10 support and wheels

  • v1.1.0:

    • JPEG Optimization:

      • Honor the JPEG orientation EXIF tag

      • JPEG optimization has been improved by using some optimizations from MozJPEG after the Guetzli encoding (from 2.4 % to 7.3 % of additional size reduction)

    • PNG Optimization:

      • YOGA can no more output a PNG larger than the input one when performing a PNG to PNG optimization

    • CLI:

      • Allow to cancel an optimization using Ctrl+C (NOTE: may not work on Windows)

      • Add a --version option to get YOGA’s version

      • Improve yoga --help usage

    • Python versions:

      • Python 2.7 support dropped

    • NOTE for packagers:

  • v1.0.0:

    • WEBP (lossy and lossless) images supported as output format

    • PNG default optimization preset changed to a 10× faster preset (old preset still available with --png-slow-optimization flag)

    • New model flag --no-fix-infacing-normals to disable Assimp’s “fix infacing normals” postprocess (#32, #33)

    • Show CLI usage when no parameter given

    • Developer documentation improved (#31)

    • ASSIMP library updated

    • WARNING: This is the last version to actively support Python 2.7!

  • v0.11.1:

    • Automated workflow for deploying the PyPI packages

    • Wheel are now distributed on PyPI

  • v0.11.0:

    • Allows to build YOGA on Windows

    • Scripts and workflow to build Windows standalone versions

  • v0.10.2:

    • Updates assimp and python libraries

  • v0.10.1:

    • Fixes an issue that occurs when output file does not already exist

  • v0.10.0:

    • Prevent overwriting of the output file when an error occurs (#17)

    • Unicode path support (#16)

  • v0.10.0b1:

    • Verbose and quiet modes,

    • Allows to pass textures from memory instead of looking on the filesystem,

    • Allows to pass a fallback texture instead of raising an error.

  • v0.9.1b1:

    • Automatic selection of the output format (png or jpeg),

    • Prevent duplication of textures that are shared between materials,

    • Fixes Windows paths of textures.

  • v0.9.0b1: First release (only GLB output for models, no image auto output format)

Project details

Download files

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

Source Distribution

yoga-1.2.2.tar.gz (2.9 MB view hashes)

Uploaded source

Built Distributions

yoga-1.2.2-pp39-pypy39_pp73-win_amd64.whl (2.2 MB view hashes)

Uploaded pp39

yoga-1.2.2-pp38-pypy38_pp73-win_amd64.whl (2.2 MB view hashes)

Uploaded pp38

yoga-1.2.2-pp37-pypy37_pp73-win_amd64.whl (2.2 MB view hashes)

Uploaded pp37

yoga-1.2.2-cp311-cp311-win_amd64.whl (2.2 MB view hashes)

Uploaded cp311

yoga-1.2.2-cp311-cp311-macosx_11_0_arm64.whl (43.2 kB view hashes)

Uploaded cp311

yoga-1.2.2-cp310-cp310-win_amd64.whl (2.2 MB view hashes)

Uploaded cp310

yoga-1.2.2-cp310-cp310-macosx_11_0_arm64.whl (43.2 kB view hashes)

Uploaded cp310

yoga-1.2.2-cp39-cp39-win_amd64.whl (2.2 MB view hashes)

Uploaded cp39

yoga-1.2.2-cp39-cp39-macosx_11_0_arm64.whl (43.2 kB view hashes)

Uploaded cp39

yoga-1.2.2-cp38-cp38-win_amd64.whl (2.2 MB view hashes)

Uploaded cp38

yoga-1.2.2-cp38-cp38-macosx_11_0_arm64.whl (43.2 kB view hashes)

Uploaded cp38

yoga-1.2.2-cp37-cp37m-win_amd64.whl (2.2 MB view hashes)

Uploaded cp37

yoga-1.2.2-cp36-cp36m-win_amd64.whl (2.2 MB view hashes)

Uploaded cp36

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page