Find #pymupdf on Discord

Do you have any feedback on this page?

Welcome to PyMuPDF

PyMuPDF is an enhanced Python binding for MuPDF – a lightweight PDF, XPS, and E-book viewer, renderer, and toolkit, which is maintained and developed by Artifex Software, Inc.

PyMuPDF is hosted on GitHub and registered on PyPI.

---

About

• Features Comparison
• Performance
• License and Copyright

User Guide

• Installation
• The Basics
• Tutorial

How to Guide

• Text
  • How to Extract all Document Text
  • How to Extract Key-Value Pairs from a Page
  • How to Extract Text from within a Rectangle
  • How to Extract Text in Natural Reading Order
  • How to Extract Table Content from Documents
  • How to Mark Extracted Text
  • How to Mark Searched Text
  • How to Mark Non-horizontal Text
  • How to Analyze Font Characteristics
  • How to Insert Text
    • How to Write Text Lines
    • How to Fill a Text Box
    • How to Use Non-Standard Encoding
• Images
  • How to Make Images from Document Pages
  • How to Increase Image Resolution
  • How to Create Partial Pixmaps (Clips)
  • How to Zoom a Clip to a GUI Window
  • How to Create or Suppress Annotation Images
  • How to Extract Images: Non-PDF Documents
  • How to Extract Images: PDF Documents
  • How to Handle Image Masks
  • How to Make one PDF of all your Pictures (or Files)
  • How to Create Vector Images
  • How to Convert Images
  • How to Use Pixmaps: Gluing Images
  • How to Use Pixmaps: Making a Fractal
  • How to Interface with NumPy
  • How to Add Images to a PDF Page
  • How to Use Pixmaps: Checking Text Visibility
• Annotations
  • How to Add and Modify Annotations
  • How to Use FreeText
  • Using Buttons and JavaScript
  • How to Use Ink Annotations
• Drawing and Graphics
  • How to Extract Drawings
• Stories
  • How to Add a Line of Text with Some Formatting
  • How to use Images
  • How to Read External HTML and CSS for a Story
  • How to Output Database Content with Story Templates
  • How to Integrate with Existing PDFs
  • How to Make Multi-Columned Layouts and Access Fonts from Package pymupdf-fonts
  • How to Make a Layout which Wraps Around a Predefined “no go area” Layout
  • How to Output an HTML Table
  • How to Create a Simple Grid Layout
  • How to Generate a Table of Contents
  • How to Display a List from JSON Data
  • Using the Alternative Story.write*() functions
    • How to do Basic Layout with Story.write()
    • How to do Iterative Layout for a Table of Contents with Story.write_stabilized()
    • How to do Iterative Layout and Create PDF Links with Story.write_stabilized_links()
• Journalling
  • Example Session 1
  • Example Session 2
• Multiprocessing
• Optional Content Support
  • Introduction: The Optional Content Concept
  • PyMuPDF Support for PDF Optional Content
  • How to Add Optional Content
  • How to Define Complex Optional Content Conditions
• Low-Level Interfaces
  • How to Iterate through the xref Table
  • How to Handle Object Streams
  • How to Handle Page Contents
  • How to Access the PDF Catalog
  • How to Access the PDF File Trailer
  • How to Access XML Metadata
  • How to Extend PDF Metadata
  • How to Read and Update PDF Objects
• Common Issues and their Solutions
  • How To Dynamically Clean Up Corrupt PDFs
  • How to Convert Any Document to PDF
  • How to Deal with Messages Issued by MuPDF
  • Changing Annotations: Unexpected Behaviour
    • Problem
    • Cause
    • Solutions
  • Misplaced Item Insertions on PDF Pages
    • Problem
    • Cause
    • Solutions
  • Missing or Unreadable Extracted Text
    • Problem: no text is extracted
    • Cause
    • Solution
    • Problem: unreadable text
    • Cause
    • Solution

API Reference

• Module fitz
  • Invocation
  • Cleaning and Copying
  • Extracting Fonts and Images
  • Joining PDF Documents
  • Low Level Information
  • Embedded Files Commands
  • Text Extraction
• Classes
  • Annot
  • Archive
  • Colorspace
  • DisplayList
  • Document
  • DocumentWriter
  • Font
  • Identity
  • IRect
  • Link
  • linkDest
  • Matrix
  • Outline
  • Page
  • Pixmap
  • Point
  • Quad
  • Rect
  • Shape
  • Story
  • TextPage
  • TextWriter
  • Tools
  • Widget
  • Xml
• Operator Algebra for Geometry Objects
  • General Remarks
  • Unary Operations
  • Binary Operations
  • Some Examples
• Low Level Functions and Classes
  • Functions
  • Device
  • Working together: DisplayList and TextPage
• Glossary
  • matrix_like
  • rect_like
  • irect_like
  • point_like
  • quad_like
  • inheritable
  • MediaBox
  • CropBox
  • catalog
  • trailer
  • contents
  • resources
  • dictionary
  • page
  • pagetree
  • object
  • stream
  • unitvector
  • xref
  • resolution
  • OCPD
  • OCCD
  • OCG
  • OCMD
  • ligature
• Constants and Enumerations
  • Constants
  • Document Permissions
  • PDF encryption method codes
  • Font File Extensions
  • Text Alignment
  • Text Extraction Flags
  • Link Destination Kinds
  • Link Destination Flags
  • Annotation Related Constants
  • Widget Constants
  • PDF Standard Blend Modes
  • Stamp Annotation Icons
• Color Database
  • Function getColor()
  • Printing the Color Database

Other

• Appendix 1: Details on Text Extraction
  • General structure of a TextPage
  • Plain Text
  • BLOCKS
  • WORDS
  • HTML
  • Controlling Quality of HTML Output
  • DICT (or JSON)
  • RAWDICT (or RAWJSON)
  • XML
  • XHTML
  • Text Extraction Flags Defaults
  • Performance
• Appendix 2: Considerations on Embedded Files
  • General
  • MuPDF Support
  • PyMuPDF Support
• Appendix 3: Assorted Technical Information
  • Image Transformation Matrix
  • PDF Base 14 Fonts
  • Adobe PDF References
  • Using Python Sequences as Arguments in PyMuPDF
  • Ensuring Consistency of Important Objects in PyMuPDF
  • Design of Method Page.show_pdf_page()
  • Redirecting Error and Warning Messages
• Appendix 4: Performance Comparison Methodology
  • Files used
  • Tools used
  • Copying / Joining / Merging
  • Text Extraction
  • Page Rendering
• Change Log
• Deprecated Names

Find out about PyMuPDF Utilities

The GitHub repository PyMuPDF-Utilities contains a full range of examples, demonstrations and use cases.

Do you have any feedback on this page?

---

This software is provided AS-IS with no warranty, either express or implied. This software is distributed under license and may not be copied, modified or distributed except as expressly authorized under the terms of that license. Refer to licensing information at artifex.com or contact Artifex Software Inc., 39 Mesa Street, Suite 108A, San Francisco CA 94129, United States for further information.