Powerful image converter for the latest formats with support for multithreading, drag 'n drop, and downscaling.
Available for Windows and Linux.
Read the Manual
Encode to JPEG XL, AVIF, WEBP, and JPG. Convert from HEIF and more
Just drop your images and convert. XL Converter works out of the box with no setup or steep learning curve. It prioritizes user experience while granting access to cutting-edge technology.
Encode images in parallel to speed up the process. Control how much CPU to use during encoding.
Losslessly transcode JPG to JPEG XL, and reverse the process when needed.
Avoid picky encoders. A proxy is generated when an encoder doesn't support a specific format.
For example, this enables HEIF -> JPEG XL conversion.
Scale down images to resolution, percent, shortest (and longest) side, or file size.
Utilize multiple formats to achieve the smallest size.
Optimize Effort
for smaller sizes.
Easily copy and wipe metadata using encoder parameters or ExifTool.
Generate the highest quality (regular old) JPGs with JPEGLI.
You can submit a bug report in 2 ways
- [public] Submit a new GitHub Issue
- [private] Email me at contact@codepoems.eu
Pull requests are ignored to avoid licensing issues when reusing the code.
Feel free to make bug reports as contributions.
Note
The recommended way of using XL Converter is through the official binary releases. The building process is time-consuming and tedious.
Install:
- Python
3.11.9
(withpip
) git
Clone the repo.
git clone -b stable --depth 1 https://github.com/JacobDev1/xl-converter.git
cd xl-converter
Setup venv
.
python -m venv env
env\Scripts\activate.bat
pip install -r requirements.txt
Install redistributable
Run the application
python main.py
You can also build it.
python build.py
Install packages.
sudo apt update
sudo apt install git make
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 pyenv via Automatic installer then add it to shell
Install Python build packages.
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
Build and setup Python 3.11.9
.
pyenv install 3.11.9
pyenv local 3.11.9
Clone and set up the repo.
git clone -b stable --depth 1 https://github.com/JacobDev1/xl-converter.git
chmod -R +x xl-converter
cd xl-converter
Create and activate a virtual environment.
python3 -m venv env
source env/bin/activate
Install Python dependencies
pip install -r requirements.txt
Now, you can run it.
make run
...or build it.
make build
Extra building modes:
make build-7z
- package to a 7z file (with an installer) (requiresp7zip-full
)make build-appimage
- package as an AppImage (requiresfuse
)
To build XL Converter, you need to provide various binaries. This can be quite challenging.
Binaries needed:
- libjxl
0.10.2
(with this patch on Windows)- cjxl
- djxl
- jxlinfo
- cjpegli
- libavif
1.0.4
(AOM3.8.2
)- avifenc
- avifdec
- imagemagick
7.1.1-15 Q16-HDRI
- magick - AppImage for Linux
- magick.exe - Windows
- exiftool
12.77
- exiftool.exe - Windows
- exiftool - standalone Perl build
- oxipng
0.9.0
Place them in the following directories:
xl-converter\bin\win
for Windows (x86_64)xl-converter/bin/linux
for Linux (x86_64)
All binaries are built statically. The version numbers should match. Binaries on Windows have an .exe
extension.
Tip
See the official XL Converter builds for examples.
Important
This project runs on Python 3.11
. Other versions are not supported.
Note
Don't forget --depth 1
when running git clone
to avoid large files.
Create a test environment.
python3 -m venv env_test
source env/bin/activate
pip install -r requirements.txt
pip install -r requirements_test.txt
Run tests
python test.py
test_old.py
is a deprecated, but still accessible test suite focusing on the conversion results.
python test_old.py