jxlpy

JXLPy

This module introduces reading and writing support for JPEG XL directly from Python 3.

JXLPy is based on JPEG XL implementation in imagecodecs but doesn't it require Numpy and any external dependencies besides Cython and libjxl.

It also provides support for Pillow via plugin.

This project is still in alpha stages and needs testing. It may contain bugs!

Install via PIP

$ pip install jxlpy

Build it yourself

• Make sure you are using Python 3.x and pip for that version

• Build and install libjxl according to instructions here

• Install patchelf and auditwheel

  $ sudo apt-get install patchelf
  $ pip install auditwheel
  

• For Pillow plugin, make sure that Pillow is installed (optional)

  $ pip install ---upgrade pillow
  

• Clone this repository

  $ git clone https://github.com/olokelo/jxlpy
  $ cd jxlpy
  

• Build wheels

  $ pip wheel .
  

• Use auditwheel to put necessary libraries into your wheel

  $ export LD_LIBRARY_PATH=/usr/local/lib
  $ python -m auditwheel repair --plat linux_x86_64 jxlpy-*.whl
  

• Install newly created wheel

  $ cd wheelhouse
  $ pip install jxlpy-*.whl
  

• Now you should be good to go :)

  You can run examples to check if everything works correctly

Installation steps were tested on Ubuntu 20.04

Support status

Feature	Status	Importance	Notes
Reading and writing non-animated 8 bit RGB/RGBA image	Done	-	-
Creating lossless images	Done	-	-
Reading animations	Done	-	-
Pillow plugin	Partial	High	Animation seeking?
Creating animations	Failed	Medium	-
Reading HDR images	Done	Medium	-
Writing HDR images	Done	Low	-
Reading and writing floating point images	Not started	Low	-
Support EXIF metadata	Failed	High	-
Support for other colorspaces	Not started	Low	-
Support for lossless JPEG recompression	Not started	Medium	-
Support for progressive and responsive mode	Failed	Medium	-
Installing on Windows	Partial	Low	-