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