Die meisten Werkzeuge, die PDF-Dateien anfassen, wollen eine Anwendung sein. MuPDF gibt sich als Engine: eine C-Bibliothek, eine Reihe von Programmen fuer die Kommandozeile und ein leichter Betrachter. Diese Wahl erklaert sowohl, was es gut kann, als auch, warum die erste Stunde damit sich anders anfuehlt als das Oeffnen eines kommerziellen Lesers.

Mehr Engine als Anwendung

Die offizielle Dokumentation beginnt mit einer Definition: MuPDF ist ein offenes Softwaregeruest zum Ansehen, Umwandeln und Bearbeiten von PDF-, XPS- und E-Book-Dokumenten. Drei Schichten liegen darum herum, naemlich Betrachter fuer die einzelnen Plattformen, eine Gruppe von Werkzeugen fuer die Kommandozeile und eine Bibliothek, auf der andere Werkzeuge und Anwendungen bauen.

Diese Form bestimmt den Umgang. Nach der Installation entsteht keine fertige Oberflaeche wie bei einem kommerziellen Leser; der Alltag besteht aus einem Befehl im Terminal oder einem Aufruf der Schnittstelle aus dem eigenen Programm heraus. Den Betrachter mupdf-gl gibt es, doch seine Absicht ist Lesen, Anmerken und Schwaerzen, nicht eine schoene Satzseite.

Was 1.28.5 gebracht hat

Die aktuelle Fassung ist 1.28.5, am 25. September 2026 mit einem Etikett versehen und zur Linie 1.28 gehoerend.

Markdown kam als Dokumentformat hinzu. Die Kommandozeile gewann mutool audit, das den Aufbau einer PDF-Datei untersucht und einen Bericht erzeugt, nuetzlich bei der Frage, warum eine Datei sich nicht oeffnen laesst. Die Textgewinnung aenderte sich in einer Reihe von Einzelheiten, darunter die Trennung weicher und harter Trennstriche, das Aufloesen von Ligaturen, das Erkennen von Absatzeinzuegen und die Beurteilung falscher Fettschrift. Die Ausgabe von EPUB und HTML bekam vertical-align, Unterstreichung, Durchstreichung und Hervorhebung dazu, ebenso die Pseudoelemente :before und :after. fz_check_document kam ebenfalls: es liest ein Dokument zuerst und repariert wahrscheinliche Aufbaufehler, damit eine Datei nicht mitten in einer Bearbeitung stillschweigend geflickt und die Aenderung mit ihr verloren geht.

Die Schnittstelle der Optionen hat sich ebenfalls geaendert, und decrypt unter den Schreiboptionen gilt nun als abgekuendigt, an seiner Stelle steht encrypt=none.

mutool, neunzehn Unterbefehle

Die Werkzeuge der Kommandozeile sammeln sich hinter einem einzigen Einstieg, den die Dokumentation ein Taschenmesser nennt. Es gibt neunzehn Unterbefehle: draw gibt ein Dokument als Bild aus, convert wechselt das Format, clean schreibt neu und raeumt auf, extract zieht Bilder und Schriften heraus, merge fuehrt Dateien zusammen, pages fuegt Seiten hinzu und entfernt sie, poster zerschneidet eine Seite in Kacheln, recolor bildet Farben ab, sign setzt eine digitale Unterschrift, barcode erzeugt Strichcodes, trim schneidet Raender ab, info berichtet ueber die Datei, show druckt tiefliegende Objekte, run fuehrt ein JavaScript aus, grep sucht Text mit einem regulaeren Ausdruck, trace folgt den Zeichenbefehlen, create baut eine frische PDF-Datei, bake flacht Anmerkungen und Formulare ab, und audit erledigt die Aufbauanalyse.

Im Alltag tragen draw und convert die Hauptlast. Das erste rendert und schreibt Bitmaps, das zweite wechselt das Format und macht aus einem EPUB eine PDF-Datei oder zerlegt eine PDF-Datei in HTML samt Bildern.

Der Betrachter mupdf-gl

Der Hauptbetrachter auf dem Schreibtisch heisst mupdf-gl und oeffnet PDF, XPS, CBZ, EPUB und FB2, dazu die gaengigen Bitmapformate und SVG. Die Liste ist nicht duenn: eine Gliederung in der Seitenleiste, eine vollstaendige Unicode-Suche, das Bearbeiten von Anmerkungen und das Schwaerzen sitzen alle darin.

Einige Argumente der Kommandozeile lohnen sich zu kennen: ein umgekehrter Farbmodus, ein ICC-Profil, ein Faktor fuer die Groesse der Oberflaeche, Seitenbreite und Seitenhoehe samt Schriftgroesse fuer den Satz von EPUB, und ein Schalter, der ein eigenes Stilblatt ueber das des Verlags legt. Wer lange liest, laesst den umgekehrten Modus meist eingeschaltet.

