YOGA Image Optimizer is a graphical user interface for YOGA Image that converts and optimizes the size of JPEGs, PNGs and WebP image files.

• Python >= 3.7,
• YOGA >= 1.1.0,
• PyCairo,
• PyGObject >= 3.36,

The package is available on AUR (yoga-image-optimizer):

• https://aur.archlinux.org/packages/yoga-image-optimizer/

A Flatpak package is available on Flathub. This is currently the simplest way to install YOGA Image Optimizer on all major Linux distributions:

• https://flathub.org/apps/details/org.flozz.yoga-image-optimizer

First, you will need to install some dependencies on your system. On Debian and Ubuntu this can be achieved with the following command:

sudo apt install git build-essential python3 python3-dev python3-pip libgirepository1.0-dev libcairo2-dev pkg-config gir1.2-gtk-3.0

Then clone this repository and navigate to it:

git clone https://github.com/flozz/yoga-image-optimizer.git
cd yoga-image-optimizer

Then install YOGA Image Optimizer using pip:

sudo pip3 install .

Finally, you can install desktop file, icons and manual using the following command:

sudo ./linuxpkg/copy-data.sh /usr

First, you will need to install some dependencies on your system. On Debian and Ubuntu this can be achieved with the following command:

sudo apt install git build-essential python3 python3-dev python3-pip libgirepository1.0-dev libcairo2-dev pkg-config gir1.2-gtk-3.0

Then install YOGA Image Optimizer using pip:

sudo pip3 install yoga-image-optimizer

NOTE: Installing from PyPI will not install .desktop file and man page. You will not be able to run the software from your graphical app menu (GNOME Shell,...).

Download either the portable .zip version or the Windows installer from the release page:

• https://github.com/flozz/yoga-image-optimizer/releases

To run YOGA Image Optimizer, just type the following command:

yoga-image-optimizer

You can also pass some image files to open:

yoga-image-optimizer  image1.png  image2.jpeg

If you have any question, you can:

• open an issue on Github,
• or ask on Discord (I am not always available for chatting but I try to answer to everyone).

If you found a bug, please open an issue on Github with as much information as possible:

• What is your operating system / Linux distribution (and its version),
• How you installed the software,
• All the logs and message outputted by the software,
• ...

Please consider filing a bug before starting to work on a new feature. This will allow us to discuss the best way to do it. This is of course not necessary if you just want to fix some typo or small errors in the code.

Please note that your code must pass tests and follow the coding style defined by the pep8. Flake8 and Black are used on this project to enforce coding style.

If the software is not available in your language, you can help translate it.

To translate YOGA Image Optimizer, you can:

• submit your translations using a Pull Request on Github,
• or translate online using POEditor:
  • → https://poeditor.com/join/project/RoQ2r9rv89

submit your translations using a Pull Request on Github. Do not forget to add your name as the translation of the translator-credits key (one name per line, e-mail is optional):

#: yoga_image_optimizer/about_dialog.py:38
msgid "translator-credits"
msgstr ""
"John DOE\n"
"Other TRANSLATOR <[email protected]>\n"

You will first have to install nox:

pip3 install nox

Then you can check for lint error:

nox --session lint

or run the tests:

nox --session test

To run the tests only for a specific Python version, you can use following commands (the corresponding Python interpreter must be installed on your machine):

nox --session test-3.7
nox --session test-3.8
nox --session test-3.9

You can also fix automatically coding style errors with:

nox -s black_fix

You will first have to install nox:

pip3 install nox

To extract messages and update locales run:

nox --session locales_update

To compile locales, run:

nox --session locales_compile

NOTE: you will need to have xgettext, msgmerge and msgfmt executable installed on your system to run the above commands. On Debian / Ubuntu, they can be installed with the following command:

sudo apt install gettext

Wanna support this project?

• ☕️ Buy me a coffee,
• ❤️ sponsor me on Github,
• 💵️ or give me a tip on PayPal.

• [NEXT] (changes on master but not released yet):
  • Fix a crash when generating thumbnails for JPEGs with an invalid orientation EXIF tag (#29)
  • Generate thumbnails asynchronously to not freeze the interface when importing a lot of image (#26)
  • Do not crash the import / optimization process when encountering broken images (#27)
  • More compact interface (#17)
  • Dutch translation (incomplete) (@Vistaus, #25)
  • German Translation (Jürgen Benvenuti)
  • Speedup thumbnail generation using BOX sampling instead of LANCZOS
  • Speedup thumbnail generation (at least on Linux) using already generated thumbnails from the cache instead of generating them from original images
• v1.1.2:
  • New translations:
    • Spanish
    • Russian
  • Updated translation:
    • Turkish
• v1.1.1:
  • Fix the abnormal amount of processes created (and not cleaned) when starting an optimization (#13)
• v1.1.0:
  • YOGA updated to v1.1.0:
    • Honor the JPEG orientation EXIF tag
    • JPEG optimization improved: up to 7.3 % of additional size reduction since previous version.
    • YOGA can no more output a PNG larger than the input one when performing a PNG to PNG optimization
  • Settings were added:
    • Theme selection / dark theme preference
    • Number of threads used to optimize images
    • Setting the default output locations / name or pattern of output files
  • "Optimize" and "Stop" buttons behaviour improved:
    • The "Stop" button now stops the running optimizations and not only the pending ones
    • Display a "Canceled" status on non-optimized image while the "Stop" button is clicked
    • Do not optimize again images that have already been optimized
  • Allow to resize images (downscale only, preserve ratio)
  • Multiselection: Multiple files can now be selected and their parameters can be edited all at once
  • Bug fix / improvements:
    • Do not allow to remove images with the <Del> key while an optimization is in progress
    • Fix image previews: no more ugly thumbnails with indexed images
    • Image previews now honor the JPEG orientation EXIF tag
  • Windows specific changes:
    • Use the Adwaita theme by default on Windows as the Windows10 GTK theme looks buggy
  • Translations udpated:
    • French
    • Italian (partial)
    • Occitan
    • Turkish (partial)
  • NOTE for packagers:
    • YOGA >= 1.1.0 is now required
    • YOGA v1.1.0 requires a new dependency: mozjpeg-lossless-optimization
• v1.0.1:
  • Fix PyPI packages
  • NOTE: no new release for Windows as nothing changed
• v1.0.0:
  • Fix [-] button do not remove selected image
  • Update site URL
• v0.99.2 (beta):
  • Fix package data not installed while installing with pip (#3)
  • NOTE: no new release for Windows as nothing changed
• v0.99.1 (beta):
  • Fix site URL in setup.py
  • Fix version number
• v0.99.0 (beta):
  • Initial release
  • Linux and Windows support
  • Optimizes PNG, JPEG and WebP image formats