XL Converter

Easy-to-use image converter for modern formats.

Available for Windows and Linux.

Read the Manual

Generate fully compatible JPEG images with up to 35% better compression ratio.

Maximize image compression with JPEG XL and AVIF. Also available: WebP, JPEG, and PNG.

Run encoders in parallel for increased throughput.

Reduce the file size of your JPEG images by 16% - 22% with Lossless JPEG Transcoding. This process is reversible.

Scale down images to resolution, percent, shortest (and longest) side, and megapixels.

Official website

Prerequisites:

• Python 3.13 (check Add python.exe to PATH)
• git
• MSYS2
• Visual Studio 2022 (with Windows 10 or 11 SDK)
• Latest vc_redist

Launch MSYS2 MINGW64 and run:

pacman -Syu

If MSYS2 asks to restart, agree, and relaunch it.

Install packages:

pacman -S --needed \
    git \
    cmake \
    wget \
    make \
    base-devel \
    autoconf \
    automake \
    libtool \
    nasm \
    mingw-w64-x86_64-gcc \
    mingw-w64-x86_64-toolchain \
    mingw-w64-x86_64-cmake \
    mingw-w64-x86_64-ninja \
    mingw-w64-x86_64-gtest \
    mingw-w64-x86_64-giflib \
    mingw-w64-x86_64-libpng \
    mingw-w64-x86_64-libjpeg-turbo \
    mingw-w64-x86_64-rust \
    mingw-w64-x86_64-7zip \
    mingw-w64-x86_64-imagemagick \
    mingw-w64-x86_64-libjxl \
    mingw-w64-x86_64-aom

Relaunch MSYS2 MINGW64 again.

Clone the repo:

git clone -b stable --depth 1 https://github.com/JacobDev1/xl-converter.git
cd xl-converter

Run each target individually; each has additional requirements:

• make libjpeg-turbo
• make libavif
• make imagemagick
• make libjxl
• make oxipng
• make exiftool

Launch CMD, enter the project's directory, and setup a virtual environment:

cd C:\msys64\home\user\xl-converter
python -m venv env_build
env_build\Scripts\activate
pip install -r requirements.txt

Run the application:

python main.py

Launch CMD, and setup PyInstaller:

cd C:\msys64\home\user\xl-converter
call misc\build_scripts\windows\pyinstaller.cmd
env_build\Scripts\activate

The last line reloads the environment to avoid the ModuleNotFoundError.

Bundle:

python build.py

Prerequisites:

• Docker (set up to run without root)
• pyenv (add to shell)

Install packages:

sudo apt update
sudo apt install git make curl fuse p7zip-full

Install xcb QPA dependencies:

sudo apt install '^libxcb.*-dev' libfontconfig1-dev libfreetype6-dev libx11-dev libx11-xcb-dev libxext-dev libxfixes-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev

Install Python build dependencies:

sudo apt install wget build-essential libreadline-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev liblzma-dev

Compile and setup Python 3.13:

pyenv install 3.13
pyenv global 3.13

Clone and set up the repo:

git clone -b stable --depth 1 https://github.com/JacobDev1/xl-converter.git
cd xl-converter

Compile dependencies:

make deps

Setup a virtual environment:

python -m venv env_build
source env_build/bin/activate
pip install -r requirements.txt

Run the program:

python main.py

Setup PyInstaller:

./misc/build_scripts/linux/pyinstaller.sh
source env_build/bin/activate

The last line reloads the environment to avoid the ModuleNotFoundError.

Build:

python build.py

Setup repo.

Create a test environment.

python -m venv env_dev
source env_dev/bin/activate
pip install -r requirements.txt -r requirements_test.txt

python test.py

You can control which tests to run. Run python test.py --help to learn more.

test_convert.py is a separate test suite focusing on validating program's output.

sudo apt install xvfb
make test-convert

python test_convert.py

Before contributing to issues or sending pull requests, please review CONTRIBUTING.md.