ErrLookup › ocrmypdf/OCRmyPDF
ocrmypdf/OCRmyPDF
OCRmyPDF adds an OCR text layer to scanned PDF files, allowing them to be searched · Python · 91 source files
Analyzed at 5074a0b0e1 on 2026-08-27. 52 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| --redo-ocr (or --mode redo) is not currently compatible with | validation | error | ocr, cli-arguments, option-compatibility, ocrmypdf |
| Since you specified `--output-type none`, the output file {s | validation | error | ocr, ocrmypdf, output-configuration, validation |
| Input file is an image, but the resolution (DPI) is not cred | error_code | error | ocr, ocrmypdf, image-metadata, dpi |
| Input file is an image, but has no resolution (DPI) in its m | error_code | error | ocr, ocrmypdf, image-metadata, dpi |
| The input image has an alpha channel. Remove the alpha chann | error_code | error | ocr, ocrmypdf, image-format, alpha-channel |
| Input CMYK image has no ICC profile, not usable | error_code | error | ocr, ocrmypdf, color-management, cmyk, icc-profile |
| This PDF contains dynamic XFA forms created by Adobe LiveCyc | error_code | error | ocr, ocrmypdf, pdf, xfa, forms |
| This PDF has a user fillable form. --redo-ocr (or --mode red | error_code | error | ocr, ocrmypdf, pdf-forms, acroform, option-compatibility |
| page already has text! - aborting (use --force-ocr or --mode | error_code | error | ocr, ocrmypdf, text-layer, processing-mode |
| --remove-background is temporarily not implemented | error_code | error | ocr, ocrmypdf, not-implemented, preprocessing |
| Could not load plugin from {plugin_path} | error_code | error | ocr, ocrmypdf, plugins, import |
| The following languages are for Tesseract's internal use and | validation | error | ocr, ocrmypdf, tesseract, language-codes |
| OCR engine does not have language data for the following req | error_code | error | ocr, ocrmypdf, tesseract, language-data, missing-dependency |
| --sidecar filename needed when output file is stdout. | validation | error | ocr, ocrmypdf, sidecar, stdout, cli-arguments |
| --sidecar filename needed when output file is /dev/null or N | validation | error | ocr, ocrmypdf, sidecar, devnull, cli-arguments |
| --sidecar filename needed when output file is not a path. | validation | error | ocr, ocrmypdf, sidecar, python-api, type-mismatch |
| --sidecar file must be different from the input and output f | validation | error | ocr, ocrmypdf, sidecar, file-paths |
| --clean is required for --unpaper-args | validation | error | ocr, ocrmypdf, unpaper, cli-arguments |
| --rotate-pages is required for --rotate-pages-threshold | validation | error | ocr, ocrmypdf, rotation, cli-arguments |
| --mode strip removes the OCR text layer without rasterizing | validation | error | ocr, ocrmypdf, mode-strip, cli-arguments, option-compatibility |
| Failed to create OcrOptions for hOCR pipeline: {e} | validation | error | ocrmypdf, hocr, options, typeerror, kwargs |
| Failed to create OcrOptions for hOCR to PDF pipeline: {e} | validation | error | ocrmypdf, hocr, options, typeerror |
| A worker process lost access to an input file | error_code | critical | ocrmypdf, sigbus, multiprocessing, disk-full, temp-files |
| Ghostscript {gs_version} contains serious regressions and is | validation | error | ocrmypdf, ghostscript, version-blacklist, dependency |
| Ghostscript 10.0.0 through 10.02.0 (your version: {gs_versio | validation | error | ocrmypdf, ghostscript, skip-text, redo-ocr, version-conflict |
| Invalid color conversion strategy: {options.ghostscript.colo | validation | error | ocrmypdf, ghostscript, color-conversion, validation |
| NullOcrEngine cannot generate PDFs directly. Use --pdf-rende | validation | error | ocrmypdf, null-engine, pdf-renderer, not-implemented |
| The --rasterizer pypdfium option requires the pypdfium2 pack | validation | error | ocrmypdf, pypdfium2, missing-dependency, rasterizer |
| Unsupported raster device: {raster_device} | validation | error | ocrmypdf, pypdfium, raster-device, validation |
| The following languages are for Tesseract's internal use and | validation | error | ocrmypdf, tesseract, language-codes, bad-args |
| Tesseract 5.4.0 is not supported due to regressions in this | validation | error | ocrmypdf, tesseract, version-blacklist, dependency |
| A worker process lost access to an input file | error_code | critical | ocrmypdf, semfree, sigbus, multiprocessing, disk-full |
| Required fallback font not found: {font_path} | error_code | critical | ocrmypdf, fonts, missing-file, packaging |
| Failed to load required fallback font {font_file}: {e} | validation | critical | ocrmypdf, fonts, corrupt-file, font-loading |
| At least one provider is required | validation | error | ocrmypdf, fonts, provider-chain, validation |
| No fallback font available from any provider | error_code | error | ocrmypdf, fonts, fallback-font, provider-chain |
| SystemFontProvider does not provide a fallback font. Use Bui | exception | warning | ocrmypdf, fonts, not-implemented, system-fonts |
| pdfminer could not process page {pageno} (counting from 0). | exception | error | pdf, pdfminer, corrupt-input, page-parsing |
| pdfminer did not find page {pageno} in the input file. | exception | error | pdf, pdfminer, page-range, corrupt-input |
| This OcrEngine does not implement generate_ocr() | exception | info | plugin-api, ocr-engine, not-implemented, extension-point |
| Could not find program '{program}' on the PATH | exception | error | dependency, path, external-tool, installation |
| Ran program '{program}' but it exited with an error: {e.outp | exception | error | dependency, subprocess, external-tool, version-check |
| The program '{program}' did not report its version. Message | exception | error | dependency, version-check, regex-mismatch, external-tool |
| Too many registry keys under {key} | exception | warning | windows, registry, enumeration-limit |
| ocrmypdf.ocr(jpg_quality=...) is deprecated, use jpeg_qualit | console | warning | deprecation, api, rename, jpeg |
| ocrmypdf.ocr(verbose=) is ignored. Use ocrmypdf.configure_lo | console | warning | deprecation, logging, api |
| jbig2_lossy is deprecated and will be ignored. Lossy JBIG2 h | console | warning | deprecation, jbig2, compression, removed-feature |
| jbig2_page_group_size is deprecated and will be ignored. | console | warning | deprecation, jbig2, compression, removed-feature |
| semfree.py is deprecated and will be removed in a future rel | console | warning | deprecation, plugin, semfree, removal |
| Could not get CPU count. Assuming one (1) CPU. Use -j N to s | console | warning | cpu-count, containers, performance, environment |
| PDF graphics stack overflowed spec limit | console | warning | pdf, content-stream, graphics-state, malformed-pdf |
| PDF graphics stack underflowed - PDF may be malformed | console | warning | pdf, content-stream, graphics-state, malformed-pdf |