Skip to content
Projects

GSiesto/PDFLince has 61 GitHub stars and 16 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and +2 in 15 days. Last checked 2026-11-15 20:49 UTC. Last push 2026-10-18.

How these counts are measured

What you can do

  • Compress: Smart compression with adaptive image downscaling (WebWorker-powered).
  • Merge: Combine multiple PDFs into one document.
  • Split: Extract ranges or split every page into separate files.
  • Convert: PDF to Image (JPG, PNG) and Image to PDF.

Measured star growth

in 24h
0
in 7 days
0
in 15 days
+2
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

The privacy-first, client-side PDF toolkit. Compress, Merge, Split, Reorder and Convert PDFs entirely in your browser without server uploads.

Web & Apps

README.md

Original

PDFLince

PDFLince Logo

The Privacy-First Client-Side PDF Toolkit.

Official Website License: MIT Build Status

Language Link
🇬🇧 English pdflince.com/en
🇪🇸 Español pdflince.com
🇫🇷 Français pdflince.com/fr
🇩🇪 Deutsch pdflince.com/de
🇵🇹 Português pdflince.com/pt
🇮🇹 Italiano pdflince.com/it
🇷🇴 Română pdflince.com/ro
🇷🇺 Русский pdflince.com/ru
🇭🇺 Magyar pdflince.com/hu

Why PDFLince?

Most online PDF tools require you to upload your sensitive documents to their cloud servers for processing. This creates privacy risks and compliance issues.

PDFLince is different:

  • Zero Server Uploads: All logic runs in your browser via pdf-lib and Web Workers.
  • Privacy by Design: Ideal for contracts, bank statements, and personal data.
  • Offline Capable: Works even without an internet connection once loaded.
  • No File Size Limits: Bypasses server payload limits since it uses your device's memory.

Features

  • Compress: Smart compression with adaptive image downscaling (WebWorker-powered).
  • Merge: Combine multiple PDFs into one document.
  • Split: Extract ranges or split every page into separate files.
  • Convert: PDF to Image (JPG, PNG) and Image to PDF.
  • Organize: Extract pages, reorder pages, and delete pages visually.
  • Crop: Crop PDF pages manually with visual selection or by specifying precise values
  • Rotate: Rotate selected pages and preview changes in real-time before exporting.
  • Secure: 100% local processing verifiable via Network tab.
  • Multilingual: Native support for 9 languages (English, Spanish, French, German, Portuguese, Italian, Romanian, Russian, Hungarian).

Architecture

Built with a focus on performance and code quality. The key differentiator is the Zero-Server Data Flow:

graph TD
    User["👤 User"] -->|1. Select PDF| UI["💻 Browser UI (Next.js)"]
    UI -->|2. Offload work| Worker["⚙️ Web Worker"]
    
    subgraph Client ["🔒 Client-Side (Your Device)"]
        UI
        Worker
        Engine["📦 PDF-lib / PDF.js"]
        Worker -->|3. Process| Engine
        Engine -->|4. Result| Worker
    end
    
    subgraph Cloud ["☁️ Static Hosting"]
        CDN["AWS CloudFront / S3"]
        CDN -->|0. Load App Code| UI
    end
    
    Worker -->|5. Blob URL| Download["📂 Download File"]
    
    %% Privacy Barrier
    linkStyle 4 stroke:green,stroke-width:2px;
    
    style Client fill:#e6fffa,stroke:#00b894,stroke-width:2px
    style Cloud fill:#dfe6e9,stroke:#636e72,stroke-dasharray: 5 5
  • Framework: Next.js 15 (App Router, Static Export).
  • Core Engine: pdf-lib & PDF.js.
  • Concurrency: Web Workers for non-blocking UI during heavy compression tasks.
  • Styling: Tailwind CSS with a custom design system.
  • Testing: Playwright End-to-End test suite ensuring reliability across all operations.

Local Development

Prerequisites

  • Bun 1.0+

Quick Start

  1. Clone the repository:

    git clone https://github.com/GSiesto/pdflince.git
    cd pdflince
    
  2. Install dependencies:

    bun install
    
  3. Run development server:

    bun run dev
    
  4. Open in browser: Navigate to http://localhost:3000.

Model Context Protocol (MCP) Server

PDFLince includes an official Model Context Protocol (MCP) server that empowers AI assistants, IDEs, and autonomous coding agents to inspect and manipulate local PDF files with 100% privacy and zero cloud uploads.

Compatibility

  • Supported MCP Hosts & IDEs: Claude Desktop, Cursor, Antigravity, Windsurf, VS Code (via Cline, Roo Code, or Continue), Zed, and Open WebUI.
  • Supported Models & Reasoning Engines:
    • Frontier Cloud Models: Claude (Anthropic), Grok (xAI via API in Cline/Open WebUI), GPT-4o (OpenAI), Gemini (Google).
    • Local & Open-Weights Models: Nous Hermes (Hermes 3), DeepSeek (V3 / R1), Llama 3, Qwen, and Mistral running locally on Ollama, LM Studio, or vLLM.
    • Privacy Guarantee: If you run local models like Nous Hermes or DeepSeek for strict data sovereignty, PDFLince ensures your PDF documents never leave your local filesystem.

Available Tools

  • pdflince_inspect: Inspect page count, dimensions, orientation, and document metadata without mutation.
  • pdflince_merge: Combine multiple PDFs with optional blank divider pages and custom metadata.
  • pdflince_split: Split PDFs into chunks based on page count, with optional ZIP archiving.
  • pdflince_extract: Extract specific pages or page ranges (e.g. "1-3, 5").
  • pdflince_reorder: Reorder or drop pages according to a specified sequence.
  • pdflince_rotate: Rotate pages clockwise or counter-clockwise (90°, 180°, 270°).
  • pdflince_crop: Trim margins from page borders (top, bottom, left, right in points).
  • pdflince_compress: Optimize stream structure, downscale embedded images (150/72 DPI), prune annotations, and remove metadata.
  • pdflince_pdf_to_images: Render PDF pages into PNG or JPEG images at configurable DPI (72, 144, 300) and quality, with optional ZIP bundling.
  • pdflince_images_to_pdf: Convert local image files (PNG, JPG, WebP, TIFF) into a formatted PDF document.

Client Configuration

Add PDFLince to your client's MCP configuration:

{
  "mcpServers": {
    "pdflince": {
      "command": "npx",
      "args": ["-y", "pdflince-mcp@latest"]
    }
  }
}

To run locally from the repository:

bun run build:mcp
node ./bin/pdflince-mcp.js

Contributing

Contributions are welcome! Whether it's fixing bugs, improving documentation, or proposing new features.

Please read our Contributing Guidelines and Code of Conduct before getting started.

License

This project is licensed under the MIT License - see the LICENSE file for details.

About the Name

"Lince" means Lynx in Spanish. The Iberian Lynx (Lynx pardinus) is a wild cat species native to the Iberian Peninsula (Spain/Portugal). It was once the most endangered feline species in the world, but conservation efforts are helping its population recover.

Just like the lynx, this tool is fast, sharp, and native to its environment (your browser). 🐱