Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Python bindings for MuPDF's rendering library.
C Python Shell
Latest commit 23f25bf @JorjMcKie JorjMcKie Update documentation reflecting ToC / metadata changes
Outline,table of contents and metadat are not made available before a
document is decrypted (method Document.authenticate).
Failed to load latest commit information.
PyMuPDF-optional-material @ 7ee6a14 added new submodule for PyMuPDF-optional-material
demo fix outline issue for encrypted doc
doc Update documentation reflecting ToC / metadata changes
examples corrected page number in outline editor
fitz Update documentation reflecting ToC / metadata changes
.gitignore Add method extractJSON and attr "len" for TextPage
.gitmodules added new submodule for PyMuPDF-optional-material
README.rst Update README to reflect optional material submodule update for lib path


PyMuPDF 1.8.0

Release date: Nov 15th, 2015


  • Ruikai Liu
  • Jorj X. McKie


This is the new version 1.8 of PyMuPDF (formerly python-fitz), a Python binding which supports MuPDF 1.8 - "a lightweight PDF and XPS viewer".

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

With PyMuPDF you therefore can also access files with extensions *.pdf, *.xps, *.oxps or *.epub from your Python scripts.


Normally it should be as easy as running python install once MuPDF is in place (i.e. has been generated).

For linux users, please make sure that the following libraries are available: libmupdf, libmujs, libcrypto, libjbig2dec, libopenjp2, libjpeg, libfreetype.

Refer to this document for details.


Please have a look at the basic demos or the examples which contain complete, working programs.

You can also access the complete documentation as a PDF or as a Windows compiled html.

Legacy Support


PyMuPDF is distributed under GNU GPL v3.


You can also find PyMuPDF on the Python Package Index PyPI.

We invite you to join our efforts by contributing to the the wiki pages.

Please submit comments or any issues either to this site or by sending an e-mail to the authors Ruikai Liu, Jorj X. McKie.

Something went wrong with that request. Please try again.