Home

Welcome to the python-fitz wiki!

python-fitz is a Python binding for MuPDF - "a lightweight PDF and XPS viewer". MuPDF supports viewing files in PDF, XPS, OpenXPS and EPUB formats.
This binding provides access to almost all functions of MuPDF from within a Python environment.

MuPDF stands out among all similar products for its top rendering capability and unsurmounted processing speed.
You can testify this by yourself:
Try out and compare the various free PDF-viewers. In terms of speed and rendering quality SumatraPDF ranges at the top - and it is based on MuPDF!

While these bindings have been available since several years for an earlier version of MuPDF (1.2), it was until only recently (mid May 2015), that its creator and a few co-workers decided to undertake the effort elevating this repository to the current release of MuPDF, which now counts at version 1.7a.
And we are determined to keep python-fitz current with futureMuPDF releases!

This work is almost completed: we currently working on simplifying the setup procedure.
If your platform is either Linux or Windows x86, you can use python-fitz today: just download this repository, the MuPDF source and perform a Python setup.

So, what do we have?

• We have a ready SWIG-generated wrapper that has been tested on LINUX and Windows installations.
• We have demo scripts for typical use cases that you can take as templates for your development.
• We have a simplified installation procedure for Linux and Windows.

So, what is still missing then?

• Some tests are still outstanding, e.g. for the combination Windows & Python 3.
• Functionality is complete. We are working to create a first official release.

We invite you to join our efforts by contributing to these wikis, by testing what is there - and, of course, by submitting issues and bugs to this site!