Skip to content

About

Read, mark up and study PDFs on Windows, macOS and Linux: 35 markup tools with their own menus, page management, PDF tools, OCR, voice notes and an offline assistant that understands six languages. Free and open source, built with Python, Qt 6 (PySide6), PDFium and qpdf.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

Zenith PDF logo

Zenith PDF

Read, mark up and study PDF documents on Windows, macOS and Linux.
Thirty-eight markup tools with a menu each, page management, PDF tools, forms, flashcards, reading aloud,
and an assistant, in fifteen languages. Everything runs on your computer.

On the iPad, a companion app takes handwritten notes in the same PDF format.

Completely free and open source, with no account, no ads and no paid version.
In continuous development: new versions come out often.

Get Zenith PDF from the Microsoft Store   Download the Windows installer   Download for macOS   Download the Linux AppImage   Download the iPad app, to install with Sideloadly or AltStore

Windows 10 and 11, 64-bit  ·  macOS on Apple silicon  ·  Linux x86-64  ·  iPad on iPadOS 26, sideloaded  ·  all releases


Build Windows, macOS, Linux Version 0.7.0 Free and open source In continuous development License GPL-3.0-or-later Python 3.11+ Works offline Languages: EN, IT, FR, ES, DE, PT, NL, PL, CS, TR, RU, UK, ZH, JA, KO


Zenith PDF in the dark theme, with a lecture open: highlights, a pen loop, a callout and notes on the page, the toolbar on frosted glass

A quick tour

Light or dark

Pick a theme, or let Zenith PDF follow the system, and an accent colour of your own. The floating bars are glass, and you choose which. Liquid glass, on Windows, makes each bar one lens of clear glass: the page shows through it sharp and bent, and every icon and number takes its ink from what lies behind it, dark over a bright page and light over the dark canvas, also within one bar. Clear and Balanced are frosted glass, the pages blurred behind them; Solid makes the bars opaque. On every glass the text stays easy to read. A style changes the whole look: Dot in black and white with one red and dot-matrix titles, Neon with glowing edges, Material, with every colour drawn from the accent, or Folio, with white cards and slate tool icons.

The Liquid glass in the dark theme: the toolbar bends the heading and the first line of the page under it, and the page counter and the zoom bar are dark over the page and light past its edge

The same lecture in the light theme

Home

Every file you opened, with a thumbnail, its folder, its pages and when you last read it. Star the ones you need, tag them, pin the folders you use, and start a new document, the Doc Builder or a PDF tool from the cards at the top.

The home page in the light theme: recent files, stars and tags The home page in the dark theme

Settings

Changes apply the moment you make them: theme and accent colour, how clear the glass is, the tools and their locks, navigation, saving, text recognition, help. The search box finds any setting by name, and so does the assistant.

Settings, View and Layout, in the light theme Settings, View and Layout, in the dark theme

Every tool has its own menu

Click the tool that is on, and its menu opens under it: colour, thickness, opacity, line style and ends, fill, pens that thin out when you go fast, ink that turns into clean lines and shapes. The lock keeps a tool on to draw again, or lets it go back to Select after one use. The pin keeps the menu open while you draw.

The pen's menu: basic, pro and calligraphy pens, colours, thickness, opacity and smart ink

Thirty-eight tools, your toolbar

Pens, highlighter, eraser, study tape and a laser pointer; lines, arrows, shapes and clouds; text marks, text boxes, callouts, stamps and redaction; distance, perimeter, area, angle and volume at a drawing's scale; notes, signatures, pictures, links, voice notes and LaTeX equations. Pick the ones you use, drag them where you want them, keep copies of a tool with different styles.

The tool chooser, on the Free-form tools

Ask for anything: Ctrl+K (⌘K on a Mac)

Type what you want to do, in any of the app's fifteen languages, and press Enter. The assistant finds tools, commands, settings, keyboard shortcuts and chapters of the guide, forgives typos, and remembers what you use. It needs no internet and no language model.

The assistant: an Italian question finds Rotate page

Made for studying

Every highlight and underline, with the text under it and your comments, becomes study notes by page or by colour, ready to save as Markdown. Text boxes and notes get a spelling and punctuation check, with the system's own spell checker. Tape hides answers until you peel it back.

Study notes gathered from the highlights of a lecture

Spelling and punctuation check of a text box, each change shown in context

Pages, and only the pages

The page manager reorders, rotates, duplicates, extracts and deletes pages. Reading mode (Ctrl+H) takes the bars, the panels and the tabs away, and brings them back as they were.

The page manager

Reading mode, with tape over the answers and a voice note

In your language

Menus, settings, help and the whole guide in English, Italian, French, Spanish, German, Portuguese, Dutch, Polish, Czech, Turkish, Russian, Ukrainian, Chinese, Japanese or Korean. Zenith PDF speaks the system's language when it knows it; Settings > View & Layout picks another one.

Settings, View and Layout: the list of languages, open

Flashcards, and two versions side by side

The highlights of a lecture become flashcards: the comment asks and the marked words answer, or the words go missing from their sentence. Study them here, or save them for Anki. Compare with another version opens two PDFs side by side, with what was added, removed or changed marked on both and listed beside them.

A flashcard made from a highlight, with its answer hidden Two versions of a lab report side by side, the changes marked on both

New in 0.7.0

  • Zenith PDF for iPad: a separate app, in English, for handwritten notes with Apple Pencil or a finger. Each note is a PDF in the same format as here, so a note written on the iPad opens on the computer with its ink, text boxes and pictures, and a note from the computer opens on the iPad ready to write on. It has subjects and favourites, five papers in white, cream or dark, the system's pens with eraser, lasso and ruler, shapes recognised from strokes, text boxes, pictures and scans, audio recorded with the writing whose replay brings the strokes back as they were written, and a search that reads handwriting. How to install it is under Download and install.
Zenith PDF for iPad: the library, with subjects in the sidebar and each note shown by its first page A lecture note on the iPad: handwriting, a boxed formula, a highlighted line and a picture, with the pens at the bottom

New in 0.6.10

  • Folio, a fifth style in Settings > View & Layout > Style: white cards over the pages, slate tool icons with a pale body, and the tool in use drawn in its own ink, with a short line of it underneath. Large titles take a serif where one is installed.

The Folio style in the light theme: a white toolbar over the page with slate icons, and the pen that is on drawn in purple with a purple line under it

New in 0.6.8

  • Liquid glass, on Windows: a fourth choice in Settings > View & Layout > Glass. Each floating bar is one lens of clear glass, with no frost over the page: the page shows through sharp, bent most at the bar's edges, and each icon and number reads dark over a bright page and light over the dark canvas, also within one bar that crosses a page's edge.
  • Settings > View & Layout fits its window in every style: the four style tiles are narrower.

The toolbar, the page counter and the zoom bar up close, in the Clear glass above and in the Liquid glass below:

The toolbar, the page counter and the zoom bar up close: in the Clear glass the page under them is blurred and the counter turns dark all over; in the Liquid glass the heading and the first line show through sharp and bent, and the icons are dark over the page and light past its edge

New in 0.6

  • Text boxes in Helvetica, Times or Courier, bold, italic or underlined, aligned left, centred or right.
  • Stamps: APPROVED, DRAFT, CONFIDENTIAL and more, or your own words, with who stamped them and when.
  • Proofreading marks on selected text: insert, replace, or mark for redaction.
  • Groups, alignment, even spacing and flipping; a brush that copies one annotation's look, and an eyedropper.
  • Angles and volumes among the measurements; shapes filled with hatching, cross-hatching or dots.
  • A view menu: hide the annotations, a grid or ruled lines over the pages, the PDF's layers, a locked zoom, read only, and touch mode.
  • Word, Excel, PowerPoint, OpenDocument and RTF files open as PDFs, with LibreOffice or Microsoft Office, and so do text, Markdown and web pages.
  • Nine more languages: Dutch, Polish, Czech, Turkish, Russian, Ukrainian, Chinese, Japanese and Korean.

Download and install

Zenith PDF is free to download, use, share and change, on every system: the whole source is here, under the GPL. It is in continuous development, and each version lists its changes on the releases page.

Windows. Install it from the Microsoft Store: signed by Microsoft and kept up to date by the Store. Or download Zenith-PDF-Setup.exe and run it. The installer asks where to put Zenith PDF, whether you want a desktop shortcut and whether it should open your PDF files, then adds it to the Start menu and to Open with. Windows lets no program make itself the default: for that, its Default apps settings open at Zenith PDF, and Set default there finishes it. It uninstalls from Settings > Apps, like any other app. While the installer is not signed yet, SmartScreen may say it protected your PC: choose More info, then Run anyway.

macOS. Open Zenith-PDF-macOS.dmg and drag Zenith PDF onto Applications. The app is not notarized by Apple yet, so the first time macOS won't open it: go to System Settings > Privacy & Security and choose Open Anyway. It is built for Apple silicon (M1 and later). Text recognition uses Vision and spelling the Mac's own spell checker.

Linux. Download Zenith-PDF-Linux-x86_64.AppImage, make it executable and start it:

chmod +x Zenith-PDF-Linux-x86_64.AppImage
./Zenith-PDF-Linux-x86_64.AppImage

AppImages need FUSE 2 (sudo apt install libfuse2, or libfuse2t64 on Ubuntu 24.04). Text recognition uses Tesseract and spelling the Hunspell dictionaries, when they are installed: for Italian on Ubuntu or Debian, sudo apt install tesseract-ocr tesseract-ocr-ita hunspell-it.

iPad. Zenith PDF for iPad needs iPadOS 26 or later and is not on the App Store: each release has an unsigned Zenith-PDF-iPad.ipa, which you sign with your own Apple ID and install from a Windows PC or a Mac with Sideloadly or AltStore Classic (AltStore PAL installs only notarized apps). With Sideloadly (on Windows, first install the iTunes and iCloud it links to, not the Microsoft Store versions): connect the iPad by cable and trust the computer, drag the .ipa onto Sideloadly, enter your Apple ID and press Start. Then, on the iPad, turn on Settings > Privacy & Security > Developer Mode (the iPad restarts) and trust your Apple ID in Settings > General > VPN & Device Management. A free Apple ID signs an app for 7 days and for at most 3 apps at a time: when it runs out, install it again over the old copy with the same Apple ID and your notes stay, or let AltStore Classic renew it over Wi-Fi while AltServer runs on a computer on the same network.

At the first launch the app asks where notes live. Pick a folder in Files, such as iCloud Drive or On My iPad: notes kept inside the app go when the app is deleted. Each note is a PDF, so a folder the computer syncs too (iCloud Drive, OneDrive or any other) opens in Zenith PDF there. When the iPad saves a note made on the computer, two things don't come through whole: a picture or an equation stays on the page but can no longer be moved or edited, and a voice note or an attached file loses its sound or its file.

From source, on any of the three, with Python 3.11 or later:

python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/python -m zenith_pdf [file.pdf ...]

(On Windows the folder is .venv\Scripts instead of .venv/bin.)

Building the downloads. pip install -e ".[build]", then python tools/build.py makes the download of the system it runs on, in dist/release: the installer on Windows (it needs NSIS), the .dmg on macOS, the AppImage on Linux (it needs appimagetool). GitHub Actions builds and tests all three on every change, and publishes them with each new version.

How it's built

Part Built on
Window, widgets, painting Qt 6 through PySide6, the Fusion style with its own style sheet, dark and light
Reading and drawing pages PDFium through pypdfium2, in a pool of processes sharing the file through shared memory
Writing the PDF qpdf through pikepdf: standard annotations with appearance streams, encryption kept
Pictures and compression Pillow
Icons Phosphor through QtAwesome, plus a few drawn by hand
Text recognition Windows.Media.Ocr through the winrt packages; Vision through pyobjc on macOS; Tesseract on Linux
Spelling ISpellChecker on Windows, through ctypes; NSSpellChecker on macOS; Hunspell through pyenchant on Linux
Voice notes waveIn and MCI from winmm on Windows, through ctypes; Qt Multimedia on macOS and Linux
Camera the Windows Camera app; on macOS and Linux a live view through Qt Multimedia
Assistant its own search over the app's names in every language, and a vocabulary in six: no language model, nothing sent anywhere
Languages its own catalogue: every text of the app keyed by its English, one JSON file per language
Reading aloud Qt TextToSpeech, with the system's voices
Search in every PDF SQLite's full-text index (FTS5), kept on the computer
Comparing versions the words of both versions, lined up with Python's difflib
Updates GitHub's releases API; each download checked against the release's SHA256SUMS
Tests pytest on Qt's offscreen platform: 987 tests, run on Windows, macOS and Linux
Downloads PyInstaller, then an NSIS installer, a .dmg or an AppImage (tools/build.py), built by GitHub Actions
iPad app Swift with SwiftUI, PDFKit and PencilKit, in ipad/; tested on an iPad simulator by GitHub Actions, where the desktop's own code reads and edits its notes
src/zenith_pdf/
  core/       PDFium wrapper, coordinate mapping, render queue, PDF tools,
              the equation renderer, ink geometry, audio recording and
              playback, spelling, writing helpers, the assistant's search
              and its vocabulary (no widgets)
  ui/         main window and its windows, page canvas, tools, their menus
              and the tool chooser, side panels, home, settings, guide,
              assistant, tips, audio recorder
  locales/    the texts of the app in fourteen languages besides English, and
              the catalogue of the English ones
tests/        pytest suite; the UI tests run on Qt's offscreen platform
tools/        build.py makes the download of the system it runs on;
              screenshots.py the pictures of this README; make_icon.py the
              icon; shaders.py bakes the two shader packs of the Liquid
              glass under src/zenith_pdf/assets; bench_zoom.py times
              zooming; snapshot.py renders the window to a PNG; i18n.py
              gathers the texts to translate
packaging/    the Windows installer script and the Linux desktop entry
ipad/         the iPad app: its Swift sources, tests, and the scripts its
              workflow runs
.github/      the workflows that test and build on the three systems and
              for the iPad
docs/images/  the pictures of this README

Rendering

Zooming is meant to be sharp at once, not after a second of blur.

  • Pages are cut into 512 px tiles (1024 px above 4x) rendered at the exact screen scale, only where visible. Exact tiles are copied 1:1 onto device pixels, aligned to the physical pixel grid even at 125% or 175% display scaling, so the result is identical to a native rendering.
  • PDFium is not thread-safe, not even across documents, so tiles render in a pool of processes that read the PDF from one shared-memory copy and hand pixels back through shared memory as well. A thread in the app process renders too: it is ready while the processes start. A process that crashes on a malformed PDF is replaced; the app keeps running.
  • Mouse-wheel zoom moves along a fixed ladder of levels. When idle, the view renders the neighbouring levels for the area around the cursor, so a wheel notch finds its tiles already made. Old levels stay cached (LRU, 384 MB).
  • Each tile is rendered with a margin that is then discarded: PDFium truncates glyph origins towards zero, so a letter starting outside the bitmap would land one pixel off and show a seam.

tools/bench_zoom.py measures it. On a 20-thread laptop, with the window at 1400x900 and 175% scaling:

Document First screen sharp Wheel notch sharp Unprepared zoom
21-page datasheet 120 ms 0 ms 110 ms
A1 sheet, 40,000 vector strokes 240 ms 0 ms 150 ms

PDFium renders and extracts text; pikepdf (qpdf) writes the file. The PDF is read into memory once, so the original can be replaced atomically on save. Annotations are immutable values in display space (core/annotations.py); an edit swaps one value for another, which keeps undo trivial. The same geometry feeds the on-screen painter and the PDF appearance streams (core/appearance.py), so a markup looks the same here and in other viewers.

Glass

Qt can't blur what lies behind a widget, so each floating bar samples it (ui/widgets.py, FloatingBar).

  • The pages under the bar and 24 px round it are grabbed, reduced to one texel every 2 logical px, blurred with a gaussian (sigma 6 px, as three box passes) and given back some of the colour a tint takes away. The painter stretches the texels smoothly: lines of text behind melt into an even wash, never strokes to read under the icons.
  • A scroll moves the picture with the pages at once, so it never lags a frame; a fresh sample follows at most once a frame, and at once after a jump past the area sampled. A zoom or newly rendered tiles under a bar resample it too.
  • The tint is worked out column by column: as clear as the glass style allows, rising only where text and icons would read under 4.5:1 (Clear) or 7:1 (Balanced) over plain parts of the page or the canvas, or under 3:1 or 4.5:1 over the worst spot of a busy picture. The faint grain that keeps the glass from banding is counted in.
  • The edge and the line of light along the top are drawn in device pixels, whole pixels wide at every scaling from 100% to 200%.

The Liquid glass (ui/lens.py) draws each bar on the graphics card instead. One device of Qt's rendering interface (QRhi) on Direct3D 11 serves the whole program, off screen. A fragment shader bends the sharp sample of the page by Snell's law across the whole bar, most at its edges, through a rim as wide as half the bar (up to 24 px); each bar's picture is read back and painted clipped to its outline, with the edge and the light on the rim already in it. The device is made from the event loop, never in a paint, since that takes 0.1 to 0.2 s, and it is freed, with its textures, when another glass is chosen. Each icon, label and number takes its ink from what lies behind it alone, so one bar can read dark over a page and light past its edge. Wherever the lens cannot run (before the device is up, or after it fails) the bar is drawn as the Clear glass. For now it runs on Windows only. tools/shaders.py bakes the vertex and fragment shaders into the two packs the app loads.

The pictures in this README are made by tools/screenshots.py: it writes a demo lecture, marks it up with the app's own tools and draws each screen offscreen, so they show no one's files.

License

Zenith PDF is free software: you can redistribute it and modify it under the terms of the GNU General Public License, version 3 or (at your option) any later version. See LICENSE. Copyright (C) 2026 Andrea Loroni.

The libraries it builds on keep their own licences, listed in Settings > About: Qt and PySide6 (LGPL-3.0), PDFium through pypdfium2 (BSD-3-Clause, Apache-2.0), qpdf through pikepdf (Apache-2.0, MPL-2.0), QtAwesome with the Phosphor icons (MIT) and Pillow (MIT-CMU).

About

Read, mark up and study PDFs on Windows, macOS and Linux: 35 markup tools with their own menus, page management, PDF tools, OCR, voice notes and an offline assistant that understands six languages. Free and open source, built with Python, Qt 6 (PySide6), PDFium and qpdf.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

⌂ 换网址