Skip to content

Repository files navigation

Simple PDF

License: MIT Python Docker Flask Open Source Self-Hosted Privacy First Release Stars Forks

Website: redmanxp.github.io/SimplePDF-OSS · Support: ko-fi.com/redmanxpdev

The self-hosted document workspace.

Not just a PDF editor — a private workspace for PDFs, images, Outlook emails, Office documents, OCR, and organization, end to end.

📄 PDFs · 🖼 Images · 📧 Outlook (.msg) · 📑 Office · 🔍 OCR · ✂️ Redaction · 🔒 Privacy-first · 🐳 Docker Ready

Open source (MIT). Your files stay on your server — no cloud upload.

Simple PDF — self-hosted document workspace

Simple PDF demo: upload, merge, OCR, save


Features

Area What you get
Import PDF, JPG/PNG, Outlook .msg, Word DOC/DOCX, RTF, ODT, TXT/CSV/LOG/MD
Outlook → PDF .msg with formatting + attachments merged into the queue
Organize Drag & drop, reorder, merge mixed types, page-by-page control
Edit Rotate, delete, crop, redact (white-out), zoom, fullscreen editor
OCR Page or full document, searchable PDF, deskew, configurable language
Optimize Grayscale, blank-page cleanup, edge / border trim
Export Merged PDF, split by ranges, download or browser Save As
Privacy 100% self-hosted; ideal for intranet / regulated teams

Screenshots

Dashboard Merge queue Editor
Dashboard Merge Editor
OCR Settings Document flow
OCR Settings Queue

More on the project website.


Why Simple PDF?

Most tools only touch PDFs. Simple PDF is a document workspace: it covers the flow before the final file — Outlook mail with attachments, Office docs, scans, and images — then merge, clean, OCR, redact, and export in one place.

Built for privacy-first self-hosting (offices, healthcare, accounting, legal, public administration).


Installation

Requirements

  • Docker (recommended), or
  • Python 3.12 + Tesseract (eng / spa as needed) + LibreOffice Writer (for Office uploads)

Configuration

cp .env.example .env
# Optional: PDF_EDITOR_SECRET_KEY, PDF_EDITOR_OCR_LANG=eng, PDF_EDITOR_OCR_MAX_CONCURRENT=1

See docs/INSTALL.md for bare-metal / systemd notes.


Docker

git clone https://github.com/redmanxp/SimplePDF-OSS.git
cd SimplePDF-OSS
cp .env.example .env
docker compose up --build

Open http://localhost:8080

Health: http://localhost:8080/api/health

Dev bind-mounts (live UI/code):

docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build

Roadmap

  • Stronger multi-user auth / reverse-proxy SSO notes
  • PDF.js text selection after OCR
  • Undo; blank / insert page
  • Compression profiles on save
  • Stamps / image signature
  • Excel / PowerPoint → PDF; EML in addition to MSG
  • Concurrent job limits UI / busy-server messaging polish

Discuss ideas in GitHub Discussions.


Contributing

See CONTRIBUTING.md. Bug reports and feature ideas welcome via Issues or Discussions (Ideas / Feature Requests / Q&A / Showcase).


Support

If Simple PDF helps your team, consider supporting development:

ko-fi

ko-fi.com/redmanxpdev · Sponsor button on this repository (Ko-fi)

Your support helps documentation, hosting, and new features.


License

MIT


Docs: Install · Features · Architecture · User manual (EN) · Manual de usuario (ES) · Changelog

Español: README in English on purpose (public / GitHub). Manual: docs/MANUAL_USUARIO.md.

About

Privacy-first, self-hosted document workspace. Merge, edit, OCR, convert and organize PDFs, Office files, Outlook emails and images. Docker ready.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages