Skip to content

StevenACZ/PeekOCR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

👁️ PeekOCR

OCR, screenshots, GIF clips, and annotations — from your macOS menu bar

macOS 13+ Swift 5.9 MIT License


✨ What is PeekOCR?

PeekOCR is a macOS menu bar app that lets you quickly select an area of your screen to:

  • copy extracted text (OCR) to the clipboard,
  • save screenshots (optionally annotated),
  • and record short GIF clips (ideal for sharing UI bugs/animations).

🎯 Features

Feature Description
📸 OCR Capture Select an area and copy the extracted text
🔗 QR Detection Detect and copy QR contents
📷 Screenshots Save images with configurable format/quality/scale
✍️ Annotation Editor Capture with annotations, then export
🎞️ GIF Clip Capture Record up to 10s, trim, preview, and export as GIF
🕘 History Quickly access your last 6 captures
⌨️ Hotkeys Customize global shortcuts in Settings

🚀 Installation

  1. Download the latest version from Releases
  2. Open the DMG and drag PeekOCR.app to your Applications folder
  3. Launch PeekOCR
  4. Grant the required permissions when prompted

⌨️ How to Use

Default Keyboard Shortcuts

All shortcuts can be changed in Settings.

Action Shortcut
Capture text (OCR) ⇧ Space
Capture screenshot ⌘⇧4
Capture with annotations ⌘⇧5
Capture GIF clip (max 10s) ⌘⇧6

Quick Start

OCR

  1. Press ⇧ Space
  2. Drag to select a region
  3. The extracted text is copied to your clipboard

GIF Clip

  1. Press ⌘⇧6
  2. Select a region
  3. Record (auto-stops at 10s or stop early)
  4. Trim in/out in the editor and export as a GIF

🔐 Permisos

🔐 Permissions

PeekOCR needs two permissions to work properly:

Permission Why
Screen Recording Capture screen content
Accessibility Register global hotkeys

Tip: PeekOCR will guide you to enable these the first time you use a capture mode.


💻 Requisitos

💻 Requirements

  • macOS 13.0 (Ventura) or later
  • Apple Silicon or Intel Mac

📚 Documentation

  • AGENTS.md (project map + conventions)
  • docs/ARCHITECTURE.md
  • docs/SERVICES.md
  • docs/MODELS.md
  • docs/VIEWS.md
  • docs/GIF_CLIP.md

📝 Licencia

📝 License

MIT License — use and modify freely


Made with ❤️ for the macOS community

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages