This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!
Project Description

PyMuPDF 1.11.0

Release date: May 1, 2017

Authors

  • Ruikai Liu
  • Jorj X. McKie

Introduction

This is version 1.11.0 of PyMuPDF (formerly python-fitz), a Python binding which supports MuPDF 1.11 - “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.

See the Wiki for more info/news/release notes/etc.

Installation

You need to have MuPDF generated first. This process depends on your platform, see below. MuPDF’s source comes with installation procedures for various operating systems, so you should be able to pick the right one for you. Linux versions also often provide pre-generated MuPDF software.

For Non-Windows systems, probably the safest way is to generate MuPDF from source. Download the official release from https://mupdf.com/downloads/. MuPDF’s GitHub repository contains the latest development source - this is not what you want in this context. Make sure PyMuPDF already supports this MuPDF version, otherwise skip to an earlier release: https://mupdf.com/downloads/archive/.

Once this is done, adjust directories in setup.py and the rest should be as easy as running python setup.py install.

Refer to this document for more details: http://pythonhosted.org/PyMuPDF/installation.html.

Ubuntu

Since MuPDF’s current releases are often delayed in the official repo, you need to build it from source as indicated above. Make sure to add -fPIC to CFLAGS when compiling.

When MuPDF is ready, edit setup.py in PyMuPDF and comment out the line of library_dirs=[] to specify the directory which contains libmupdf.a and other 3rd party libraries. Remove crypto from libraries in setup.py if it complains.

Also do have a look at the respective Wiki in PyMuPDF’s GitHub repository.

OSX

First please make sure that the dependencies are satisfied: brew install mupdf-tools jpeg jbig2dec freetype openssl

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 where necessary.

Windows

We have prepared binaries here, that are suitable for your Python version. Using this option requires nothing else - no MuPDF source / generation, no compiler nor Visual Studio. Please refer to this document for details.

If you however want to make your own binary, have a look at this Wiki page. It explains how to use Visual Studio for generating MuPDF in some detail. This is also the way, how the pre-generated binaries have been created.

Usage and Documentation

You can render supported documents, extract text in a variety of formats, access (for PDF also update) annotations, links, meta information, table of contents, and (PDF only) decrypt, compress / decompress files, re-arrange / duplicate / delete pages, join documents or update meta information, annotations and bookmarks. In version 1.11.0, PyMuPDF also has added support for PDF embedded files.

The underlying graphics library also offers a range of very fast image handling functions which can be used independently from dealing with document files, and which also easily interface with other Python graphics libraries like PIL

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

You have a number of options to access documentation:

Contact

Please direct comments or any issues to either the bug tracker of GitHub or e-mail the authors Ruikai Liu, Jorj X. McKie.

Release History

Release History

1.11.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.10.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.9.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting