MUPDF(1)

💖 MUPDF(1) — the girlies' guide to the MuPDF viewer 💖

okay bestie, sit down, hydrate, and let me tell you about mupdf. This is section 1 of the General Commands Manual, so it's a command you run, not a function you call. No cap. 🫶

---

✨ NAME ✨

mupdf — MuPDF is a lightweight PDF viewer written in portable C. That's it, that's the whole vibe: light, portable, C, iconic. 💅

---

🌸 SYNOPSIS 🌸

mupdf [options] file [page-number]

---

🦋 DESCRIPTION 🦋

MuPDF is a document viewer, and she's not picky — she eats PDF, XPS, EPUB, XHTML, CBZ, and a whole bunch of image formats like PNG, JPEG, GIF, and TIFF. Literally a main character who gets along with everyone. 🌈

---

🎀 OPTIONS 🎀

Here's every single flag she supports, no skipping, we don't do that here:

• -b box-name — use the page box you name. Your choices are MediaBox, CropBox, BleedBox, TrimBox, or ArtBox.
• -c profile-filename — set the display ICC profile to the one living in that named file.
• -p password — use this password to open an encrypted PDF file. She tries it as both the user password and the owner password, because she's thorough like that. 👑
• -r resolution — changes the initial zoom level, given as a resolution in dpi. Default is 72.
• -A bits — changes the anti-aliasing quality, given as a number of bits from 0 (off) to 8 (best). Default is 8.
• -B RRGGBB — sets the full-page black tint using hexadecimal color syntax. Default is 303030.
• -C RRGGBB — sets the full-page white tint using hexadecimal color syntax. Default is FFFFF0.
• -H height — page height in points, for EPUB layout.
• -I — invert colors.
• -J — disable JavaScripts in PDF forms.
• -R extraction-options — enable reflow and set the text extraction options.
• -S size — font size in points, for EPUB layout.
• -U CSS-file — user style sheet, for EPUB layout.
• -W width — page width in points, for EPUB layout.
• -X — disable document styles, for EPUB layout.
• -Y factor — set the UI scaling factor.

---

🖱️ MOUSE BEHAVIOR 🖱️

the mouse is giving so much, honestly:

• Left mouse button click — a left click on a hyper link follows the link. In presentation mode it advances to the next page.
• Right mouse button click — in presentation mode, goes back to the previous page.
• Left mouse button drag — pan the page. Panning beyond the bottom or top edge will go to the next or previous page.
• Right mouse button drag — select text in an area. On X11, the selected text can be pasted in another application with a middle click. Press Ctrl+C to copy the selected text to the clipboard. On Windows, the selected text will automatically be copied to the clipboard.
• Scroll wheel — pan page up or down. Does not change page when reaching the bottom or top edge.
• Shift + Scroll wheel — pan page left or right.
• Control + Scroll wheel — zoom in or out.

---

⌨️ KEY BINDINGS ⌨️

📄 Page navigation

• ., pgdn, space — go to the next page.
• ,, pgup, b — go to the previous page.
• 123g — go to page 123.
• g, G — go to the first or last page.
• m — mark current page for snap back. Up to 256 pages can be marked.
• t — go backward one step in mark history.
• T — go forward one step in mark history.
• [0–9]m — save the current page number in the numbered register.
• [0–9]t — go to the page saved in the numbered register.

🔍 Zooming and rotating

• +, - — zoom in or out.
• W, H — zoom page to exactly fit width/height of window.
• Z — zoom page to fit either to width or height of window.
• z — reset zoom level.
• [, ] — rotate page left (counter-clockwise) or right (clockwise).
• w — shrinkwrap window to fit the page.
• f — toggles fullscreen mode.

🫧 Panning

• h, left, j, k, l, right — pan page left, down, up, or right.

🔎 Searching

• /, ? — search for text forwards or backwards.
• n, N — find the next/previous search result.

🌟 Miscellaneous

• F1 — show key bindings help.
• Escape — stop searching and/or remove focus from annotation/widget.
• <, > — increase/decrease EPUB/XHTML font size.
• r — reload file.
• p — toggle presentation mode. (mupdf-x11 only)
• c — toggle between color and grayscale rendering. (mupdf-x11 only)
• C — toggle full-page color tinting.
• I — toggle between normal and inverted color rendering.
• E — toggle ICC color mode.
• e — toggle spot color mode.
• A — set bit of anti-aliasing to use. The default is 8. 0 means no anti-aliasing, 9 means no anti-aliasing, centre-of-pixel rule, 10 means no anti-aliasing, any-part-of-a-pixel rule.
• P — show page number and total number of pages.
• i — show dialog box with information about the opened document.
• B — change used page box. (MediaBox, CropBox, BleedBox, TrimBox, or ArtBox) The active page box is mentioned in the information dialog box.
• o — show/hide document outline panel.
• a — show/hide annotation panel.
• R — show/hide redaction panel.
• u — show/hide undo/redo panel.
• Y — show/hide layers list.
• o — start/stop highlighting links.
• F — start/stop highlighting form widgets.
• `, F12 — show JS console.
• S — save updated document file.
• q — quit.

ngl bestie, o shows up twice in that list and I am simply reporting the lore exactly as the ancestors wrote it. 🙈 Not my job to fix it, my job is to keep every single detail, and every single detail is what you got.

---

🚨 SIGNALS 🚨

• SIGHUP — sending a SIGHUP signal to the mupdf process will also cause the viewed file to be reloaded automatically, for use in e.g. build scripts.

---

👀 SEE ALSO 👀

mutool(1).

---

💜 AUTHOR 💜

MuPDF is Copyright 2006–2026 Artifex Software, Inc.

---

and that's the whole page, bestie — you ate it, you read it, you understood it. ✨ this little masterpiece landed in the world on June 3, 2026, out of the General Commands Manual, section 1, filed under MUPDF(1) — go forth and view some documents. 🎀💖🦋