MuPDF is an open source software framework for viewing and converting PDF, XPS, and E-book documents. There are viewers for various platforms, several command line tools, and a software library for building tools and applications.
For Linux and Windows there are two viewers. One is a very basic viewer using x11 and win32, respectively. It has been supplanted by a newer viewer using OpenGL for rendering, which has more features such as table of contents, unicode search, etc. We keep the old viewers around for older systems where OpenGL is not available.
Android currently has several different viewers with varying degrees of complexity:
- The main app on Google Play. Supports forms and annotations.
- MuPDF viewer
- A slimmed down viewer only variant of the main app.
- MuPDF mini
- A minimal code example of a document viewer.
The iOS viewer is available on the App Store.
Command Line Tools
The command line tools are all gathered into one umbrella command: mutool.
For rendering and converting documents there are three commands available:
- mutool draw
- This is the more customizable tool, but also has a more difficult set of command line options. It is primarily used for rendering a document to image files.
- mutool convert
- This tool is used for converting documents into other formats, and is easier to use.
- mutool trace
- This is a debugging tool used for printing a trace of the graphics device calls on a page.
There are also several tools specifically for working with PDF files:
- mutool show
- A tool for displaying the internal objects in a PDF file.
- mutool extract
- Extract images and embedded font resources.
- mutool clean
- Rewrite PDF file. Used to fix broken files, or to make a PDF file human editable.
- mutool merge
- Merge pages from multiple input files into a new PDF.
- mutool poster
- Divide pages of a PDF into pieces that can be printed and merged into a large poster.
- mutool create
- Create a new PDF file from a text file with graphics commands.
- mutool sign
- List, verify, and sign digital signatures in PDF files.
- mutool info
- Print details about objects on each page in a PDF file.
- mutool pages
- Print details about media box, artbox, etc for each page in a PDF file.
And finally, there is a tool for doing anything you can imagine:
- mutool run
The library is written in portable C.
- How to build the library.
- Coding style.
- Progressive loading.
- List of third party libraries.
- MuPDF API reference manual..
- Changes in the public API between versions.
There is also a Java library, which uses JNI to provide access to the C library. The Java classes provide an interface very similar to that available in the mutool run command line tool. This Java library also powers the Android SDK.
If you want to build an application for Android, you have several options. You can base it off one of the existing viewers, or build a new app using the Java library directly.
We also provide an App Kit for developing mobile apps using MuPDF. You can get started with the sample apps for iOS and Android.
Handy if you would like a top level overview of the technology ecosystem, including notes and links to associated repositories.
We welcome patches from outside contributors. If you want to contribute patches to MuPDF, please review and sign the Artifex Contributor License Agreement.
Artifex Software also has a bug bounty program.