Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

OCRmyPDF

ocrmypdf.readthedocs.io

  • Free plan
  • Windows
  • macOS
  • Linux
  • API
  • Self-hosted

What OCRmyPDF is

OCRmyPDF is free software that adds searchable text to scanned PDF files while aiming to retain the original document. It uses Tesseract to recognize text in page images and creates PDF/A-2b archival files by default, with regular PDF output available as an alternative. Image processing options such as deskew can adjust pages to support visual quality and recognition. When a PDF already has text, processing modes can stop with an error, skip affected pages, redo OCR or apply OCR to every page. OCRmyPDF can be used as a Python library, and plugins can customize processing steps. Documented installation options cover Linux, macOS, Windows, FreeBSD and Docker; Paperless-ngx and Nextcloud OCR are named as integrations. Results depend on scan quality and language selection: handwriting is not recognized, poor scans can yield poor output, and unspecified document languages can reduce results. The project notes that accuracy may trail commercial solutions. Its documentation advises processing only trusted PDFs and warns that its example Docker web service lacks security measures and is not intended for public internet deployment.

Who it suits

OCRmyPDF suits users who want free, self-hosted OCR for scanned PDFs and are comfortable installing software or using it as a Python library. It may also suit teams using the named Paperless-ngx or Nextcloud OCR integrations.

Good to know, and what to watch

  • Free software for searchable scanned PDFs.
  • Defaults to PDF/A-2b archival output.
  • Offers regular PDF output as an option.
  • Can be used as a Python library.
  • Plugins can customize processing steps.
  • Handwriting is not recognized.
  • Poor scans can produce poor results.
  • Accuracy may trail commercial solutions.
  • Example Docker web service is not secured for public internet use.

OCRmyPDF

Free

Free plan

The verdict

OCRmyPDF offers configurable OCR processing for scanned PDFs, with library and plugin options. Scan quality, language selection and security considerations matter, and handwriting is not recognized.

What the maker publishes

API and plugins
OCRmyPDF can be used as a Python library and supports plugins that customize processing steps. source
Commercial use and dependency
The documentation says users should comply with the project and dependency licenses and notes that Ghostscript, which OCRmyPDF requires in some workflows, is AGPLv3 licensed. source
Existing text
Its processing modes can error on existing text, skip such pages, redo OCR, or force OCR across all pages. source
Free plan
Yes source
Handwriting OCR
No source
Image processing
It offers image processing options such as deskew to improve visual quality and OCR accuracy. source
Supported inputs
pdf source
Installations
The documentation provides installation methods for Linux, macOS, Windows, FreeBSD, and Docker. source
Integrations
The documentation identifies Paperless-ngx and Nextcloud OCR as third-party integrations that use OCRmyPDF. source
Language support
Results may be poor when a document contains languages not specified in the language argument. source
Maintainer
The project metadata names James R. Barlow as an author. source
OCR accuracy
The documentation notes that OCR accuracy may trail commercial solutions, handwriting is not recognized, and poor scans can produce poor results. source
OCR engine
It uses Tesseract to recognize text in PDF page images. source
Page time limit
By default, OCRmyPDF allows Tesseract three minutes per page and can skip images above a configured megapixel threshold. source
PDF/A
By default, OCRmyPDF generates PDF/A-2b archival PDFs, and users can select regular PDF output instead. source
Primary platform
desktop source
Purpose
OCRmyPDF adds a searchable text layer to scanned PDF files while preserving the original PDF as much as possible. source
Searchable PDF
Yes source
Security
The project advises using OCRmyPDF only with PDFs users trust and says its Docker web service example has no security measures and is not intended for public internet deployment. source

Checked against the maker's pages on 2 Oct 2026.