SoloPDF

SoloPDF

Free, ad-free, local-first PDF reader & offline document toolkit — where every highlight becomes a plain Markdown file.

🌐 [English](README.md) · [简体中文](README.zh.md) · [日本語](README.ja.md)

Download Latest Release · App Store (macOS & iOS) · What's New in v1.1 · Website · Companion App: SoloMD

⭐ If SoloPDF earns a place on your machine, [star it on GitHub](https://github.com/zhitongblog/solopdf) — it is 100% free, ad-free, MIT-licensed, and stars are how other readers, researchers, and developers find it.

📸 More screenshots (Fillable AcroForms · Dark Mode & Large Spec Outline)

---

Why SoloPDF?

Desktop PDF readers today force an ugly trade-off: bloatware that nags you with ads and cloud upsells (Adobe / Foxit / WPS), barebones browser tabs (Edge / Chrome), or self-hosted web suites like Stirling-PDF that require running Docker + a 1.5 GB JVM just to deskew a scan or redact a contract. Meanwhile, PKM tools lock your highlights inside opaque SQLite databases.

SoloPDF is built on Tauri 2 + Vue 3 + Rust (~24 MB macOS Universal .dmg, native across macOS, Windows x64/ARM64, Linux x64/ARM64, iOS/iPadOS, and Android):

1. Highlights = Plain Markdown (`.annotations.md`). Every highlight, underline, sticky note, freehand sketch, and region screenshot is saved right next to your PDF as a human-readable Markdown file with solopdf:// deep links. Open and edit it in SoloMD, Obsidian, VS Code, or Git — triple-layer anchoring (text fingerprint > page + coordinates) keeps highlights attached even if the PDF is re-exported, and your notes never get overwritten.
2. 20+ Offline PDF Tools in Pure Rust (Strict Copy-Out). Auto-deskew, Sauvola adaptive binarization, 2-up scan split, 17-step batch pipelines, true content-stream redaction, N-up & saddle-stitch booklet imposition, X.509/PKCS#7 signature verification, lossless image extraction, and smart outline generation — zero Docker, zero Java, zero network uploads, and your original PDF is never modified in place.
3. Academic & Legal Superpowers. Drag a box to snip math formulas into LaTeX ($...$ / $$...$$) or tables into Markdown / CSV; aggregate #tags across dozens of papers into a Cross-PDF Topic Digest; export Anki / Obsidian flashcards; or run Visual Pixel Overlay & A↔B Blink Compare to catch subtle contract or CAD revisions in seconds.
4. AI-Native CLI + 56-Tool MCP Server. Drive every reading, retrieval (offline BM25 with [p.N] citations), OCR, comparison, and document operation from your terminal or directly inside Claude Code, Claude Desktop, Cursor, and Windsurf.

---

What's New in v1.1

• Scan Mastery Closed Loop — Auto-Deskew & border cleanup (projection profile variance maximization + bilinear rotation), Sauvola local adaptive binarization ($O(1)$ integral-image windowing that eliminates phone-camera shadows), 2-up scan center-gutter split (supports skipping single-page covers and RTL manga/ancient texts), Single continuous vector page stitch, blank scan ink-ratio detection & removal, and vector PDF letterhead overlay.
• Visual Page Comparison (Overlay & Blink Diff) — Alongside word/character-level text diff, inspect scanned contracts, stamps, and CAD drawings with Red/Cyan pixel anaglyph overlay, 16×16 connected-component change hotspots (`Δ X.XX%`), and 650 ms A ↔ B Blink Compare.
• Math Snip → LaTeX & Cross-PDF `#tag` Topic Digest — Box-select equations on any page to copy inline $...$ or display $$...$$ LaTeX (superscripts/subscripts, stacked fractions, radicals, Greek/calculus symbols). Aggregate .annotations.md across open tabs or an entire literature folder by #tag (#method, #limitation, etc.) into a structured Markdown synthesis ready for SoloMD or Obsidian.
• 17-Step In-Memory Pipeline & Multi-File Batch Queue — Chain up to 17 atomic PDF operations in memory (5 built-in presets: *Scan Cleanup*, *Crisp B&W Scan*, *Confidential Share*, *Handout Print*, *Archive Slim*) and run them across a batch of PDFs in one go, plus Smart Auto-Rename ({year} - {author} - {title}.pdf) and /EmbeddedFiles attachment read/write/strip.

---

Core Capabilities

Reading & Companion Markdown Notes

• Highlight → `.annotations.md`: Highlights, underlines, strikethroughs, squiggly lines, sticky notes, freehand ink, and region screenshots (saved in .annotations.assets/ and referenced via standard Markdown) sync live with your companion .annotations.md file.
• Bi-directional Round-Trip: Import existing PDF annotations left by Acrobat, Apple Preview, PDF Expert, Zotero, or Foxit in one click (undoable, deduplicated, non-destructive). Export companion notes back into a new standard-annotated PDF copy anytime.
• Instant Streaming & CJK-First Search: Cold-starts a 157 MB / 1,048-page PDF in ~1s with constant-memory virtual scrolling. Full-text search normalizes NFKC codepoints (fixing the notorious Kangxi radical mismatch in Skia-exported PDFs).
• Side-by-Side Split & Reading Aids: View two sections of the same PDF or two separate PDFs side-by-side (with optional page-locked sync scroll), smart dark mode (inverts text pages while keeping photo-heavy pages intact), auto-crop margins for two-column papers, column-aware Reading Ruler (L), 2–4× HD Loupe (hold Z), and built-in offline Chinese-English dictionary (CC-CEDICT).
• Multi-Format: PDF · EPUB · MOBI/AZW3 · FB2 (`.fb2`/`.fbz`, auto encoding detection) · TXT · CBZ/CBR comics · DjVu · Multi-page TIFF (CCITT G3/G4 fax, LZW, Deflate, JPEG).

100% Local OCR & Optional BYOK AI

• On-Device OCR (Zero Network): Turn scanned PDFs or camera photos into searchable PDFs (Tesseract-style invisible GlyphLessFont text layer — selectable, searchable, and highlightable without bloating file size) or structured Markdown. Uses Apple Vision on macOS/iOS (zero bundle overhead) and bundled PP-OCRv4 ONNX on Windows/Linux.
• Ask AI (Off by Default, BYOK / Local Ollama): Point SoloPDF at your own http://localhost:11434/v1 (Ollama / LM Studio) or OpenAI-compatible key for streamed Q&A with [p.N] page citations and map-reduce long-document summaries. Explicit endpoint consent before a single byte leaves the app.

Complete Offline Document Toolkit (Copy-Out Only)

• Outlines / Bookmarks: Visual tree editor + 1-click smart outline generator from heading font-size gradients or chapter regexes (Chapter N, 1.1, 第X章).
• Imposition & Prepress: N-up (2/4/6/9/16 pages per sheet, vector /Form XObject), Saddle-stitch Booklet, 2-up Split, Single Continuous Page, Grayscale + scan background whitening, Normalize Page Size (A4/A3/Letter/Legal), and Auto-Crop margins (with symmetric odd/even binding gutters).
• Watermarks, Stamps & Measurement: Tiled/diagonal CJK text & alpha PNG watermarks, Bates numbering (DOC-{n:06}, outside-edge alignment), 8 localized vector stamps + dynamic signer/date stamps, and calibrated scale ruler for distance, perimeter, and polygon area (mm/cm/m/in/pt).
• Security, True Redaction & Digital Signatures: AES-256 open passwords, true content-stream Redaction (strips underlying Tj/TJ operators — impossible to copy-paste underneath — with built-in phone/email/ID/card/IPv4 regex presets), metadata & script Sanitization, AcroForm filling & Flattening, and X.509 / PKCS#7 signature verification & signing.

---

Install

# macOS (Homebrew)

brew install --cask zhitongblog/tap/solopdf

Windows (Scoop)

scoop bucket add zhitongblog https://github.com/zhitongblog/scoop-bucket scoop install solopdf

• macOS (Apple Silicon & Intel Universal): Download SoloPDF_*_universal.dmg from GitHub Releases, run brew install --cask zhitongblog/tap/solopdf, or install from the Mac App Store.
• Windows (x64 & ARM64): Download *-setup.exe or *.msi from GitHub Releases (offline PP-OCRv4 models included), or install via Scoop above.
• Linux (x64 & ARM64): Download *.AppImage or *.deb from GitHub Releases.
• iOS / iPadOS: App Store.
• Android: Download app-universal-release.apk from GitHub Releases.

---

Drive PDFs from Claude Code, Cursor, or Terminal (MCP + CLI)

MCP Server (56 tools: 25 read-only + 31 write-gated)

# Read-only mode (safe inspection, search, BM25 retrieval, math/table snip, visual/text diff):

claude mcp add solopdf -- node /path/to/solopdf/dev-mcp/src/index.mjs

Enable Copy-out document & annotation tools (--allow-write):

claude mcp add solopdf -- node /path/to/solopdf/dev-mcp/src/index.mjs --allow-write

• Read-only tools (25): solopdf_info · solopdf_extract_text · solopdf_search · solopdf_search_library · solopdf_retrieve *(local BM25 chunks with page numbers, zero LLM calls)* · solopdf_read_annotations · solopdf_pdf_annotations · solopdf_page_image