https://github.com/unixorn/ocr-screenshots-macos

OCR all your screenshots automagically
https://github.com/unixorn/ocr-screenshots-macos

hacktoberfest macos macos-setup ocr ocr-service

Last synced: 6 months ago
JSON representation

OCR all your screenshots automagically

• Host: GitHub
• URL: https://github.com/unixorn/ocr-screenshots-macos
• Owner: unixorn
• License: apache-2.0
• Created: 2021-10-09T22:10:58.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2021-10-17T16:58:30.000Z (about 4 years ago)
• Last Synced: 2025-04-13T05:45:34.737Z (8 months ago)
• Topics: hacktoberfest, macos, macos-setup, ocr, ocr-service
• Language: Ruby
• Homepage:
• Size: 13.7 KB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ocr-screenshots-macos

OCR all screenshots on macOS

## Status

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

![Superlinter](https://github.com/unixorn/ocr-screenshots-macos/actions/workflows/superlinter.yml/badge.svg)

Alexandru Nedelcu wrote a blog post, [Organize and Index Your Screenshots (OCR) on macOS](https://alexn.org/blog/2020/11/11/organize-index-screenshots-ocr-macos.html), showing how to set up automatic OCR for your screen shots.

This repo automates the setup steps detailed in their article so that all you have to do is install [homebrew](https://brew.sh) and then run `make ocr`.

They wrote `screenshots-sync` and did all the hard work, the LICENSE only applies to the `Makefile`.

## Table of Contents

- [Install Instructions](#install-instructions)

- [Details](#details)

## Install Instructions

You must have [homebrew](https://brew.sh) installed to use this `Makefile`.

1. Checkout this repository

2. `make ocr-screenshots`

## Details

When you run `make ocr-screenshots`, `make` will:

1. Create `~/bin`, `~/Dropbox/Screenshots/OCR`, `~/Dropbox/Screenshots/Processing` and `~/Dropbox/Screenshots/Raw` if they don't exist

2. Install tesseract with `brew`

3. Copy `screenshots-sync` to `~/bin`

4. Create a `sync.ocr.plist` file that's aware of your specific directory paths

5. Install the plist.

Per the original [post](https://alexn.org/blog/2020/11/11/organize-index-screenshots-ocr-macos.html), new screen shots will then automatically get written to `~/Dropbox/Screenshots/Processing` and macOS will trigger an OCR run with `screenshots-sync` - processed PDFs with text annotations will be written to `~/Dropbox/Screenshots/OCR`, and the originals will be moved to `~/Dropbox/Screenshots/Raw`.