Skip to main content

A python script to iterate over a list of PDF in a directory and try to guess their language with Tesseract OCR.

Project description

PLD (PDF Language Detector)

PLD is a Python program that analyzes PDF files, extracts images, processes them using Optical Character Recognition (OCR), and detects the dominant language of the text. It provides language detection information in JSON format and calculates the average confidence coefficient for each language.



Install Tesseract OCR and pdftoppm using your package manager. For example, on Ubuntu:

sudo apt install tesseract-ocr tesseract-ocr-all poppler-utils

From PyPi

Install with pip:

python3 -m pip install --user pdf-language-detector

Then run directly from your terminal:

pld --help

From the sources

Clone the PLD repository:

git clone

Install the required Python packages with poetry:

poetry install

Then run inside a virtual env managed by poetry:

poetry run pld --help

From Docker

Install with Docker:

docker pull icij/pld

Then run inside a container:

docker run -it icij/pld pld --help



This command process PDF files and detect the dominant language.

pld detect --help

    --language A list of ISO3 language codes to detect.
    --input-dir: Path to the input directory containing PDF files. Default is the current directory.
    --output-dir (optional): Path to the output directory. Default is 'out' directory in the current directory.
    --max-pages (optional): Maximum number of pages to process per PDF file. Default is 5.
    --resume (optional): Skip PDF files already analyzed.
    --skip-images (optional): Skip the extraction of PDF files a images.
    --skip-ocr (optional): Skip the OCR of images from PDF files.
    --parallel (optional): Number of threads to run in parallel.
    --relative-to (optional): Path to the directory relative to which build the output dir path.


This command print a report from the previously detected language (using the same output dir).

pld report --help

    --output-dir: Path to the output directory. Default is 'out' directory in the current directory.


You can run the test suite (propulsed by pytest) with this command:

make test


Process PDF files in the current directory, detect English and Spanish languages, and save the results in the 'results' directory:

pld --language eng --language spa --input-dir documents --output-dir results

Process PDF files in the 'documents' directory, detect French and Greek languages, and limit the processing to 3 pages per file:

pld --language fra --language ell --input-dir documents --max-pages 3


This project is licensed under the MIT License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pdf_language_detector-0.0.11.tar.gz (9.5 kB view hashes)

Uploaded Source

Built Distribution

pdf_language_detector-0.0.11-py3-none-any.whl (9.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page