ocrmypdf/OCRmyPDF

View on GitHub

OCRmyPDF adds an OCR text layer to scanned PDF files, allowing them to be searched

Stars: 34.8k
Forks: 2.4k
Open beginner issues: 0
Indexed issues: 88
Avg merge: 5d 8h
Merged PRs (30d): 7

Dominant language: Python
License: MPL-2.0
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: help wanted

Beginner friendly Everything

Open All

88 open issues indexed

Python 3.15 support: blocked on pydantic-core wheels Open

dependencies third party issue

Difficulty 2/5 1-3 hours Newbie friendliness 65/100

ocrmypdf/OCRmyPDF#1746 · Opened Sep 14, 2026
Feature request: emit deskew transform parameters as a JSON sidecar (--deskew-transform) Open

Difficulty 4/5 3-5 days Newbie friendliness 52/100

ocrmypdf/OCRmyPDF#1737 · Opened Aug 27, 2026
Deskew without ocr – feature regression or doc problem Open

Difficulty 3/5 1-2 days Newbie friendliness 66/100

ocrmypdf/OCRmyPDF#1735 · Opened Aug 23, 2026
[Feature]: standard plugin prefix Open

enhancement triage

ocrmypdf/OCRmyPDF#1718 · 1 assignee · Opened Jul 18, 2026
[Feature]: integration of kraken as alternative to tesseract Open

enhancement triage

ocrmypdf/OCRmyPDF#1712 · 1 assignee · Opened Jul 10, 2026
[Feature]: Option to force grayscale output (contrast-preserving decolorization) Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

ocrmypdf/OCRmyPDF#1699 · Opened Jun 11, 2026
[Feature]: Option to downsample output image resolution (DPI) Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

ocrmypdf/OCRmyPDF#1698 · Opened Jun 11, 2026
Roadmap / wish list: consolidated feature requests and current positions Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

ocrmypdf/OCRmyPDF#1696 · 1 comment · Opened Jun 9, 2026
[Bug]: Output larger than input Open

ocrmypdf/OCRmyPDF#1620 · 1 comment · 1 assignee · Opened Jan 30, 2026
[Feature]: and support PaddlePaddle OCR in the backend Open

enhancement

ocrmypdf/OCRmyPDF#1584 · 8 comments · 10 reactions · 1 assignee · Opened Oct 18, 2025
[Bug]: long hang between finishing writing the output file and cleaning up temp directory / exiting Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

ocrmypdf/OCRmyPDF#1570 · 3 comments · Opened Sep 11, 2025
[Feature]: hide warning for "lots of diacritics" when scanning languages like 'spa' or 'fra' Open

enhancement

ocrmypdf/OCRmyPDF#1556 · 1 comment · 1 reaction · 1 assignee · Opened Aug 6, 2025
[Bug]: OCRmyPDF Crashes on Files Pre-Processed in K2pdfopt Open

triage

ocrmypdf/OCRmyPDF#1545 · 2 comments · 1 assignee · Opened Jul 8, 2025
[Bug]: Page not rotating with --rotate-pages (inconsistent results) Open

triage

ocrmypdf/OCRmyPDF#1501 · 1 comment · 1 assignee · Opened Mar 28, 2025
[3rdparty]: Paperless-ngx fails on consuming a file Open

ocrmypdf/OCRmyPDF#1495 · 7 comments · 3 reactions · 1 assignee · Opened Mar 17, 2025
The deskew option is not working/having any effect on the output file Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

ocrmypdf/OCRmyPDF#1464 · 3 comments · 1 reaction · Opened Jan 26, 2025
[Bug]: Issue in the paramater/argument in ocrmypdf Open

triage

ocrmypdf/OCRmyPDF#1460 · 1 assignee · Opened Jan 15, 2025
OCR on pages 2+ is only recognized in browsers but not by poppler/etree unless done in two steps Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

ocrmypdf/OCRmyPDF#1459 · Opened Jan 14, 2025
[Feature]: Aggressive image optimization without color quantization Open

enhancement

ocrmypdf/OCRmyPDF#1447 · 1 comment · 1 assignee · Opened Dec 11, 2024
[Bug]: deskew results in "empty" output file Open

bug

ocrmypdf/OCRmyPDF#1438 · 3 comments · 1 assignee · Opened Nov 29, 2024
[Bug]: test_malformed_docinfo fails with spectacular INTERNALERROR Open

third party issue

ocrmypdf/OCRmyPDF#1423 · 3 comments · 1 assignee · Opened Nov 6, 2024
[Bug]: Highlights/annotations repeated on all pages Open

triage

ocrmypdf/OCRmyPDF#1399 · 1 assignee · Opened Sep 24, 2024
[Bug]: Large file size increases due to PDF/A font substitution Open

bug

ocrmypdf/OCRmyPDF#1369 · 9 comments · 1 assignee · Opened Aug 3, 2024
[Bug]: Output PDF is too large Open

triage

ocrmypdf/OCRmyPDF#1366 · 1 reaction · 1 assignee · Opened Aug 2, 2024
[Bug]: NotImplementedError: not sure how to get colorspace Open

bug

