PyMuPDF Pro

Overview

PyMuPDF Pro is a set of commercial extensions for PyMuPDF.

• Enables Office document handling, including doc, docx, hwp, hwpx, ppt, pptx, xls, xlsx, and others.

• Supports text and table extraction, document conversion and more.

• Available for these platforms only:

  • Windows x86_64.
  • Linux x86_64 (glibc).
  • Linux aarch64 (glibc).
  • MacOS x86_64.
  • MacOS arm64.

• Supports Python 3.10+.

• See https://artifex.com/products/pymupdf-pro/ for more.

Installation

pip install pymupdfpro

This will also install PyMuPDF.

Usage

Restricted usage without a key:

import pymupdf.pro
pymupdf.pro.unlock()

# PyMuPDF has now been extended with PyMuPDF Pro features, with some
# restrictions.

Unrestricted usage with a key from https://pymupdf.io/try-pro:

import pymupdf.pro
pymupdf.pro.unlock(my_key)

# PyMuPDF has now been extended with PyMuPDF Pro features.

• For more please see: https://pymupdf.readthedocs.io/en/latest/pymupdf-pro.html#usage

Changelog

PyMuPDFPro-1.28.2

• Improve font handling on Linux/MacOS.

  We now use Python package fontconfig_py. Previously we used internal build of libfontconfig, which failed if libfreetype was not available.

PyMuPDFPro-1.28.0

• Works with PyMuPDF-1.28.0.
• Use Marina version of SmartOffice.
• Added git build information in pymupdf.pro._pro_build.
• Added export functions:
  • pymupdf.pro.office_to_json().
  • pymupdf.pro.office_to_markdown().
  • pymupdf.pro.office_to_pdf().
  • pymupdf.pro.office_export().

PyMuPDFPro-1.27.2.3

• Works with PyMuPDF-1.27.2.3.
• Uses SmartOffice tag v3.16.79.
• Fix pymupdf #4159 PyMuPDF Pro 1.25.0: Image in .doc file unexpectedly overlaps with text when using get_pixmap()
• Retrospectively mark pymupdf #4158 as fixed in PyMuPDFPro-1.27.1.

PyMuPDFPro-1.27.2.2

• Works with PyMuPDF-1.27.2.2.
• Uses SmartOffice tag v3.16.79.

PyMuPDFPro-1.27.2

• Works with PyMuPDF-1.27.2.
• Use SmartOffice tag v3.16.79.

PyMuPDFPro-1.27.1

• Works with PyMuPDF-1.27.1.
• Use SmartOffice tag v3.16.76.
• Fixed pymupdf #4158.

PyMuPDFPro-1.26.6

• Works with PyMuPDF-1.26.6.

PyMuPDFPro-1.26.5

• Works with PyMuPDF-1.26.5.
• Refuse to run if mupdf is incorrect version - avoids potential segv with incorrect installations.
• On MacOS, avoid depending on Brew install of fontconfig.
• Graal fixes.

PyMuPDFPro-1.26.4.1

• Experimental release.
• On MacOS, avoid depending on Brew install of fontconfig.
• Graal fixes.

PyMuPDFPro-1.26.4

• Works with PyMuPDF-1.26.4.
• Use SmartOffice tag v3.16.68.

PyMuPDFPro-1.26.3.1

• Experimental release with SO fixes.

PyMuPDFPro-1.26.3 (2025-7-11):

• Works with PyMuPDF-1.26.3.

PyMuPDFPro-1.26.1 (2025-6-26):

• Fix problem in activity monitoring.
• Use SmartOffice tag v3.16.61-preconverted.
• Added Linux-aarch64 wheel.
• Use SmartOffice tag issue10489.
• Fixed document.metadata['format'] strings - previously the last character was truncated.
• Fixed test_4496(), 'cannot find entry Contents/Contents/header.xml' error.

PyMuPDFPro-1.25.5 (2025-04-01):

• Works with PyMuPDF-1.25.5.

PyMuPDFPro-1.25.4 (2025-03-17):

• Works with PyMuPDF-1.25.4.
• Use SmartOffice tag issue10456.
• Avoid Windows test failure if font directory does not exist.

PyMuPDFPro-1.25.3 (2025-02-10):

• Works with PyMuPDF-1.25.3.
• Use newer Office code.

PyMuPDFPro-1.25.0 (2024-12-09):

• Fixed handling of trial keys - used to only allow 3 pages.
• Avoid using many file descriptors for installed .otf fonts.

2024-12-03: PyMuPDFPro-1.24.14

• Works with PyMuPDF-1.24.14.
• Allow use with later PyMuPDF.
• Improve font finding on Windows.
• Added activity monitoring.
• Improved handling of invalid keys.
• Improved display of key timeout.

2024-10-25: PyMuPDFPro-1.24.12

• Works with PyMuPDF-1.24.12.
• Automatically add all system fonts on non-Windows.
  • Fixes #3976.

2024-10-15: PyMuPDFPro-1.24.11

• Works with PyMuPDF-1.24.11.

• Work better on older OS releases.

• Supported Python versions are now 3.9-3.13.

  • Support added for Python 3.13 because now released.
  • Support dropped for Python 3.8 because end-of-life.
  • See https://devguide.python.org/versions/.

• Wheels now use the Python Stable ABI.

  • There is now just one wheel per platform.
  • Each wheel works with all supported Python versions.

2024-09-05: PyMuPDFPro-1.24.10

• Works with PyMuPDF-1.24.10.
• Added support for MacOS-arm64.
• Fixed detection of key with no expiry.

2024-08-08: PyMuPDFPro-1.24.9.1

• Works with PyMuPDF-1.24.9.
• Added support for MacOS-x86_64.

2024-07-26: PyMuPDFPro-1.24.9

• Works with PyMuPDF-1.24.9.
• Support for Windows-amd64 and Linux-x86_64.

Licensing

Some PyMuPDFPro wheels contain libfontconfig, which is distributed under the following license:

Copyright © 2000,2001,2002,2003,2004,2006,2007 Keith Packard
Copyright © 2005 Patrick Lam
Copyright © 2007 Dwayne Bailey and Translate.org.za
Copyright © 2009 Roozbeh Pournader
Copyright © 2008,2009,2010,2011,2012,2013,2014,2015,2016,2017,2018,2019,2020 Red Hat, Inc.
Copyright © 2008 Danilo \u0160egan
Copyright © 2012 Google, Inc.
Permission to use, copy, modify, distribute, and sell this software and its
documentation for any purpose is hereby granted without fee, provided that
the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting
documentation, and that the name of the author(s) not be used in
advertising or publicity pertaining to distribution of the software without
specific, written prior permission.  The authors make no
representations about the suitability of this software for any purpose.  It
is provided "as is" without express or implied warranty.
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.