loongson/pypi/: pymupdf-1.19.6 metadata and description

Homepage Simple index

Python bindings for the PDF toolkit and renderer MuPDF

author Jorj McKie
author_email jorj.x.mckie@outlook.de
  • Development Status :: 5 - Production/Stable
  • Intended Audience :: Developers
  • Intended Audience :: Information Technology
  • Operating System :: MacOS
  • Operating System :: Microsoft :: Windows
  • Operating System :: POSIX :: Linux
  • Programming Language :: C
  • Programming Language :: Python :: 3 :: Only
  • Programming Language :: Python :: Implementation :: CPython
  • Topic :: Utilities
  • Topic :: Multimedia :: Graphics
  • Topic :: Software Development :: Libraries
description_content_type text/markdown
license GNU AFFERO GPL 3.0
  • Documentation, https://pymupdf.readthedocs.io/
  • Source, https://github.com/pymupdf/pymupdf
  • Tracker, https://github.com/pymupdf/PyMuPDF/issues
  • Changelog, https://pymupdf.readthedocs.io/en/latest/changes.html
  • Discussions, https://github.com/pymupdf/PyMuPDF/discussions
requires_python >=3.6

Because this project isn't in the mirror_whitelist, no releases from root/pypi are included.

File Tox results History
28 MB
Python Wheel
29 MB
Python Wheel

PyMuPDF 1.19.6


Release date: March 3, 2022

On PyPI since August 2016: Downloads


Jorj X. McKie, based on original code by Ruikai Liu.


PyMuPDF (current version 1.19.6) is a Python binding with support for MuPDF (current version 1.19.*), a lightweight PDF, XPS, and E-book viewer, renderer, and toolkit, which is maintained and developed by Artifex Software, Inc.

MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB and FB2 (e-books) formats, and it is known for its top performance and high rendering quality.

With PyMuPDF you can access files with extensions like ".pdf", ".xps", ".oxps", ".cbz", ".fb2" or ".epub". In addition, about 10 popular image formats can also be handled like documents: ".png", ".jpg", ".bmp", ".tiff", etc..

In partnership with Artifex, PyMuPDF is now also available for commercial licensing. This agreement has no impact on use cases, that are compliant with the open-source license AGPL. Please see the "License and Copyright" section below for additional information.


For all supported document types (i.e. including images) you can

To some degree, PyMuPDF can also be used as an image converter: it can read a range of input formats and can produce Portable Network Graphics (PNG), Portable Anymaps (PNM, etc.), Portable Arbitrary Maps (PAM), Adobe Postscript and Adobe Photoshop documents, making the use of other graphics packages obselete in these cases. But interfacing with e.g. PIL/Pillow for image input and output is easy as well.

For PDF documents, there exists a plethora of additional features: they can be created, joined or split up. Pages can be inserted, deleted, re-arranged or modified in many ways (including annotations and form fields).

Have a look at the basic demos, the examples (which contain complete, working programs), and notebooks.


Documentation is written using Sphinx and is available in various formats from the following sources. It currently is a combination of reference guide and user manual. For a quick start look at the tutorial and the recipes chapters.

The latest changelog can be viewed here.


PyMuPDF requires Python 3.6 or later.

For versions 3.7 and up, Python wheels exist for Windows (32bit and 64bit), Linux (64bit, Intel and ARM) and Mac OSX (64bit, Intel only), so it can be installed from PyPI in the usual way. To ensure pip support for the latest wheel platform tags, we strongly recommend to always upgrade pip first.

python -m pip install --upgrade pip
python -m pip install --upgrade pymupdf

There are no mandatory external dependencies. However, some optional features become available only if additional packages are installed:

Older wheels - also with support for older Python versions - can be found here and on PyPI.

Other platforms require installation from sources, follow these instructions in the documentation.

Note: If pip cannot find a wheel that is compatible with your platform, it will automatically try an installation from sources - which will fail if MuPDF (including its sources) is not installed on your system.

This repo's folder installation contains several platform-specific source installation scripts contributed by users. You may also find the following Wiki pages useful:

License and Copyright

In order to comply with MuPDF’s dual licensing model, PyMuPDF has entered into an agreement with Artifex who has the right to sublicense PyMuPDF to third parties.

PyMuPDF and MuPDF are now available under both, open-source AGPL and commercial license agreements.

Please read the full text of the AGPL license agreement (which is also included here in file COPYING) to ensure that your use case complies with the guidelines of this license. If you determine you cannot meet the requirements of the AGPL, please contact Artifex for more information regarding a commercial license.

Artifex is the exclusive commercial licensing agent for MuPDF.

Artifex, the Artifex logo, MuPDF, and the MuPDF logo are registered trademarks of Artifex Software Inc. © 2021 Artifex Software, Inc. All rights reserved.


Please use the Discussions menu for questions, comments, or asking for help, and submit issues here. If you wish, you can also contact me directly via jorj.x.mckie@outlook.de.