PDFVault v1.0.6

PDFVault is a self-hosted, offline-first PDF tool designed to be run within your Local Area Network (LAN) or on your personal machine. It provides PDF processing capabilities without needing to upload your sensitive documents to external servers.

This repository contains the LAN-specific version of PDFVault, optimized for local execution.

---

☕ Support / Donate

If you find this project helpful, saves you time, or keeps your company's documents secure, please consider supporting the development!
👉 Donate & Support via Tako.id

---

✨ Features

PDFVault is packed with powerful, enterprise-grade tools that process your files securely.

🛡️ Core Advantages

• Offline First & Privacy Focused: 100% of the processing happens on your local machine or LAN. Documents are NEVER uploaded to an external server. Your data stays yours.
• Auto Cleanup: Temporary files are aggressively and automatically deleted from the server within milliseconds after processing.
• Smart Concurrency Limit: Built-in queue system ensures the server never freezes, even if multiple users process files at the exact same time.

📄 Organize & Edit PDF

• Visual Page Builder: A drag-and-drop interface to easily rearrange, delete, and organize pages.
• Merge PDF: Combine multiple PDFs into a single file with custom ordering.
• Split PDF: Visually select pages to split or extract from a large document.
• Rotate PDF: Fix upside-down pages with a single click.

🔄 Convert FROM PDF

• PDF to Word/PPT/Excel: Convert PDFs back into editable Office documents with high accuracy (powered by LibreOffice).
• PDF to JPG: Extract high-quality images from every page of your PDF (powered by Poppler).
• PDF to PDF/A: Convert your documents into the standard format for long-term archiving.

🔁 Convert TO PDF

• Word/PPT/Excel to PDF: Turn your Office documents into universally readable PDFs.
• Image to PDF: Convert JPG, PNG, and other image formats into a single PDF document.
• HTML to PDF: Capture webpages perfectly into PDF format (powered by Chromium/Puppeteer).

🖼️ Image Tools

• Remove Background: Cleanly remove backgrounds from JPG/PNG images entirely on your local machine (powered by AI, without cloud API).

🔒 Security & Optimization

• Compress PDF: Dramatically reduce the file size of your PDFs without losing quality (powered by Ghostscript).
• Protect PDF: Encrypt your PDFs with strong passwords and restrict permissions (e.g., disable printing or copying).
• Unlock PDF: Remove passwords and security restrictions from PDFs you own (powered by QPDF).

Prerequisites for Host PC

To run this application as a server on your local network, the Host PC requires the following to be installed.

💡 Easiest Way (Using Chocolatey - Recommended): If you have Chocolatey installed, open PowerShell as Administrator and run this one-liner to install everything you need:

choco install nodejs pm2 libreoffice ghostscript qpdf poppler tesseract chromium -y

Alternative Way (Using Winget - Windows 10/11 built-in): Open PowerShell and run:

winget install OpenJS.NodeJS -e
winget install TheDocumentFoundation.LibreOffice -e
winget install ArtifexSoftware.GhostScript -e

1. Node.js (v18 or higher)

   • Installed via script above, or manually from nodejs.org.

2. PM2 (Process Manager)

   • Required if you want to use the background .bat scripts.
   • After installing Node.js, open Terminal/Command Prompt and run:

     npm install -g pm2

3. LibreOffice

   • Required for converting Office files (Word/Excel/PowerPoint) to PDF.
   • Note down the installation path (usually C:\Program Files\LibreOffice\program\soffice.exe) for your .env file.

4. Ghostscript

   • Required for PDF compression and advanced PDF manipulation.
   • Note down the executable path (usually C:\Program Files\gs\gs[version]\bin\gswin64c.exe) for your .env file.

Note: Client PCs accessing the app via browser do not need to install anything.

Detailed LAN Setup

For a complete guide on how to configure the Host PC, setup .env variables, and configure the Windows Firewall so other computers can access it, please read: 👉 Local LAN Setup Guide

Quick Start (Windows)

The easiest way to run the application on Windows is to use the provided batch scripts:

1. Install Dependencies (First time only): Open a terminal in the root directory and install dependencies for both the frontend and backend.

   cd frontend
   npm install
   cd ../backend
   npm install
   cd ..

2. Start the Application: Double-click the start-pdfvault-lan.bat file in the root directory. This will automatically start both the backend server and frontend development server in the background.

3. Access the App: Once started, open your browser and navigate to: http://localhost:5173 (or the port specified by Vite/React).

4. Stop the Application: To stop the running services, double-click the stop-background.bat file.

Manual Setup

If you are not on Windows or prefer to run things manually:

1. Start Backend:

   cd backend
   npm install
   npm run dev

2. Start Frontend:

   cd frontend
   npm install
   npm run dev

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.