Skip to content
pdfcraft-desktopPublic

About

Download pdfcraft - an open-source, clean-room reimplementation of Adobe Acrobat built in pure Rust.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ArtCraft

PdfCraft

The PDF workbench; an open-source, clean-room reimplementation of Adobe Acrobat, rebuilt in pure Rust.
Read, organize, combine, split and secure PDFs in a fast, native app, written in Rust from the ground up.
macOS · Windows · Linux · FreeBSD · the web

License: MIT OR Apache-2.0 Written in Rust Platforms: macOS, Windows, Linux, FreeBSD, web No account, no telemetry


PdfCraft with the PdfCraft Showcase cover page open, the All tools panel on the left and 20 threaded comments on the right
The PdfCraft Showcase, a 13-page specimen PDF, open with the All tools panel and threaded comments.


Highlights

Faithful

Real-world typography: world scripts, vertical Japanese, colour emoji, gradients, soft masks and transparency. All of it renders the way the author intended.

Fearless

Every save appends your changes and leaves the original bytes untouched. Writes are atomic, undo runs deep, and nothing is lost if you close by mistake.

Yours

No account, no telemetry, no cloud. It works offline and opens instantly. The engine, CLI and app are all open source.


Read anything, beautifully

PdfCraft renders PDFs with care for the details that make a page feel right: kerning and ligatures, right-to-left and complex scripts, vertical CJK, colour emoji, shadings, blend modes, soft masks and optional content.

The Scripts of the World page: Arabic, Hebrew, Devanagari, Thai, Greek, Cyrillic, Chinese, Korean, IPA, Armenian, Georgian and Tamil samples, with vertical Japanese in the right margin
Twelve writing systems on one page, plus vertical Japanese, at 125%.

  • Deep zoom stays sharp. Large pages render in tiles, so text stays crisp at any magnification.
  • Built to survive bad files. Every page renders in isolation and damaged documents are repaired. Across the 983-file pdf.js test corpus the result is 0 crashes.
  • Layouts for every task: continuous, single page, two-up, view rotation, full screen and a distraction-free Read mode.
  • Light and dark themes, both designed to be easy on the eyes for long sessions.
Two facing pages in Read mode with the dark theme: the Foreword and the Setting Text chapter with its drop cap and pull quote The dark theme showing the Code and Images chapter, a syntax-coloured listing and a fractal image, with the comments panel open
Two-up Read mode, ready for long reading The dark theme, with the comments panel open

Find it, select it, copy it

Search the whole document as you type, step through matches with ⌘G, and select text that comes out in the right reading order. That holds for columns, right-to-left runs and CJK too.

Navigate long documents

Bookmarks, page thumbnails and the document's own page labels (i, ii, 1, 2…) keep you oriented in long documents.

The find bar showing match 10 of 16 for the word 'type', highlighted in the Expressive Type chapter heading The Bookmarks panel showing the nested outline of the showcase, with page labels such as Cover, i and ii, next to the Scripts of the World page
Find as you type: match 10 of 16 Nested bookmarks with the document's own page labels

Organize pages like cards on a table

Open Organize pages to see every page at once:

  • Select pages: click, ⌘-click or ⇧-click.
  • Change them: rotate, delete, insert blank pages, insert pages from another file, and move them earlier or later.
  • Undo anything: ⌘Z, then save.

The Organize pages grid with the showcase's pages as thumbnails, three of them selected, and the page toolbar above
Organize pages with three pages selected and the page tools in the toolbar above.

Undo that goes the distance. Each change is one step in a history you can walk backwards and forwards. The Edit menu names the step ("Undo Rotate pages"), and undo still works after you save.

Saves you can trust:

  • Incremental: the original bytes stay byte-for-byte intact.
  • Atomic: the file is written to a temporary copy, then swapped in.
  • Verified: independently checked with qpdf.

Unsaved documents carry a dot on their tab, and closing or quitting asks before anything is lost. Changes are autosaved every minute. If PdfCraft ever quits unexpectedly, it offers to recover your work the next time it opens. Encrypted documents stay encrypted on disk.

The Split document dialog over the organize view, set to one page per file and reporting that it creates 13 files from 13 pages
Split document: one page per file makes 13 files.

Open protected documents and respect their rules

PdfCraft implements the PDF standard security handler completely:

  • every revision, from 40-bit RC4 to AES-256;
  • user and owner passwords, including Unicode passwords normalised with SASLprep;
  • crypt filters and attachment-only encryption.

Documents restricted by their author show a clear notice, and PdfCraft honours their permissions. Enter the owner password and the restrictions lift. Edits to encrypted documents are saved encrypted, under the same keys.

The Document Properties dialog on its Description tab, with editable title, author, subject and keywords, and tabs for Security, Fonts and Advanced
Document Properties, Description tab

Document Properties shows:

  • the document's title, author, subject and keywords, which you can edit;
  • the fonts it uses and whether each is embedded;
  • PDF version, page size, tags, fields, layers and attachments;
  • the full security picture: encryption method, which password opened it, and each permission.

Comments, forms, layers and attachments

The Interactive Form page with highlighted text fields, checkboxes, radio buttons, a list and a signature field, and the Fields panel listing all 13 fields and their values The Review and Markup page with highlights, shapes, ink and an APPROVED stamp under a DRAFT watermark, and the Layers panel with Draft watermark and Print-only notes
Forms: every field with its current value, field highlighting, and checkboxes, radio buttons, lists and signatures drawn the way their author designed them. Layers: switch optional content on and off and the page re-renders instantly. Comments appear as threaded conversations, and attachments can be opened or saved.

Every tool, one keystroke away

