Skip to content

opzozi/simple-vaultpdf

Repository files navigation

Simple VaultPDF

A secure, local-first PDF manipulation Chrome Extension. Edit, merge, split, extract text, and manage PDFs completely offline - no cloud required.

Features

  • Local-First Architecture: All processing happens locally, no cloud dependencies
  • PDF Manipulation:
    • Edit, reorder, rotate, and delete pages
    • Merge multiple PDFs into one
    • Split/extract pages to new PDF
    • Save pages as high-quality images (PNG/JPG)
  • OCR Text Extraction:
    • Extract text from PDF pages using Tesseract.js
    • Multi-language support (English, Hungarian, and more)
    • Export to text file or copy to clipboard
  • Privacy-First: All data stays on your device, no server communication
  • Offline Support: Works completely offline - no internet required

Why This Extension?

Simple VaultPDF was built with privacy and simplicity in mind:

  • 100% Local Processing: All PDF operations happen on your device. Your files never leave your computer.
  • No Cloud Required: Works completely offline - perfect for sensitive documents.
  • All-in-One Solution: Edit, merge, split, extract text, and convert PDFs - all in one place.
  • Open Source: Transparent, auditable code you can trust.

Unlike cloud-based PDF tools, Simple VaultPDF gives you complete control over your documents with zero privacy concerns.

Installation (For Users)

From Chrome Web Store

  1. Visit the Chrome Web Store
  2. Click "Add to Chrome"
  3. The extension will be installed automatically
  4. Click the extension icon to open Simple VaultPDF

That's it! No Node.js, no npm, no technical setup required. The extension works directly in your browser.

Like this extension? You can help:

  • Donate via PayPal: Support the project
  • Star the repo on GitHub: Help others discover Simple VaultPDF
  • Leave a review on Chrome Web Store: Share your experience and help improve the extension

Development (For Contributors)

If you want to build, modify, or contribute to this project, follow these steps:

Prerequisites

  • Node.js 18+ and npm
  • Chrome/Chromium browser

Setup

  1. Clone the repository:
git clone https://github.com/opzozi/simple-vaultpdf.git
cd simple-vaultpdf
  1. Install dependencies:
npm install
  1. Add icon files to public/:

    • icon-16.png
    • icon-48.png
    • icon-128.png

    Or generate them from a source image:

npm run generate-icons

(Place your source icon as public/icon-source.png first)

  1. Start development server:
npm run dev
  1. Load the extension in Chrome:
    • Open chrome://extensions/
    • Enable "Developer mode"
    • Click "Load unpacked"
    • Select the dist folder generated by Vite

Build for Production

npm run build

The built extension will be in the dist folder.

Project Structure

/src
  /background    - Service Worker
  /offscreen     - Offscreen document for heavy processing
  /popup         - Extension popup UI
  /app           - Full-page vault application
  /features      - Feature modules (PDF, OCR, Editor)
  /lib           - Utilities (PDF, OCR, etc.)

Development

The project uses Vite with HMR support via @crxjs/vite-plugin. Changes to React components will hot-reload in the extension.

Privacy

Simple VaultPDF is designed with privacy as a core principle. All processing happens locally on your device - no data is collected, stored, or transmitted to external servers.

For detailed information, see our Privacy Policy.

License

MIT

About

Secure, local-first PDF editor. Edit, merge, split, OCR text extraction, and manage PDFs offline. No cloud.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors