Skip to content
Nolan1971Public

About

A lightweight native Windows PDF reader

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PlainPDF

PlainPDF is a lightweight, read-only PDF reader for Windows 10 22H2 and later. It uses native Win32 controls and PDFium. It supports continuous scrolling, zoom, searching, Unicode text selection across pages, bookmarks, thumbnails, password-protected files, PDF links, recent files, and Windows printing.

Interactive forms and document editing are outside the 1.0 scope. PlainPDF displays existing static widget appearances with ordinary PDF content when PDFium supports them. Text selection and search follow the PDF text layer. An image-only scan has no selectable text.

Install or run

The stable 1.0.0 release includes installers, portable ZIPs and SHA-256 checksums. Download PlainPDF 1.0.0

Use the package built for your architecture. The installer defaults to the current user, adds a Start Menu shortcut, and registers an uninstaller in Windows Apps & features. Its optional Open with entry leaves the existing default PDF reader in place. For portable use, extract the complete ZIP into its own directory and run PlainPDF.exe. Keep pdfium.dll alongside it.

The installers are unsigned. The x86 and x64 packages were exercised on x64 Windows 10. Native ARM64 installation and runtime are experimental and untested. The ARM64 ZIP and installer contain the native ARM64 application and PDFium. NSIS uses an x86 installer stub.

Use

Open a file with Ctrl+O, drag a PDF onto the window, choose File → Recent Files, or start PlainPDF.exe "path to file.pdf". Use the page field or arrow buttons to jump. F4 shows bookmarks and thumbnails. Ctrl+0 fits a page, Ctrl+1 sets 100%, Ctrl+2 fits width, and Ctrl+mouse wheel zooms at the pointer. Ctrl+F opens Find, F3 and Shift+F3 move between hits, and Esc closes Find. Drag across text and press Ctrl+C to copy. Ctrl+P opens the Windows print dialog.

Build from source

Install Visual Studio 2022 with Desktop development with C++, MSVC v143 for x86/x64 and ARM64, and Windows SDK 10.0.26100.0. From the repository root run the following in PowerShell.

.\tools\Get-Pdfium.ps1
.\tools\Build.ps1

Open PlainPDF.sln to build or debug in Visual Studio. The single native application project has Win32, x64, and ARM64 configurations for Debug and Release. The build script puts executables under out/build/<architecture>/<configuration> and logs under out/logs.

Use a local copy of NSIS or acquire the pinned packaging compiler with tools/Get-NSIS.ps1 and a local 7-Zip installation. Run .\tools\Pack.ps1 -Version 1.0.0 to package the Release builds as 1.0.0. The packages and checksums go to ../PlainPDF-Artifacts/1.0.0 by default. Use -Output to choose a different directory.

The application and setup share src/PlainPDF.ico. To regenerate it after editing the drawing, run python .\tools\Make-Icon.py with Pillow installed.

Verify

The tests/ directory contains synthetic fixture generation and Windows UI tests. Use Python 3 and run the following from the repository root.

python -m pip install -r .\tests\requirements.txt
python .\tests\make_fixtures.py --heavy
.\tests\Build-UiDrivers.ps1
python .\tests\acceptance.py .\out\build\x64\Release\PlainPDF.exe --evidence .\out\test\review-x64
python .\tests\lifetime.py .\out\build\x64\Release\PlainPDF.exe --evidence .\out\test\review-lifetime-x64
python .\tests\measure.py .\out\build\x64\Release\PlainPDF.exe --evidence .\out\test\review-measure-x64

Repeat with x86 and separate evidence directories on an x64 Windows test PC. The acceptance harness exercises the real Windows UI and opens a browser tab to a loopback server when testing link confirmation. The heavy fixture is about 122 MiB. The acceptance record covers the results and the separate printer, package, and diagnostics procedures. PlainPDF acceptance record

Some unusual PDF text layers, form types, and very large files have limits. PlainPDF currently opens PDFs under 4 GiB with up to 250,000 pages. A failed open preserves the current PDF.

Licenses

First-party code is MIT licensed. The separate PDFium license and bundled third-party notices accompany each package. See PDFium provenance and updates.

About

A lightweight native Windows PDF reader

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages