← Back to App Dashboard
📸

Shottr Production Guide

The pixel-perfect screenshot utility for modern UI/UX workflows. Screen recording buffer adjustments, local OCR state purges, and total security tccutil resets.

1. Production Installation Command

bash
brew install --cask shottr

2. Deep-Dive Maintenance & CLI Core Tuning Sheet

Target Operational Action / Hotkey Terminal Command Syntax / Core Tweak
Area Capture Trigger
Summon the pixel-perfect drag interface to snap specific layout coordinates.
⌘ + ⇧ + 1
Scrolling Screenshot Mode
Initiate an automated vertical frame-buffer stitching sequence for long web pages.
⌘ + ⇧ + 2
Purge Temporary Image Caches
Manually wipe out all lingering intermediate screenshot chunks and auto-save file fragments to free up storage.
rm -rf ~/.shottr/tmp/* && rm -rf ~/Library/Caches/com.shottr.Mac/*
Reset Overlay Measurements Guides
Wipe out broken grid coordinate parameters and force-reload default pixel ruler metrics.
defaults delete com.shottr.Mac overlayRulers
Verify Background Ingestion Process
Check if the core background capture helper daemon is actively listening for hardware global hotkeys.
pgrep -l Shottr
Complete Sandbox Evacuation
Kill the interface instance, wipe property list binaries, and purge localized container states.
pkill -9 Shottr && defaults delete com.shottr.Mac

3. Critical Troubleshooting & Crash Base

🚨 Error #1: Black Screen Captures (Screen Recording Privilege Loss)

Root Cause: macOS window server security daemons revoke frame-grabbing context tokens after system security updates or user profile migrations. Hard-reset the core privacy database entry via Terminal:

bash
tccutil reset ScreenCapture com.shottr.Mac && pkill Shottr

🚨 Error #2: Broken OCR Text Recognition Engine (Hanging Parser Loops)

Root Cause: Corrupted localized font arrays or fragmented dictionary databases cause the underlying text-parsing architecture to loop infinitely. Purge the app's internal sandbox cache storage:

bash
rm -rf ~/Library/Containers/com.shottr.Mac/Data/Library/Caches/com.shottr.Mac

🚨 Error #3: Pixel Rulers Offset / Coordinates Calibration Drift

Root Cause: macOS display scaling configuration mismatches (Retina vs External Monitors) inject broken aspect-ratio parameters into the ruler buffer. Flush UI properties logs to re-align coordinates:

bash
defaults delete com.shottr.Mac areaShotScale && killall Shottr

🚨 Error #4: Floating Pin Window Freezes UI Server (ControlCenter Memory Lock)

Root Cause: Leaving heavy rich-graphics image pins active over multiple virtual spaces triggers layout buffer deadlocks inside ControlCenter. Force-cycle the shared background interface manager:

bash
pkill -f "Shottr" && killall ControlCenter