CleanShot X-style OCR text capture for Hyprland. Select a screen region and the recognized text is copied to your clipboard. Designed for Omarchy.
yay -S omarchy-cmd-ocrOr build manually:
git clone https://aur.archlinux.org/omarchy-cmd-ocr.git
cd omarchy-cmd-ocr
makepkg -siAdd this line to your Hyprland config (e.g. ~/.config/hypr/hyprland.conf):
source = /usr/share/omarchy-cmd-ocr/hyprland-bindings.confThe default keybindings use SUPER+ALT+O / SUPER+ALT+SHIFT+O. To use different modifiers, copy and edit:
cp /usr/share/omarchy-cmd-ocr/hyprland-bindings.conf ~/.config/hypr/ocr-bindings.conf
# Edit to taste, then source your local copy instead| Action | Default Binding | Command |
|---|---|---|
| OCR (formatted) | Super+Alt+O |
omarchy-cmd-ocr |
| OCR (compact) | Super+Alt+Shift+O |
omarchy-cmd-ocr compact |
Formatted mode preserves the original text layout. Compact mode joins all lines and collapses whitespace into a single line.
- Screen freezes via
wayfreeze - Select a region or window with
slurp(same smart selection as Omarchy screenshots) grimcaptures the region, pipes totesseractfor OCR- Recognized text is copied to clipboard via
wl-copy - A notification shows a preview of the captured text
tesseract+tesseract-data-eng— OCR enginegrim— screenshot captureslurp— region selectionwayfreeze— screen freeze during selectionwl-clipboard— clipboard accessjq— JSON parsing for monitor/window geometrylibnotify— desktop notificationshyprland— window manager (forhyprctl)
MIT