Unter Windows gibt es einen aelteren win32-Betrachter, unter X11 den mupdf-x11, beide einen Schritt hinter mupdf-gl. Fuer macOS sagt die Dokumentation, es lasse sich wie unter Linux uebersetzen, doch ein Standardbetrachter fehlt, weshalb es auf einem Mac vor allem Bibliothek und Kommandozeile ist.

Welche Formate es kennt

Die offizielle Eingabeliste nennt neun Gruppen: PDF, XPS und OpenXPS, EPUB (2.0 ohne DRM, bei 3.0 nur begrenzt), Mobipocket MOBI, FictionBook 2 FB2, Comichefte CBZ und CBT, gaengige Bitmaps wie TIFF, JPEG und PNG, eine begrenzte Teilmenge von SVG und das in 1.28 ergaenzte Markdown.

Die Ausgabe umfasst PDF, reinen Text, HTML, PostScript, PCL5 und PCLM, PWG und CUPS, PNG und SVG. Beide Richtungen sind ordentlich bestueckt.

Schwaerzen und Unterschreiben

Schwaerzen ist hier kein schwarzer Balken ueber der Seite. Es entfernt den Inhalt des gewaehlten Bereichs aus der Datei selbst und behandelt Bildpunkte und Text gemeinsam, sodass ein entferntes Wort spaeter nicht kopiert werden kann. Beim Versand nach aussen und beim Archivieren heikler Unterlagen ist dieser Unterschied eine harte Bedingung.

Digitale Unterschriften laufen ueber mutool sign, das eine anbringt und auch prueft, ob ein Dokument nach dem Unterschreiben noch beruehrt wurde.

Die Seite der Entwickler

Der Kern ist eine C-Bibliothek, und jede Bindung waechst darauf. Python bekommt PyMuPDF, ausgerichtet auf das Herausziehen und Auswerten von Daten; JavaScript und TypeScript bekommen MuPDF.js, das in Node laeuft; C# hat eine passende Huelle. Fuer einen Betrachter im Web verkauft der Hersteller eine eigene Produktlinie unter kommerzieller Lizenz.

Am 19. Oktober 2026 gab PyMuPDF die 2.0 heraus, ueberwiegend eine Reihe von Korrekturen: der Umgang mit Trennstrichen in Auszuegen, die Lage von Kopfzeilenanmerkungen nach dem Drehen einer Seite und einige Rueckfaelle bei Speicher und Ausgabe. Vollstaendige Pakete fuer alle Plattformen erschienen am selben Tag im Paketverzeichnis.

Die Lizenz und zwei Wege

Die offene Seite ist die GNU AGPL. Die Lizenz erlaubt den kostenlosen Einsatz in einem Projekt, haengt aber eine Reihe von Bedingungen an, darunter die Veroeffentlichung des vollstaendigen Quellcodes jedes darauf gebauten Systems. Ein geschlossenes Produkt, das seinen Quellcode nicht zeigen will, muss den anderen Weg nehmen, eine kommerzielle Lizenz, und deren Kauf hebt die Bedingungen der AGPL vollstaendig auf.

Ein weiterer Satz lohnt das Abschreiben: die Software wird so geliefert, wie sie ist, ohne jede Gewaehr und ohne Unterstuetzung. Wer sie in den Produktivbetrieb nimmt, sollte das vorher in die Kosten einrechnen.

Wo es passt und wo nicht

Fuer Stapelarbeit an einem Haufen PDF-Dateien, Text herausziehen, Seiten teilen und zusammenfuehren, als Bild ausgeben, eine Aufbaupruefung laufen lassen, ist die Kommandozeile deutlich wirksamer als eine grafische Oberflaeche, ein Befehl gegen ein Verzeichnis. Fuer Ausgabe oder Auswertung im eigenen Programm ist es eine fertige Engine ganz unten, und die Bindungen reichen weit genug.

Dreht man es um und verlangt einen Leser, der sich per Doppelklick oeffnet und freundlich aussieht, ist es das falsche Werkzeug: der Betrachter neigt zu vollstaendigen Funktionen statt zu feiner Bedienung und feinem Satz, und unter macOS gibt es nicht einmal einen voreingestellten Betrachter.

Der Wert von MuPDF liegt auf der Ebene der Engine: neun Eingabegruppen, neunzehn Unterbefehle, ein Betrachter, der schwaerzen und unterschreiben kann, dazu die doppelte Lizenz aus AGPL und kommerziellen Bedingungen. Es ist keine Lesesoftware fuer gewoehnliche Anwender, sondern ein Satz tiefer Bauteile fuer Menschen, die Dokumente im Stapel verarbeiten oder eigene Werkzeuge bauen wollen.