Skip to content

domsleee/ScreenGrab

Repository files navigation

ScreenGrab

A lightweight screenshot tool for macOS with annotation capabilities, inspired by ShareX.

Demo

Demo

Features

  • Global Hotkey: ⌘⇧2 to start capture from anywhere
  • Region Selection: Click and drag to select — screenshot is captured when you release the mouse button
  • Annotations: Draw rectangles (R), arrows (A), text (T), with customizable colors — or select/move them (S)
  • Auto-save & clipboard: Copies to clipboard and saves to a configurable location (default ~/Pictures/ScreenGrab/)
  • Preview thumbnail: macOS-style thumbnail after capture — click to reveal in Finder

Installation

Homebrew

brew install domsleee/tap/screengrab

Note

ScreenGrab is ad-hoc signed and not notarized with Apple (same approach as AeroSpace). The Homebrew cask automatically strips the quarantine attribute during install so macOS Gatekeeper won't block it. If you download the zip manually from GitHub Releases, you'll need to run xattr -d com.apple.quarantine /Applications/ScreenGrab.app before launching.

Build from Source

xcode-select --install  # if needed
git clone https://github.com/domsleee/ScreenGrab.git
cd ScreenGrab
bash scripts/install.sh  # builds and copies ScreenGrab.app to /Applications

Usage

Launch ScreenGrab — it runs in the background with a menu bar icon. Click the icon to start a capture, open settings, or quit.

macOS will prompt for Screen Recording permission on first launch (System Settings → Privacy & Security → Screen & System Audio Recording).

Keyboard Shortcuts

Shortcut Action
⌘⇧2 Start capture
R Rectangle tool
A Arrow tool
T Text tool
S Select tool
Delete Delete selected annotation
⌘Z / ⌘⇧Z Undo / Redo
ESC Cancel

Requirements

  • macOS 13.0 (Ventura) or later
  • Screen Recording permission

License

MIT License

About

ShareX-like screen capture app for macOS

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors