Pillow
======

Pillow is the friendly PIL fork by `Jeffrey A. Clark (Alex) and contributors <https://github.com/python-pillow/Pillow/graphs/contributors>`_. PIL is the Python Imaging Library by Fredrik Lundh and contributors.

Pillow for enterprise is available via the Tidelift Subscription. `Learn more <https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=docs&utm_campaign=enterprise>`_.

.. image:: https://readthedocs.org/projects/pillow/badge/?version=latest
   :target: https://pillow.readthedocs.io/?badge=latest
   :alt: Documentation Status

.. image:: https://github.com/python-pillow/Pillow/workflows/Lint/badge.svg
   :target: https://github.com/python-pillow/Pillow/actions/workflows/lint.yml
   :alt: GitHub Actions build status (Lint)

.. image:: https://github.com/python-pillow/Pillow/workflows/Test%20Docker/badge.svg
   :target: https://github.com/python-pillow/Pillow/actions/workflows/test-docker.yml
   :alt: GitHub Actions build status (Test Docker)

.. image:: https://github.com/python-pillow/Pillow/workflows/Test/badge.svg
   :target: https://github.com/python-pillow/Pillow/actions/workflows/test.yml
   :alt: GitHub Actions build status (Test Linux and macOS)

.. image:: https://github.com/python-pillow/Pillow/workflows/Test%20Windows/badge.svg
   :target: https://github.com/python-pillow/Pillow/actions/workflows/test-windows.yml
   :alt: GitHub Actions build status (Test Windows)

.. image:: https://github.com/python-pillow/Pillow/workflows/Test%20MinGW/badge.svg
   :target: https://github.com/python-pillow/Pillow/actions/workflows/test-mingw.yml
   :alt: GitHub Actions build status (Test MinGW)

.. image:: https://github.com/python-pillow/Pillow/workflows/Test%20Cygwin/badge.svg
   :target: https://github.com/python-pillow/Pillow/actions/workflows/test-cygwin.yml
   :alt: GitHub Actions build status (Test Cygwin)

.. image:: https://img.shields.io/appveyor/build/python-pillow/Pillow/main.svg?label=Windows%20build
   :target: https://ci.appveyor.com/project/python-pillow/Pillow
   :alt: AppVeyor CI build status (Windows)

.. image:: https://github.com/python-pillow/Pillow/workflows/Wheels/badge.svg
   :target: https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml
   :alt: GitHub Actions build status (Wheels)

.. image:: https://codecov.io/gh/python-pillow/Pillow/branch/main/graph/badge.svg
   :target: https://app.codecov.io/gh/python-pillow/Pillow
   :alt: Code coverage

.. image:: https://zenodo.org/badge/17549/python-pillow/Pillow.svg
   :target: https://zenodo.org/badge/latestdoi/17549/python-pillow/Pillow
   :alt: Zenodo

.. image:: https://tidelift.com/badges/package/pypi/pillow?style=flat
   :target: https://tidelift.com/subscription/pkg/pypi-pillow?utm_source=pypi-pillow&utm_medium=badge
   :alt: Tidelift

.. image:: https://oss-fuzz-build-logs.storage.googleapis.com/badges/pillow.svg
   :target: https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:pillow
   :alt: Fuzzing Status

.. image:: https://img.shields.io/pypi/v/pillow.svg
   :target: https://pypi.org/project/pillow/
   :alt: Latest PyPI version

.. image:: https://img.shields.io/pypi/dm/pillow.svg
   :target: https://pypi.org/project/pillow/
   :alt: Number of PyPI downloads

.. image:: https://www.bestpractices.dev/projects/6331/badge
   :target: https://www.bestpractices.dev/projects/6331
   :alt: OpenSSF Best Practices

.. image:: https://badges.gitter.im/python-pillow/Pillow.svg
   :target: https://gitter.im/python-pillow/Pillow?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
   :alt: Join the chat at https://gitter.im/python-pillow/Pillow

.. image:: https://img.shields.io/badge/publish-on%20Mastodon-595aff.svg
   :target: https://fosstodon.org/@pillow
   :alt: Follow on https://fosstodon.org/@pillow

.. raw:: html

   <link rel="me" href="https://fosstodon.org/@pillow">

Overview
========

The Python Imaging Library adds image processing capabilities to your Python interpreter.

This library provides extensive file format support, an efficient internal representation, and fairly powerful image processing capabilities.

The core image library is designed for fast access to data stored in a few basic pixel formats. It should provide a solid foundation for a general image processing tool.

.. toctree::
   :maxdepth: 2

   installation.rst
   handbook/index.rst
   reference/index.rst
   porting.rst
   about.rst
   releasenotes/index.rst
   deprecations.rst

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`