Khmer Document Parser v0.3.0

khmerdocparser is a smart, all-in-one command-line tool to extract Khmer text from both PDF and image files.

It intelligently handles PDFs by first attempting a fast, direct text extraction. If that fails (as with a scanned document), it automatically falls back to a powerful OCR engine with image preprocessing to ensure the best possible results.

Features

• Universal Support: Handles both PDF and common image files (.png, .jpg, etc.).
• Smart PDF Parsing: Uses pdfplumber for native PDFs and falls back to Tesseract OCR for scanned PDFs.
• Advanced OCR: Applies image preprocessing (Grayscaling, Binarization, Noise Removal) for high accuracy on scanned documents.
• User-Friendly: Provides progress bars and detailed logging.

Prerequisites

This package requires two crucial external dependencies: Poppler and Tesseract OCR.

1. Tesseract OCR Installation

You must install the Tesseract engine and the Khmer (khm) language pack.

• Windows: Download and run the installer from UB-Mannheim's GitHub. Ensure you select the Khmer language pack during installation. Add Tesseract to your system's PATH.
• macOS: brew install tesseract tesseract-lang
• Linux (Ubuntu/Debian): sudo apt-get install tesseract-ocr tesseract-ocr-khm

2. Poppler Installation

• Windows: Download the latest binary from here, extract it, and add the bin folder to your system's PATH.
• macOS: brew install poppler
• Linux (Ubuntu/Debian): sudo apt-get install poppler-utils

Installation

Once Poppler and Tesseract are installed, you can install or upgrade the package from PyPI:

pip install --upgrade khmerdocparser

Usage

The command is the same for any supported file type.

Extract from a PDF or Image

# Process a PDF
khmerdocparser /path/to/your/document.pdf

# Process an image
khmerdocparser /path/to/your/scanned_image.png

Save Output to a File

This is the recommended way to view Khmer text correctly.

khmerdocparser my_document.pdf -o my_document_text.txt

Specifying Paths Manually (if not in PATH)

khmerdocparser doc.pdf --tesseract_path "C:\Tesseract\tesseract.exe" --poppler_path "C:\Poppler\bin"