YOGA - Yummy Optimizer for Gorgeous Assets

|Github| |Discord| |PYPI Version| |Build Status| |Black| |License|

.. figure:: https://github.com/wanadev/yoga/raw/master/logo.png :alt:

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_ and MozJPEG_ 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

.. _glTF and GLB: https://www.khronos.org/gltf/ .. _Pillow: https://github.com/python-pillow/Pillow .. _Guetzli: https://github.com/google/guetzli .. _MozJPEG: https://github.com/mozilla/mozjpeg .. _Zopflipng: https://github.com/google/zopfli .. _libwebp: https://chromium.googlesource.com/webm/libwebp/ .. _assimp: https://github.com/assimp/assimp

Install

• See the install section of the documentation <https://wanadev.github.io/yoga/install.html>_

Documentation

• Command Line Interface (CLI) <https://wanadev.github.io/yoga/cli/index.html>_
• Python API <https://wanadev.github.io/yoga/python/index.html>_
• Contributing <https://wanadev.github.io/yoga/contributing.html>_

Changelog

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

  • Nothing yet ;)

• v1.3.4:

  • misc:Added Python 3.14 support (@flozz)
  • misc!:Removed Python 3.9 support (@flozz)

• v1.3.3-1:

  • fix(standalone): Fixed standalone builds (missing _cffi_backend) (#72, @flozz)
  • misc(standalone): Removed an old hack from Windows standalone build script (@flozz)
  • misc(ci): Added test to ensure standalone builds are working before releasing them... (#72, @flozz)
  • misc(deps): Updated Nuitka to v3.5.9 (@flozz)
  • NOTE: This release only fixes standalone builds; the YOGA code did not change so there is no new version published on PyPI.

• v1.3.3:

  • fix(build): Added missing setuptools versions pinning that break the PyPy builds (@flozz)

• v1.3.2 / v1.3.2-1:

  • fix(build): Fixed Windows build with recent setuptools versions (@flozz)
  • fix(release): Updated, fixed and improved standalone build scripts and CI (@flozz)
  • misc: Added Python 3.13 support (@flozz)
  • misc!: Removed Python 3.8 support (@flozz)

• v1.3.1-1:

  • This version has no code change from the v1.3.1. It is only an update of the distribution :

    • A brand new standalone version was build for Linux
    • The Windows standalone distribution was updated (changes in documentation)

  • dist: Added scripts to build a standalone binary version of YOGA on Linux

• v1.3.1:

  • chore(sdist): Fixed included files in sdist package (@flozz)

• v1.3.0:

  • feat(assimp): Updated assimp to v5.3.1 (fixed build on GCC >= 13) (@flozz)
  • chore: Removed a script that is no more needed (@flozz)
  • docs: Updated contributing documentation (libraries, supported Python version, assimp update) (@flozz)

• v1.2.3:

  • Code quality: more robust type comparison (@flozz)
  • Code quality: cleanup some Python 2.7 specific code (@flozz)
  • Added Python 3.12 support (@flozz)
  • Removed Python 3.7 support (@flozz)

.. |Github| image:: https://img.shields.io/github/stars/wanadev/yoga?label=Github&logo=github :target: https://github.com/wanadev/yoga .. |Discord| image:: https://img.shields.io/badge/chat-Discord-8c9eff?logo=discord&logoColor=ffffff :target: https://discord.gg/BmUkEdMuFp .. |PYPI Version| image:: https://img.shields.io/pypi/v/yoga.svg :target: https://pypi.python.org/pypi/yoga .. |Build Status| image:: https://github.com/wanadev/yoga/actions/workflows/python-ci.yml/badge.svg :target: https://github.com/wanadev/yoga/actions .. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://black.readthedocs.io/en/stable/ .. |License| image:: https://img.shields.io/pypi/l/yoga.svg :target: https://github.com/wanadev/yoga/blob/master/LICENSE