ocrmypdf/OCRmyPDF#1315 · 2 comments · 1 assignee · Opened May 19, 2024
Show progress during postprocessing Open

enhancement

ocrmypdf/OCRmyPDF#1313 · 6 comments · 1 assignee · Opened May 16, 2024
[Feature]: Change demo format to VHS Open

enhancement

ocrmypdf/OCRmyPDF#1299 · 1 assignee · Opened Apr 25, 2024
[Bug]: real text replaced by � � (visually unchanged, only by copying) Open

bug

ocrmypdf/OCRmyPDF#1297 · 1 comment · 2 reactions · 1 assignee · Opened Apr 24, 2024
[Feature]: Choose between NFKC and NFC normalization for Unicode characters so copy-pasting works Open

enhancement

ocrmypdf/OCRmyPDF#1282 · 5 comments · 1 assignee · Opened Mar 24, 2024
[Bug]: The file size increases significantly by OCR even without image recompression Open

bug

ocrmypdf/OCRmyPDF#1278 · 2 comments · 1 reaction · 1 assignee · Opened Mar 17, 2024
[Bug]: OCRmyPDF Docker Hot Folder Option OCR_ON_SUCCESS_ARCHIVE OCR_ON_SUCCESS_DELETE doesnt work Open

bug

ocrmypdf/OCRmyPDF#1263 · 1 assignee · Opened Feb 27, 2024
[Bug]: OCR on .pdf isn't the same as tesseract but the format is correct on .txt file Open

bug

ocrmypdf/OCRmyPDF#1244 · 1 assignee · Opened Feb 3, 2024
[Bug]: OCRmyPDF does not preserve existing XMP metadata Open

bug

ocrmypdf/OCRmyPDF#1220 · 3 comments · 1 reaction · 1 assignee · Opened Dec 27, 2023
[Bug]: --version gives 0.0.0 on Ubuntu snap Open

bug snapcraft

ocrmypdf/OCRmyPDF#1176 · 5 comments · 1 reaction · 1 assignee · Opened Oct 21, 2023
[Bug]: Some PDFs are blank in macOS Safari and Preview Open

bug third party issue

ocrmypdf/OCRmyPDF#1164 · 2 comments · 1 assignee · Opened Oct 10, 2023
Add custom deskew and page rotation logic before OCR Open

ocrmypdf/OCRmyPDF#1161 · 8 comments · 1 assignee · Opened Oct 4, 2023
Complete train wreck of a PDF, trying to OCR rotated. Open

bug

ocrmypdf/OCRmyPDF#1137 · 1 comment · 1 assignee · Opened Aug 15, 2023
Support for PDF-A/4 Open

enhancement third party issue

Difficulty 5/5 Over a week Newbie friendliness 25/100

ocrmypdf/OCRmyPDF#1106 · 1 comment · 2 reactions · Opened May 29, 2023
Snap package shouldn't ship all of the Tesseract OCR language files Open

help wanted

Difficulty 4/5 3-5 days Newbie friendliness 35/100

ocrmypdf/OCRmyPDF#1090 · 1 comment · Opened Apr 1, 2023
Only generate text files without generating PDF files Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

ocrmypdf/OCRmyPDF#1086 · 12 comments · 4 reactions · Opened Mar 25, 2023
Correct way to deskew PDF already processed by OCRmyPDF? Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

ocrmypdf/OCRmyPDF#1081 · 7 comments · Opened Mar 18, 2023
Optimize images with SMask Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

ocrmypdf/OCRmyPDF#1073 · 3 comments · Opened Feb 24, 2023
[BUG] ValueError: invalid arguments: (pikepdf._qpdf._ObjectList([]),) Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

ocrmypdf/OCRmyPDF#1054 · Opened Jan 10, 2023
Draw/Blanking on wrong spot Open

Difficulty 4/5 3-5 days Newbie friendliness 15/100

ocrmypdf/OCRmyPDF#1038 · 1 comment · Opened Nov 24, 2022
--redo-ocr does all the work but doesn't save the new OCR text layer in the output pdf, leaving the old OCR text Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

ocrmypdf/OCRmyPDF#1036 · 1 comment · Opened Nov 21, 2022
Garbled order of OCR'ed contents Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

ocrmypdf/OCRmyPDF#1035 · 6 comments · Opened Nov 16, 2022
Remove blank page without recognizable characters of the ocr Open

Difficulty 4/5 3-5 days Newbie friendliness 30/100

ocrmypdf/OCRmyPDF#1032 · 1 reaction · Opened Nov 12, 2022
Issue packaging with pyinstaller Open

Difficulty 4/5 3-5 days Newbie friendliness 30/100

ocrmypdf/OCRmyPDF#1024 · 5 comments · Opened Oct 4, 2022
Inverted black and white from optimization Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

ocrmypdf/OCRmyPDF#1015 · 9 comments · Opened Sep 18, 2022
Refactor code that tramples previous variable assignment (was: possible bug) Open

robustness

Difficulty 3/5 1-2 days Newbie friendliness 35/100

ocrmypdf/OCRmyPDF#997 · 1 comment · Opened Jul 18, 2022

ocrmypdf/OCRmyPDF

Get new issues in your inbox