{"repo":"privatenumber/mac-ocr","free":true,"listed":false,"github":"https://github.com/privatenumber/mac-ocr","clone":"git clone https://github.com/privatenumber/mac-ocr.git","description":"macOS CLI for OCR and searchable PDFs using Apple's Vision framework","language":"Swift","stars":496,"topics":["apple-vision","cli","command-line-tool","image-to-text","macos","nodejs","ocr","pdf","searchable-pdf","swift"],"license":"MIT","category":"media-processing","readme_excerpt":"mac-ocr A macOS command-line tool that reads text from images and PDFs, and creates searchable PDFs. Runs entirely on your Mac with Apple's Vision framework ; nothing is uploaded. [!TIP] Useful for AI agents too: instead of spending vision tokens reading documents, an agent can run mac-ocr locally for free. A skill is bundled so agents know how to use it. Features - Read text from an image: mac-ocr photo.png - Read text from many images: mac-ocr .png - Stream text from a PDF, page by page: mac-ocr scan.pdf --format jsonl - Read document structure on macOS 26+: mac-ocr document receipt.jpg --format json - Turn an image into a searchable PDF: mac-ocr searchable-pdf photo.png → photo.ocr.pdf - Add a selectable text layer to a scanned PDF: mac-ocr searchable-pdf scan.pdf → scan.ocr.pdf Install Or run it without installing: Requirements: macOS 10.15+. The npm package ships a prebuilt universal binary, so no Xcode or Swift toolchain is needed. Recognize text OCR is the default action — you don't need a subcommand: Default output is plain text. Use JSON when you need bounding boxes, confidence, or page metadata: PDF pages stream as they're recognized, so with a large document you see the first page's text right away. Read structured documents document uses macOS 26's structured document recognizer. It returns a convenient transcript plus paragraphs, tables, lists, line geometry, and table-cell ranges as JSON: This command requires macOS 26+. It deliberately does not accept --fast or","default_branch":null,"files":null,"tree":[],"storefront":"/r/privatenumber","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/privatenumber/mac-ocr/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}