🔪 PDF Reaper: Artisan Edition Table of Contents ✨ Overview

🚀 Features

💻 Installation & Setup

Prerequisites (Poppler)

Python Setup

⚙️ Usage

⚠️ Known Limitations

✨ Overview The PDF Reaper: Artisan Edition is an elegant and powerful desktop application built with CustomTkinter and Python. It provides surgical precision for PDF management, allowing users to extract specific page ranges and instantly convert them into either a new PDF document or high-quality image files (JPG/PNG).

Key Technologies GUI CustomTkinter (Modern UI) PDF Manipulation pypdf Image Conversion pdf2image (Requires Poppler) Concurrency Python Threading (Responsive UI)

Export to Sheets 🚀 Features Surgical Extraction: Define complex page ranges (e.g., 1-5, 8, 12-15).

Format Conversion: Output extracted pages as a new PDF, or as individual JPG or PNG images.

Artisan Quality: High-DPI (300 DPI) output for excellent image quality.

Responsive UI: Progress bar and status updates keep the application responsive during heavy processing.

💻 Installation & Setup Prerequisites (Poppler) ⚠️ CRITICAL STEP: For PDF-to-Image conversion (JPG/PNG) to work, you must install the Poppler PDF rendering utility and add its binaries to your system's PATH.

OS Installation Hint PATH Configuration Windows Download Poppler binaries, extract, and manually add the \bin folder to your system PATH. macOS Use Homebrew: brew install poppler Linux (Ubuntu/Debian) Use apt: sudo apt-get install poppler-utils

Export to Sheets Python Setup Clone the repository:

Bash

git clone https://github.com/Harsha754-ml/PdfReaper.git cd PdfReaper Install Python dependencies:

Bash

pip install customtkinter pypdf Pillow pdf2image ⚙️ Usage Run the application:

Bash

python pdf_artisan.py Select PDF: Click "📁 Choose File" to load the source PDF.

Specify Range: Enter the desired pages in the text field (e.g., 1, 4-6, 10). Pages are 1-indexed.

Choose Output: Select the output format: .pdf, .jpg, or .png.

Execute: Click the "🔪 EXECUTE REAP" button and select the save location.

⚠️ Known Limitations Poppler Dependency: Image conversion will fail if Poppler is not correctly installed and configured in the system PATH.

Encrypted Files: Password-protected or heavily encrypted PDFs may not be readable by the application.