Press ⌘K to search every tool and command, or browse the All tools catalogue. Tools that are still in development are marked with the milestone that will ship them.

The command palette searching for 'page', listing Page grid, Page labels, Rotate pages, Insert pages, Delete pages, Extract pages and more, each with the tool it belongs to The Welcome to PdfCraft home screen with recommended tools, a recent file, a privacy note, and the full tool catalogue in the side panel
The ⌘K command palette The home screen and the All tools catalogue

Get started

View all releases

Platform Download Run
Windows x64 pdfcraft-x64.7z Run installer → launch pdfcraft-x64.7z
Linux x64 pdfcraft-Linux-x64.run chmod +x → run installer
macOS Apple Silicon pdfcraft-macOS-arm64.dmg Open DMG → drag to Applications

Built for agents, too

Every engine feature is reachable without the GUI, through one table of JSON-Schema-described tools: open, inspect, render pages to PNG, extract and find text, rotate, delete, move and insert pages, edit bookmarks and page labels, add, reply to, restyle and delete comments (highlight a phrase just by naming it), list and fill in form fields, protect with passwords, set metadata, undo and redo, save, combine, extract and split. Three front doors share it:

  • pdfcraft-cli run, for one-off calls and JSON scripts:

    pdfcraft-cli tools                                        # every tool and its JSON Schema
    pdfcraft-cli run text_find doc=1 query=invoice            # key=value; values parse as JSON
    pdfcraft-cli run --script review.json                     # e.g. comment_add {"type": "highlight", "find": "total due"}
    pdfcraft-cli run --script steps.json --root ./work        # several steps in one session

    With --root, every file the script's steps read or write stays in that directory, including the PNG a step saves with "out" (the script itself is read from wherever you name it).

  • An MCP server, for AI agents such as Claude. It is opt-in: PdfCraft never starts it on its own, and it opens no network port. It runs only while an agent launches pdfcraft-cli mcp, talks over stdin/stdout, and stops when the agent disconnects. To enable it, add it to your agent's MCP configuration:

    { "mcpServers": { "pdfcraft": { "command": "pdfcraft-cli", "args": ["mcp", "--root", "/path/to/your/pdfs"] } } }

    --compact shrinks the tool list the agent has to read: tools/list returns about ten core tools plus tool_search and tool_call, which find and run every other tool, so the list costs far fewer tokens. Every tool still works.

    --root confines every file the agent can read or write to one directory. Builds that should not include the server at all can use cargo build -p pdfcraft-cli --no-default-features.

  • The Rust API (pdfcraft_automation::Automation::call), for embedding.

Edits stay in memory, undoable, until doc_save. Saving to the same file appends an incremental update, so the original bytes are preserved, and the write is atomic. Unsaved changes are never discarded silently.

Driving the app itself

Start the desktop app with pdfcraft --control /tmp/pc.json and an agent can see and operate the real interface: the widget tree with labels and positions (from the accessibility tree), clicks, typing, keys, commands, view options and screenshots. This is also off by default. It listens only on loopback, and every connection must present the random token written to that file, which only you can read.

pdfcraft-cli ui --control /tmp/pc.json inspect query=rotate      # find widgets
pdfcraft-cli ui --control /tmp/pc.json click label="Organize pages"
pdfcraft-cli ui --control /tmp/pc.json key key=K modifiers='["command"]'
pdfcraft-cli ui --control /tmp/pc.json command id=comment.square   # pick a tool, then draw:
pdfcraft-cli ui --control /tmp/pc.json drag from='[400,300]' to='[600,420]'
pdfcraft-cli ui --control /tmp/pc.json screenshot --out window.png

How it's built

PdfCraft is a Cargo workspace of focused crates, layered so the core never depends on the UI:

Crate What it does
pdfcraft-filters Every PDF stream filter (Flate, LZW, ASCII85, RunLength, predictors), encode and decode, property-tested
pdfcraft-crypt The standard security handler: RC4, AES-128/256, revisions 2–6, permissions
pdfcraft-cos The PDF object layer: tolerant parsing, repair, copy-on-write edits, incremental and full writing
pdfcraft-organize Page operations, combine / extract / split, bookmarks, page labels, document information
pdfcraft-fonts Font metrics and encodings for generated appearances
pdfcraft-annot Comments: builders and appearance streams for notes, text markup, shapes, ink and text boxes; replies, status, edits
pdfcraft-forms Interactive forms: the field model, filling with regenerated appearances, Clear form
pdfcraft-render Rendering, inspection and text extraction with reading order
pdfcraft-engine The façade every frontend uses: sessions, edits, undo, saving, the tool catalogue
pdfcraft-automation Agent control: the headless tool table, pdfcraft-cli run, and the opt-in MCP server
pdfcraft-ui-egui The desktop and web interface

Quality gates. Every change passes the same automated checks:

  • formatting, and Clippy with warnings as errors;
  • 200+ unit, property and UI tests;
  • crate-layering rules and a WebAssembly build check;
  • an asset-licence audit.

On top of those, two corpus sweeps run over real-world files:

  • Opening and rendering: of the 983 pdf.js test files, 963 open and render cleanly, with 0 crashes.
  • Open, edit and save round trips: 958 succeed.

The output is verified with independent tools: hayro, qpdf and poppler.

PdfCraft is a clean-room implementation. Its behaviour comes from the ISO 32000 specification and black-box observation, never from anyone else's code.


License and credits

PdfCraft is dual-licensed under MIT or Apache-2.0, at your option. Copyright (c) 2026 ArtCraft Team and the PdfCraft contributors. Required notices are in NOTICE.

About

Download pdfcraft - an open-source, clean-room reimplementation of Adobe Acrobat built in pure Rust.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages