ItsSp00ky/pdf_enhancer
ItsSp00ky/pdf_enhancer has 76 GitHub stars and 6 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 07:40 UTC. Last push 2026-08-30.
What you can do
- 🎨 Professional Enhancement: Automatically converts shadowed or gray backgrounds into pure white while maintaining crisp, black text using adaptive Gaussian thresholding.
- 📐 Smart Geometry Correction: Automatically detects document borders, crops excess background, and straightens tilted (skewed) pages via 4-point perspective transform.
- 📁 Drag & Drop + Multi-File Support: Drag and drop files directly into the window. Seamlessly combine multiple PDFs and images (PNG, JPG, TIFF, BMP) into a single unified output PDF.
- 🗜️ Ultra-Compact Output: Saves output using 1-bit CCITT Group 4 fax compression for crisp text with file sizes up to ~20x smaller than standard scans.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Clean, deskew, and enhance photographed or scanned PDFs and images into crisp, high-contrast documents locally.
Developer ToolsREADME.md
Original🧐 Overview
PDF Enhancer is a specialized desktop application designed to rescue low-quality scanned or photographed documents. Using advanced computer vision techniques, it reconstructs clean, high-contrast, and print-ready PDFs.
The tool runs 100% locally on your machine—ensuring complete privacy for your sensitive documents with no internet or server uploads required.
🚀 Quick Start
🪟 Windows
- Go to the Releases page.
- Download the latest
PDF_Enhancer_v1.1.exe(orPDF_Enhancer_Windows.exe). - Double-click to run!
🐧 Linux (Fedora, Ubuntu, Arch, etc.)
Option A: Standalone Binary (No Python setup needed)
- Go to the Releases page.
- Download
PDF_Enhancer_Linux_x86_64(orPDF_Enhancer_Linux_x86_64.tar.gz). - Make it executable and run:
chmod +x PDF_Enhancer_Linux_x86_64 ./PDF_Enhancer_Linux_x86_64
Option B: Automated Linux / Fedora Installer
Clone and run the automated installer (sets up dependencies, app menu shortcut, and icon):
git clone https://github.com/ItsSp00ky/pdf_enhancer.git
cd pdf_enhancer/python_version
./install_linux.sh
Note for Fedora users: If installing manually without the script, install Tkinter via sudo dnf install python3-tkinter.
✨ Key Features
- 🎨 Professional Enhancement: Automatically converts shadowed or gray backgrounds into pure white while maintaining crisp, black text using adaptive Gaussian thresholding.
- 📐 Smart Geometry Correction: Automatically detects document borders, crops excess background, and straightens tilted (skewed) pages via 4-point perspective transform.
- 📁 Drag & Drop + Multi-File Support: Drag and drop files directly into the window. Seamlessly combine multiple PDFs and images (PNG, JPG, TIFF, BMP) into a single unified output PDF.
- 🗜️ Ultra-Compact Output: Saves output using 1-bit CCITT Group 4 fax compression for crisp text with file sizes up to ~20x smaller than standard scans.
- 👁️ Real-time Preview: Dedicated preview window lets you inspect the enhanced result of the first page before processing the full document.
- ⚡ Multi-threaded Engine: Background worker threads keep the UI fluid and responsive with real-time page-by-page progress status.
- 📦 Resolution Control: Adjustable DPI settings (100–400) to balance scan crispness and processing speed.
- 🔒 100% Local & Private: Processes all files entirely offline on your computer.
🖼️ Preview
⚙️ Developer Installation
If you prefer to run from source or build the executable yourself:
Option 1: Using uv (Recommended)
uv is an extremely fast Python package and project manager.
# 1. Clone the repository
git clone https://github.com/ItsSp00ky/pdf_enhancer.git
cd pdf_enhancer/python_version
# 2. Sync dependencies into virtual environment
uv sync
# 3. Run the application
uv run python main.py
# (Optional) Build standalone executable
uv sync --all-groups
uv run pyinstaller main.spec
Option 2: Using conda
# 1. Create and activate environment from environment.yml
conda env create -f environment.yml
conda activate pdf-enhancer
# 2. Run the application
python main.py
Option 3: Using standard pip / venv
# 1. Create and activate a virtual environment
python -m venv .venv
# On Windows:
.venv\Scripts\activate
# On Linux/macOS:
source .venv/bin/activate
# 2. Install dependencies
pip install -r requirements.txt
# 3. Run the application
python main.py
🚀 Usage
- Select Files: Browse or drag & drop one or more PDF/image files.
- Adjust Quality: Set your desired Scan Quality (DPI) with the slider (200 DPI recommended).
- Preview: Click "👁 Preview First" to inspect the enhanced output before full export.
- Convert & Save: Click "💾 Convert & Save" to choose your output PDF filename. The enhanced document will open automatically upon completion.
📜 License
MIT License - Copyright (c) 2025 Ahmed Gali. See the LICENSE file for more details.