PyTurboJPEG

What it is and what it does

PyTurboJPEG is a Python binding to libjpeg-turbo that lets you decode JPEG files into numpy arrays and re-encode them with control over quality, color format, and subsampling. The package supports advanced operations like lossless cropping, scaling with quality preservation, YUV planar decoding, and in-place operations to reuse memory buffers. It handles multiple JPEG precisions and can extract header information without full decompression.

The main constraint is that libjpeg-turbo 3.0 or later must be installed separately as a system library. Once that is in place, the package integrates with numpy and works across Python 3.8 through 3.14. Resource limits are disabled by default to support large-image workflows, but can be configured when processing untrusted JPEGs. The API exposes both high-level convenience methods and lower-level control through flags and parameters.

Use it for

• Batch convert or re-encode large JPEG collections with custom quality settings or subsampling to reduce file size.
• Decode JPEG images directly into numpy arrays for computer vision pipelines without intermediate format conversions.
• Extract JPEG header metadata (dimensions, subsampling, colorspace) before deciding whether to decode the full image.
• Perform lossless JPEG operations like cropping or Huffman table optimization without re-encoding pixel data.
• Decode JPEG to YUV planes for video processing or direct GPU upload without RGB conversion overhead.
• Scale JPEG images on-the-fly during decode to reduce memory usage in memory-constrained environments.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

pyturbojpeg on PyPI

Before you install

Low install friction with a pure-wheel distribution, but requires libjpeg-turbo 3.0 or later as a system library—not a Python dependency. The package is actively maintained with a recent release and no known vulnerabilities.

libjpeg-turbo 3.0 or later must be installed as a system library before importing PyTurboJPEG; on macOS use `brew install jpeg-turbo`, on Linux/Windows download from the official libjpeg-turbo releases.

License in practice

MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute PyTurboJPEG freely provided you include the license notice.

Quickstart

pip install pyturbojpeg
import numpy
from pyturbojpeg import TurboJPEG
jpeg = TurboJPEG()
with open('input.jpg', 'rb') as f:
    bgr_array = jpeg.decode(f.read())
with open('output.jpg', 'wb') as f:
    f.write(jpeg.encode(bgr_array))

Package facts

Evidence: pyturbojpeg-2.5.0-py3-none-any.whl

Tags

More Graphics packages

See also simplejpeg · turbojpeg · pillow-jxl-plugin · pylibjpeg-libjpeg · pylibjpeg · pyjpegls · qoi · pylibjpeg-openjpeg · edk2-pytool-library · img2pdf