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.
Plans
Every plan and priceOCRmyPDF
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.