@bobfrankston/pdftools

PDF context menu tools for Windows Explorer. Right-click a PDF to preview its first page and rotate it losslessly.

Features

• Thumbnail preview -- first-page JPEG via Poppler's pdftoppm
• Lossless rotation -- 90/180/270° via pdf-lib (metadata-only, no re-encoding)
• Explorer integration -- registers in HKCU (no admin needed)

Prerequisites

• Node.js 24+
• Poppler (pdftoppm in PATH)
• @bobfrankston/msger for popup window

Install

npm install -g @bobfrankston/pdftools
pdftools --install

Usage

pdftools <file.pdf>      # Show thumbnail + rotation popup
pdftools --install       # Add context menu entry
pdftools --uninstall     # Remove context menu entry

API

import { generateThumbnail, rotatePdf, showPdfToolsDialog } from '@bobfrankston/pdftools';

const thumb = await generateThumbnail('doc.pdf', '/tmp');
await rotatePdf('doc.pdf', 90);