- name
- screengrab
- description
- |
screengrab
Thin wrapper around macOS screencapture. No dependencies beyond Python 3.
Requirements
- macOS only (
/usr/sbin/screencapture) - Script:
scripts/screengrab.py
Commands
# Capture all displays → /tmp/screengrab-TIMESTAMP.png
python3 scripts/screengrab.py snap
# Custom output path
python3 scripts/screengrab.py snap --out ~/Desktop/snap.png
# Specific display (0=main, 1=second)
python3 scripts/screengrab.py snap --display 0
# Open in Preview immediately
python3 scripts/screengrab.py snap --open
# Quiet mode — just prints the file path (useful for piping to image tool)
python3 scripts/screengrab.py snap --quiet
# List connected displays
python3 scripts/screengrab.py list
# Periodic capture (every 30s)
python3 scripts/screengrab.py watch
python3 scripts/screengrab.py watch --interval 10 --out-dir ~/Desktop/snaps
python3 scripts/screengrab.py watch --count 5 # stop after N capturesTypical Agent Workflow
# Grab screen and analyze with image tool
path=$(python3 scripts/screengrab.py snap --quiet)
# Then pass $path to image analysis