89 comments

[ 6.4 ms ] story [ 189 ms ] thread
Weird, I couldn't get it to work on a bunch of different files, even using very simple file names. Kept getting this error:

Error: The operation couldn’t be completed. (WFBackgroundShortcutRunnerErrorDomain error 1.)

I suppose you haven't renamed the new shortcut to `ocr-text`
Very cool, and seems handy!

I’ve always had good results from the Preview.app. I wonder how this engine compares for number of errors in a difficult source versus Free alternatives.

Yeah preview app is everything. I take screenshots now for deliverables.
Nice post, OP! I was super impressed with the Apple's vision framework. I used it on a personal project involving the OCRing of tens of thousands of spreadsheet screenshots and ingesting them into a postgres database. I tried other OCR CPU methods (since macOS and Nvidia still don't play nice together) such as Tesseract but found the output to be incorrect too often. The vision framework was not only the highest quality output I had seen, but it also used the least amount of compute. It was fairly unstable, but I can chalk that up to user error w/ my implementation.

I used a combination of RHetTbull's vision.py (for the actual implementation) [1] + ocrmac (for experimentation) [2] and was pleasantly surprised by the performance on my i7 6700k hackintosh.

I wouldn't call myself a programmer but I can generally troubleshoot anything if given enough time, but it did cost time.

[1]: https://gist.github.com/RhetTbull/1c34fc07c95733642cffcd1ac5...

[2]: https://github.com/straussmaximilian/ocrmac

It's better than Tesseract? That's really impressive.

Could you run a farm of macOS machines and turn this into an API for profit? Would that be legal?

Yes, as long as you pay for the mac hardware it’s yours to do with as you please. I’m not an attorney and this is not legal advice.
Notably, Apple seems to attach some very unfriendly restrictions to some of the built-in stuff, such as the voices. You can't use those commercially, it appeared to me when I researched it.
In my experience using it constantly, it is far beyond Tesseract’s.

I have never gotten truly garbled output from Apple’s, whereas Tesseract will frequently produce random Unicode characters from text.

Apple’s also handles things like overlapping text or changing font sizes and typefaces far better than any open-source OCR I’ve used.

Way, way better than Tesseract!
IMO it goes head to head with the anazon/google cloud OCR services. It’s works superbly.
Is there a tutorial on how to extract table from pdf or image for Apple Vision Framework. I tried the two links in your post and it just extracts the text without maintaining the table structure.

AWS textract provides sample python code to extract tables into csv which works great.

Tesseract alone is widely known to be "meh" at this point.

If you look at RAG frameworks as one example they'll typically use/support a variety of implementations. Tesseract is almost always supported but it's rarely ideal with projects like Unstructured[0] and DocTR[1] being preferred. By leveraging more-or-less SOTA vision models[2][3] they embarrass Tesseract.

I haven't compared them to the Apple Vision framework but they're absolutely better than Tesseract and potentially even Apple Vision.

There are also various approaches to use these in conjunction but that gets involved.

[0] - https://github.com/Unstructured-IO/unstructured-inference

[1] - https://github.com/mindee/doctr

[2] - https://github.com/mindee/doctr#models-architectures

[3] - https://github.com/Unstructured-IO/unstructured-inference#mo...

I have found Tesseract to be both better than I expect (it feels great when it works most of the time) and worse than I expect (not quite enough correct data to fully rely on).
https://github.com/mindee/doctr/issues/1049

https://github.com/JaidedAI/EasyOCR#whats-coming-next

Happy to see OCR is advancing lately, but I really need HWR.

I am looking for something this polished and reliable for handwriting, does anyone have any pointers? I want to integrate it in a workflow with my eink tablet I take notes on. A few years ago, I tried various models, but they performed poorly (around 80% accuracy) on my handwriting, which I can read almost 90% of the time.

This is maybe not a solution, but how does ChatGPT do on your handwriting if you upload a photo? If that works well then maybe you can use the API?
(comment deleted)
AWS Textract is by far the best OCR engine we've used, it does great with handwritten text
Does anyone know what languages Apple supports? The docs don't have a list. Tesseract might be "meh" but it is probably the best open source option available for devnagari scripts or Persian, for example.
I've used it on a number of Cyrillic languages (Russian, Bulgarian, etc), Hungarian, Turkish, along with the typical ones (Spanish, German, French, Italian, Portuguese). I've heard it supports Chinese. I just tried Persian and devnagari samples on my Mac and it could not do either.
you can use clipboard with pbpaste/pbcopy commands

ocr-text "$1" && pbpaste

It also outputs to the command line if you pipe it to cat

    shortcuts run ocr-text -i new-haven-pizza.jpg | cat
Oddly enough if you enable it as a "quick action", when you run it, Finder creates a file in the same directory as the image containing the OCRed text (and named according to the first line of OCRed text).

I went back into my shortcut and Shortcuts added a pseudo-action "Stop and output <copy to clipboard>; if there's nowhere to output: <Do Nothing>", and I would think that "Do Nothing" would mean don't create a file, but I guess Quick Actions has some kind of special meaning given that all the other ones seem to be intransitive actions, implying that the user wants a file as the output.

I'll throw my solution into the mix: https://skaplanofficial.github.io/PyXA/tutorial/images.html#...

PyXA uses the Vision framework to extract text from one or more images at a time. It's only a small part of the package, so it might be overkill for a one-off operation, but it's an option.

fyi you're using the old and less accurate api, VNRecognizeTextRequest

ImageAnalyzer is newer and much better

I bet this shortcut from OP is also using the older API under the hood

ImageAnalyzer is Swift-only and has no corresponding Objective-C method, so it's not available in PyObJC. I can look into bridging it at some point.
This would probably be pretty easy to do with swift and python processes running side by side with grpc.
To place contents in a file (not claiming this is the most efficient way but it works)

OCRTHISFILE="ocr-test.jpg"

shortcuts run ocr-text -i "${OCRTHISFILE}"

pbpaste > ${OCRTHISFILE}.txt

or to view output and place in file:

OCRTHISFILE="ocr-test.jpg"

shortcuts run ocr-text -i "${OCRTHISFILE}"

pbpaste | tee ${OCRTHISFILE}.txt

Or use MacOS shortcuts to output ocr text as file (Action: "Append to Text File")
Yes took a bit of fiddling but that does work thanks.
Are ios and macos shortcuts crosscompatible? I didnt know there was shortcuts for the mac, seems pretty powerful to be able to run them from the terminal too. Thanks OP
Yes they are compatible as long you use actions available on both platforms. For example, you can use AppleScript or shell in macOS but it will not work on iOS. However, if you use cross platform apps shortcuts it works even when you write files into the iCloud folder. For example, I did a shortcut that takes today’s events from the Calendar and appends the list into a Markdown file in a Obsidian vault on iCloud. I use it to scaffold meeting notes, and it works on my phone too.
I'm a huge fan of this little ocr tool isntalled through brew onto my macbook https://github.com/schappim/macOCR
Same, and for my purposes, I just wrap that utility in a macOS Shortcut I can click from my menu bar, or launch from Quicksilver.
Quicksilver, now there’s a blast from the past! I don’t think I’ve installed it on any Mac in the past 5 years, but I used to love it.

What are the advantages over native macOS shortcuts these days?

Great to hear! Shottr also has nice OCR these days.
I tried doing something similar on Windows, and realized that PowerToys[1], a Microsoft project I already had installed, actually contains a very good OCR tool[2]. Just press Win+Shift+T and select the area to scan, and the text will be copied to the clipboard.

[1] https://learn.microsoft.com/en-us/windows/powertoys/

[2] https://learn.microsoft.com/en-us/windows/powertoys/text-ext...

I use autohotkey + powertoys to append screenshot data to a CSV, works great with it's own key mapping
Surprisingly, the Extract Text from Image action is available on Intel Macs: normally, features like automatic-image-OCR is limited to Apple Silicon Macs.
It's almost as if the constant clucking about "planned obsolescence" and deliberately withholding features is a load of bollocks.
On Windows, A9T9 does a great job of OCR'ing scanned JPEG files (and any JPEG file). It's also free.

I scanned about 100 A4 documents in just a couple of minutes.

Awesome! Is there a similar technique for the Apple vision ‘Copy Subject’ feature? I’ve become extremely reliant on it, but it feels very limited in access.
I had to Google this, do you mean the feature in Photos on mobile where you can "extract" items from a picture and make them into stickers? Apple seems to call it "lifting subjects" [0] [1].

0: https://support.apple.com/guide/iphone/lift-a-subject-from-t...

1: https://developer.apple.com/videos/play/wwdc2023/10176/

EDIT: Try replacing the "Extract text" action with "Remove background". When running the shortcut, use "-o" to specify output image filename.

   shortcuts run remove-background -i ~/Downloads/portrait-beard.avif -o beard.jpg
It doesn't work for Chinese characters :(
macOS Ventura and newer actually have basic OCR functionality integrated into the Image Capture UI. When using an AirPrint-compatible scanner and scanning to PDF, the checkbox "OCR" is shown in the right pane.
Is there any benchmarks on speed/compute/accuracy anywhere comparing to tesseract v5?
Python is quite basic and might not be very helpful for advanced users. It seems overly detailed for such a simple task.
I don't know why but instead of pasting the text it copied to make sure it worked, I made it read it:

shortcuts run ocr-text -i <A PATH TO SOME IMAGE> | say -v Fred

I did notice that many Mac apps, including Safari and Preview and Notes, do OCR on images automatically. It's pretty neat that I can easily select text in an image and copy and paste it somewhere else.
(comment deleted)
It’s kinda ridiculous how good it is, you can even select text from inside a YouTube video while it’s playing (or pause if needed).

Also if it’s text of a URL/domain or a QR code (eg in a photo of a poster, or in a video) you can hold-press/hold-click to open the link directly from the image.

Thanks for sharing this! I had no clue about it.
The photos apps too. It’s just so good at conferences or when you need a long string digitised (iso default router password!). Photo > select > copy > then paste on phone or Mac (via that actually awesome handoff feature).
I have played around with the OCR on my mac, and have been very impressed. It has been consistently better than tesseract for my purposes.

However, when creating a PDF from images using Preview and exporting using ‘Embed Text’ option to OCR, I have noticed the text is worse than if you OCR the exact same images using the shortcut above or using a script. Presumably Preview is using the Vision framework’s less accurate fast path when preparing the PDF. https://developer.apple.com/documentation/vision/recognizing...

I've built an opensource tool that gives you both CLI and a nice UI. It is free.

https://trex.ameba.co

+1000 for Trex!! I use it daily, thank you for creating it!

I am impressed how it handles handwriting and crappy screen grabs.

It's not so well known that one of the original rationales for "offside rule" programming languages is that it works just as easily for handwritten code as it does for typed.

Will we ever have programming languages that are primarily designed to take input from whiteboard grabs? (ie where not only handwriting, but also placement, connectivity, and maybe shape are meaningful?)