Skip to content

sonpiaz/kapt

Repository files navigation

Kapt

Lightweight macOS screenshot tool with annotation, OCR, and scrolling capture.

License Stars macOS 15+ Swift 6


Features

  • Fullscreen capture (Cmd+Ctrl+3) — Capture the active display
  • Region capture (Cmd+Ctrl+4) — Select and capture a rectangular area
  • Scrolling capture (Cmd+Ctrl+5) — Capture tall content with auto-scroll stitching
  • Annotation tools — Arrow, rectangle, ellipse, line, freehand, text, counter, blur/pixelate, image insert
  • OCR — Extract text from screenshots using the Vision framework
  • Smart thumbnails — Floating preview after capture — click to annotate, drag to share
  • Customizable hotkeys — Configure shortcuts in Settings
  • Menu bar app — Always ready, no dock icon

Install

Homebrew (recommended)

brew install --cask sonpiaz/tap/kapt

Build from source

git clone https://github.com/sonpiaz/kapt.git
cd kapt
./scripts/install.sh

Requirements

  • macOS 15.0 (Sequoia) or later
  • Screen Recording permission (requested on first launch)
  • Accessibility permission (for scrolling capture auto-scroll)

Development

./scripts/dev.sh    # Kill → rebuild → relaunch (~3 seconds)

Project Structure

Sources/
├── KaptApp.swift                — App entry, menu bar popover
├── AppState.swift               — Capture orchestration
├── Capture/                     — ScreenCaptureKit, region selection, scrolling
├── Annotation/                  — Canvas, shapes, toolbar
├── OCR/                         — Vision framework text recognition
├── Hotkeys/                     — Keyboard shortcut registration
├── MenuBar/                     — Preferences UI
└── Overlay/                     — Floating thumbnail, drag support

Tech Stack

Technology Purpose
Swift 6 Language
SwiftUI UI framework
ScreenCaptureKit Screen capture API
Swift Package Manager Build system
KeyboardShortcuts Hotkey management

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines.

Related

  • Yap — Push-to-talk dictation for macOS
  • Pheme — AI meeting notes with real-time transcript & auto-summary
  • hidrix-tools — MCP server for web & social search
  • affiliate-skills — 45 AI agent skills
  • content-pipeline — AI-powered LinkedIn content generation

License

MIT — see LICENSE for details.


Built by Son Piaz

About

Native macOS screenshot & annotation tool

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors