Release date: August 1, 2018
Travis-CI:
On PyPI since August 2015:
This is version 1.13.16 of PyMuPDF (formerly python-fitz), a Python binding with support for MuPDF 1.13.0 - "a lightweight PDF, XPS, and E-book viewer".
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 therefore can access files with extensions like ".pdf", ".xps", ".oxps", ".cbz", ".fb2" or ".epub" from your Python scripts.
See the Wiki for more information, news, release notes and usage recipies.
For all Windows and (thanks to our user @jbarlow83!) for the major Mac OSX and Linux versions we offer wheels. They can also be found in the download section of PyPI.
The platform tag for Mac OSX is macosx_10_6_intel.
The platform tag for Linux is manylinux1_x86_64, which works on Debian, Ubuntu and most others.
On other operating systems you need to generate PyMuPDF yourself. Before you can do this, you must download and generate MuPDF. This process depends very much on your system. For most platforms, the MuPDF source contains prepared procedures for achieving this.
Be sure to download the official MuPDF source release from here. The GitHub repo of MuPDF contains their current development source, which is not compatible with this PyMuPDF version most of the time.
Once this is done, adjust directories in setup.py and the rest should be as easy as running the usual python setup.py install.
The following sections contain some platform-specific comments.
One of our users (thanks to @gileadslostson!) has documented his MuPDF installation experience from sources in this Wiki page.
First, install the MuPDF headers and libraries, which are provided by mupdf-tools: brew install mupdf-tools.
Then you might need to export ARCHFLAGS='-arch x86_64', since libmupdf.a is for x86_64 only.
Finally, please double check setup.py before building. Update include_dirs and library_dirs if necessary.
In addition to wheels, this platform offers pre-generated binaries in a ZIP format, which can be used without PIP.
If you are looking to make your own binary, consult this Wiki page. It explains how to use Visual Studio for generating MuPDF in quite some detail.
Have a look at the basic demos, the examples (which contain complete, working programs), and the recipies section of our Wiki sidebar, which contains more than a dozen of guides in How-To-style.
Our documentation, written using Sphinx, is available in various formats from the following sources.
- You can view it online at Read the Docs. For best quality downloads use the following links.
- zipped HTML
- Windows CHM
Earlier versions are available in the releases directory.
PyMuPDF is distributed under GNU GPL V3. Because you will also be using MuPDF, its license GNU AFFERO GPL V3 applies as well. Copies of both are included in this repository.
Please submit questions, comments or issues here, or directly contact the authors via their e-mail addresses.