Skip to content

Commit

Permalink
Add optional heif dependency to allow installing via willow[heif]
Browse files Browse the repository at this point in the history
  • Loading branch information
zerolab committed Jul 13, 2023
1 parent a03c333 commit 24bd7be
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 1 deletion.
16 changes: 16 additions & 0 deletions docs/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,19 @@ or Wand.

Note that Pillow doesn't support animated GIFs and Wand isn't as fast.
Installing both will give best results.


HEIC and AVIF support
^^^^^^^^^^^^^^^^^^^^^

When using Pillow, you need to install ``pillow-heif`` for AVIF and HEIC support:

.. code-block:: shell
pip install pillow-heif
# or
pip install Willow[heif]
When using Wand, you will need ImageMagick version 7.0.25 or newer.

Both Pillow and Wand require ``libheif`` to be installed on your system for full HEIC support.
5 changes: 4 additions & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -30,11 +30,14 @@ dependencies = [
]

[project.optional-dependencies]
heif = [
"pillow-heif>=0.10.0,<1.0.0",
]
testing = [
"Pillow>=9.1.0,<11.0.0",
"Wand>=0.6,<1.0",
"mock>=3.0,<4.0",
"pillow-heif>=0.7.0,<1.0.0",
"pillow-heif>=0.10.0,<1.0.0",
"black==22.3.0",
"ruff==0.0.275",
"coverage[toml]>=7.2.7,<8.0",
Expand Down

0 comments on commit 24bd7be

Please sign in to comment.