A small starter set of macOS Karabiner-triggered tools: screenshot OCR, EN<->ES translation, and a condensed/expanded markup CLI.
| Shortcut (suggested) | Tool | What it does |
|---|---|---|
| Left Shift+Cmd+4 | translate/ |
Selection/screenshot -> translate -> replace or popup |
| Left Shift+Option+4 | lacuna/ |
Screenshot OCR -> expand/collapse/replace markup |
| Left Shift+4 | ocr/ |
Screenshot -> OCR -> clipboard + saved text |
| Left Shift+3 | screenshot-clipboard/ |
Screenshot -> saved image + clipboard |
Each folder is self-contained with its own README. General install pattern:
chmod +x <folder>/<script>
Then add a Karabiner complex modification rule with a shell_command
manipulator pointing at the script's full path (or symlink the scripts
somewhere on your $PATH, e.g. ~/bin).
Requirements: tesseract and jq (brew install tesseract jq); ImageMagick
(brew install imagemagick) is optional and improves OCR accuracy on the
translate path. python3 is used for URL-encoding/whitespace trimming and is
preinstalled on macOS.
A condensed/expanded markup CLI - author text with [surface](extra) and
{expanded}{collapsed} hooks, then flip between the fully written-out and
condensed forms from the command line or via a screenshot shortcut.
EN<->ES translation via the free Google Translate endpoint. A CLI
(translate "text"), a smart three-mode screenshot/selection script, and a
native macOS popup widget (no Hammerspoon required).
Plain screenshot -> OCR utilities: one copies extracted text, the other copies the image and saves the text alongside.