PyMuPDF 1.20.1
Release date: June 27, 2022
On PyPI since August 2016:
Author
Artifex, based on code by Jorj X. McKie and Ruikai Liu.
Introduction
PyMuPDF adds Python bindings and abstractions to MuPDF, a lightweight PDF, XPS, and eBook viewer, renderer, and toolkit. Both PyMuPDF and MuPDF are maintained and developed by Artifex Software, Inc.
MuPDF can access files in PDF, XPS, OpenXPS, CBZ, EPUB and FB2 (eBooks) formats, and it is known for its top performance and exceptional rendering quality.
With PyMuPDF you can access files with extensions like .pdf, .xps, .oxps, .cbz, .fb2 or .epub. In addition, about 10 popular image formats can also be handled like documents: .png, .jpg, .bmp, .tiff, etc.
Usage
For all supported document types (i.e. including images) you can
- Decrypt the document.
- Access meta information, links and bookmarks.
- Render pages in raster formats (PNG and some others), or the vector format SVG.
- Search for text.
- Extract text and images.
- Convert to other formats: PDF, (X)HTML, XML, JSON, text.
- Do OCR (Optical Character Recognition) if Tesseract is installed.
To some degree, PyMuPDF can also be used as an image converter: it can read a range of input formats and can produce Portable Network Graphics (PNG), Portable Anymaps (PNM, etc.), Portable Arbitrary Maps (PAM), Adobe PostScript and Adobe Photoshop documents, making the use of other graphics packages obselete in these cases. But interfacing with e.g. PIL/Pillow for image input and output is easy as well.
For PDF documents, there exists a plethora of additional features: they can be created, joined or split up. Pages can be inserted, deleted, re-arranged or modified in many ways (including annotations and form fields).
-
Images and fonts can be extracted or inserted.
You may want to have a look at this cool GUI example script, which lets you insert, delete, replace or re-position images under your visual control.
If fontTools is installed, subsets can be built for eligible fonts based on their usage in the document. Especially for new PDFs, this can lead to significant file size reductions.
-
Embedded files are fully supported.
-
PDFs can be reformatted to support double-sided printing, posterizing, applying logos or watermarks
-
Password protection is fully supported: decryption, encryption, encryption method selection, permission level and user / owner password setting.
-
Support of the PDF Optional Content concept for images, text and drawings.
-
Low-level PDF structures can be accessed and modified.
-
Command line module
"python -m fitz ...". A versatile utility with the following features- encryption / decryption / optimization
- creation of sub-documents
- document joining
- image / font extraction
- full support of embedded files
- layout-preserving text extraction (all documents)
Have a look at the basic demos, the examples (which contain complete, working programs), and notebooks.
Documentation
Documentation is written using Sphinx and is available in various formats from the following sources. It currently is a combination of reference guide and user manual. For a quick start look at the tutorial and the recipes chapters.
- You can view it online at Read the Docs. This site also provides download options for PDF.
- Zipped HTML.
- Windows help file.
The latest changelog can be viewed here.
Installation
PyMuPDF requires Python 3.7 or later.
For versions 3.7 and up, Python wheels exist for Windows (32bit and 64bit), Linux (64bit, Intel and ARM) and Mac OSX (64bit, Intel only), so it can be installed from PyPI in the usual way. To ensure pip support for the latest wheel platform tags, we strongly recommend to always upgrade pip first.
python -m pip install --upgrade pip
python -m pip install --upgrade pymupdf
There are no mandatory external dependencies. However, some optional features become available only if additional packages are installed:
- Pillow for using pillow image output directly from PyMuPDF
- fontTools for creating font subsets.
- pymupdf-fonts contains some nice fonts for your text output.
- Tesseract-OCR for optical character recognition in images and document pages. Tesseract is separate software, not a Python package. To enable OCR functions in PyMuPDF, the system environment variable
"TESSDATA_PREFIX"must be defined and contain thetessdatafolder name of the Tesseract installation location.
Older wheels - also with support for older Python versions - can be found here and on PyPI.
Note: If
pipcannot find a wheel that is compatible with your platform, it will automatically build and install from source using the PyMuPDF sdist; this requires only that SWIG is installed on your system.
[New in
PyMuPDF-1.20: there is no need to separately build or install MuPDF; the required MuPDF source code is already in the sdist and is automatically built into PyMuPDF.]
License and Copyright
PyMuPDF and MuPDF are available under both, open-source AGPL and commercial license agreements.
Please read the full text of the AGPL license agreement (which is also included here in file COPYING) to ensure that your use case complies with the guidelines of this license. If you determine you cannot meet the requirements of the AGPL, please contact Artifex for more information regarding a commercial license.
Artifex is the exclusive commercial licensing agent for MuPDF.
Artifex, the Artifex logo, MuPDF, and the MuPDF logo are registered trademarks of Artifex Software Inc. PyMuPDF and the PyMuPDF logo are trademarks of Artifex Software, Inc. © 2022 Artifex Software, Inc. All rights reserved.
Contact
Please use the Discussions menu for questions, comments, or asking for help, and submit issues here.
1 maintainer
Release files for pymupdf 1.20.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| PyMuPDF-1.20.1.tar.gz | 90.4 MB | Details |
Built distributions (wheels)
Total release size: 241.2 MB
Release files / PyMuPDF-1.20.1.tar.gz
| Download URL | PyMuPDF-1.20.1.tar.gz |
|---|---|
| Size | 90.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
305c1a64b8fb2fd465e27cc8bdcbf0f64224f0ec6d7763e3f5f2ca6783136649
|
|
BLAKE2b-256 checksum How to use checksums |
29e4d1d88146ef0b3b97d785acc7aed22b9774ac6bcf137e98b48a9c9bbb7f35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp310-cp310-win_amd64.whl
| Download URL | PyMuPDF-1.20.1-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c390228b3bb5d63b0765d1a3e37ecdbe80771e81b06ef8badf51a69954f3a67a
|
|
BLAKE2b-256 checksum How to use checksums |
3dfee1979617cdbd7e22995314d687345712e43bd8c43099f0926d17687e5ba0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp310-cp310-win32.whl
| Download URL | PyMuPDF-1.20.1-cp310-cp310-win32.whl |
|---|---|
| Size | 5.9 MB |
| Tags | CPython 3.10 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
5dd4f3ec6b65c5b5cfc559d1d99c09983924714170ff262cf2d7eba080545bfe
|
|
BLAKE2b-256 checksum How to use checksums |
9c0b4507703efcdd996044d89880a3cde18c3d5ec4a84922dc6997d3b1402a00
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | PyMuPDF-1.20.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 8.9 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
12167cd3a58f50b9e67600112834d588beeec400ffce06564b8f2bf2b8b8f9f7
|
|
BLAKE2b-256 checksum How to use checksums |
b6a3bca132d4af5385187c7f78b1a926342a8d647dc78da7ba78ad7a90c9c495
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | PyMuPDF-1.20.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 8.8 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
524396cb72a361b1382ad6dbb7ad51b123b76cd98e88fafe46f96252ebb8a484
|
|
BLAKE2b-256 checksum How to use checksums |
25409c85e9f4c3ba6646605f4d0eb43cb37cac27954f511f9b2a98129283edbb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp310-cp310-macosx_10_9_x86_64.whl
| Download URL | PyMuPDF-1.20.1-cp310-cp310-macosx_10_9_x86_64.whl |
|---|---|
| Size | 7.7 MB |
| Tags | CPython 3.10 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
8d37aeebe2b22f9d1706e3cbcb889dab644988fb05bdb5275c701634961044e6
|
|
BLAKE2b-256 checksum How to use checksums |
37d7b35342ee77750342119706959a0230f341c90affdd262ef6bf132f6f5e1f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp39-cp39-win_amd64.whl
| Download URL | PyMuPDF-1.20.1-cp39-cp39-win_amd64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.9 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
9a44b02244b49a9f3f10116b8b75355c6c9514e3616578b114a7f83e5543d222
|
|
BLAKE2b-256 checksum How to use checksums |
1b3617becb3289dc96a99c6186b8e7ce7379d4450c76a74160a2a03da03273d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp39-cp39-win32.whl
| Download URL | PyMuPDF-1.20.1-cp39-cp39-win32.whl |
|---|---|
| Size | 5.9 MB |
| Tags | CPython 3.9 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
093caedaac344febd22eff270116d00f85ef3be7cb2ba09dcd67986165098b66
|
|
BLAKE2b-256 checksum How to use checksums |
43799ad9ee04b647d5e7f33e98c90a576102bff92dec7f1a7eede28775b27b84
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | PyMuPDF-1.20.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 8.9 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
743f1ee5ebdba51505d2c81e903dcc9f3903cb07ee99b4419daae1a355b75642
|
|
BLAKE2b-256 checksum How to use checksums |
d1ab3ad3c732ffa3ba07d6726021d4d9099c231ca2c108dc57e82fcdddc64cda
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | PyMuPDF-1.20.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 8.8 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
7e95b7c867e4a6a8f2fd85c82cb0dc8fbb536eb1a6e9a9e33c8b3d68642c2782
|
|
BLAKE2b-256 checksum How to use checksums |
b3cfdcfe97d72ba72244cbc1f5ee697535cd17f56ff2d04aa64d9ca1f9c87d4f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp39-cp39-macosx_10_9_x86_64.whl
| Download URL | PyMuPDF-1.20.1-cp39-cp39-macosx_10_9_x86_64.whl |
|---|---|
| Size | 7.7 MB |
| Tags | CPython 3.9 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
8123e6ba98f9ffe525b007a205694e193d0b69c3bd7d1fcc63894d2c80f74ff5
|
|
BLAKE2b-256 checksum How to use checksums |
5d2c2170145ada56ace2a121e9dfa6328e6c41f48bf7dc235b14f66e03a1b0cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp38-cp38-win_amd64.whl
| Download URL | PyMuPDF-1.20.1-cp38-cp38-win_amd64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.8 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
451e2acef3a06fa57872c1024b11f4cc18a5dfee850e690afebd42d6b288eda6
|
|
BLAKE2b-256 checksum How to use checksums |
0413dd7c16640b4336b6bc3b3578f50e80149f238f2ce26f3d46a371acbc10ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp38-cp38-win32.whl
| Download URL | PyMuPDF-1.20.1-cp38-cp38-win32.whl |
|---|---|
| Size | 5.9 MB |
| Tags | CPython 3.8 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
bee2cad5603cefd753f638da17d11509e0723b290f9ed0847ab8485146722404
|
|
BLAKE2b-256 checksum How to use checksums |
fe4e9efe089cf7b593f6fa2302aa100f5b56c10f163719fd68f1a02c2c6cfd90
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | PyMuPDF-1.20.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 8.8 MB |
| Tags | CPython 3.8 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
cab9da6ed5dbfe0c9ee0084330f8683b15d160c00e681e14f60a23a313f34376
|
|
BLAKE2b-256 checksum How to use checksums |
8ea535f653f07e56ba353839db1a73b697fbbf2da0ae728990031fb910b0c02c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | PyMuPDF-1.20.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 8.7 MB |
| Tags | CPython 3.8 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
06f5970f7851a97fbd0b7ea424ba44c150a7f6570a38fb582348098e51627c68
|
|
BLAKE2b-256 checksum How to use checksums |
8df49a3f050b92934df88186db331ed36336270fb3ded5d4f0f2e9f7879c80c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp38-cp38-macosx_10_9_x86_64.whl
| Download URL | PyMuPDF-1.20.1-cp38-cp38-macosx_10_9_x86_64.whl |
|---|---|
| Size | 7.7 MB |
| Tags | CPython 3.8 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
9d1c6da88f9534034b306acc4246215819f2bc1cd4757c08bee26b4a6e8d1104
|
|
BLAKE2b-256 checksum How to use checksums |
1caf1a06820dede9a618809bd8dfeed0e0705f13cad1a20d7b441b06305914b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp37-cp37m-win_amd64.whl
| Download URL | PyMuPDF-1.20.1-cp37-cp37m-win_amd64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.7 CPython 3.7 pymalloc Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0cab37b154c53ba45aa38b13d93410e7260fe067138a9ff7acdfcc4cc6e5ae89
|
|
BLAKE2b-256 checksum How to use checksums |
13960ce6a6aa267706346abca4ca13820b0ef6370764c47b1fc7abd6aae0165e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp37-cp37m-win32.whl
| Download URL | PyMuPDF-1.20.1-cp37-cp37m-win32.whl |
|---|---|
| Size | 5.9 MB |
| Tags | CPython 3.7 CPython 3.7 pymalloc Windows x86-32 |
|
SHA-256 checksum How to use checksums |
37979b53d27bc6618faf246635849bdd96a0452ac324d18830749d7bfa9f05f6
|
|
BLAKE2b-256 checksum How to use checksums |
4d7f70666a733616765cf85ff39dcd94e4b1d85c2426e3535777f579d16e2507
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | PyMuPDF-1.20.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 8.8 MB |
| Tags | CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
134290580f2465ea638c7425cdc68ffd20b9e69b918fb8355e532603f3aad43f
|
|
BLAKE2b-256 checksum How to use checksums |
46ee01aa35eb3a731977459e7b72cbc9eebb6db41dad048a3bc9a09913a96181
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | PyMuPDF-1.20.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 8.7 MB |
| Tags | CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
435d7db1f7b20536ff2208ec53cf805f1bbd8bfb0e3515a494f33493ded61685
|
|
BLAKE2b-256 checksum How to use checksums |
4bce85d14b40c1641cd0b7e799ff0413903db256eea92c92317535d5206655bf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
Release files / PyMuPDF-1.20.1-cp37-cp37m-macosx_10_9_x86_64.whl
| Download URL | PyMuPDF-1.20.1-cp37-cp37m-macosx_10_9_x86_64.whl |
|---|---|
| Size | 7.7 MB |
| Tags | CPython 3.7 CPython 3.7 pymalloc macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
ca39ea635ad16d3ac8c33eec5a37aee4ddb2dc2d86aa199a652fa6114bffe3ff
|
|
BLAKE2b-256 checksum How to use checksums |
f4270fae840f6fb551e08e50f8b0a7a3aa561d6ce60d115cbf24befac3ba34da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.8.12
|
