Skip to content
Projects

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.

How these counts are measured

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 Tools

README.md

Original

📄 PDF Enhancer

Transform Scanned PDFs into Professional-Quality Documents

Last Commit Top Language License: MIT

Built with:

Python OpenCV CustomTkinter PyMuPDF


🧐 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

  1. Go to the Releases page.
  2. Download the latest PDF_Enhancer_v1.1.exe (or PDF_Enhancer_Windows.exe).
  3. Double-click to run!

🐧 Linux (Fedora, Ubuntu, Arch, etc.)

Option A: Standalone Binary (No Python setup needed)

  1. Go to the Releases page.
  2. Download PDF_Enhancer_Linux_x86_64 (or PDF_Enhancer_Linux_x86_64.tar.gz).
  3. 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

Screenshot 2026-02-13 201217

1769518501744


⚙️ 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

  1. Select Files: Browse or drag & drop one or more PDF/image files.
  2. Adjust Quality: Set your desired Scan Quality (DPI) with the slider (200 DPI recommended).
  3. Preview: Click "👁 Preview First" to inspect the enhanced output before full export.
  4. 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.

Developed by Ahmed Gali