Smart Screenshots

Renames screenshots based on OCR text from a watched folder.

What it does

• Watches /Users/__/Desktop/screenshots for new images.
• Runs OCR and builds a short, meaningful title.
• Renames the file in place.
• Logs to ~/.smart_screenshots.log and stops when ~/.stop_smart_screenshots exists.

Requirements

• Tesseract OCR installed and available on PATH (or set TESSERACT_CMD)
• Python packages in requirements.txt

Install

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Run manually

python main.py

Stop and restart

touch ~/.stop_smart_screenshots
rm ~/.stop_smart_screenshots

Background services

• macOS: copy launchd/com.smart.screenshots.plist to ~/Library/LaunchAgents/, then load it with launchctl load ~/Library/LaunchAgents/com.smart.screenshots.plist.
• Linux: copy systemd/smart-screenshots.service to ~/.config/systemd/user/, then run systemctl --user daemon-reload, systemctl --user enable smart-screenshots, and systemctl --user start smart-screenshots.
• Windows: run windows/run_smart_screenshots.bat or create a Task Scheduler entry pointing at it.

Notes

• Tesseract is auto-detected at /opt/homebrew/bin/tesseract on macOS; override with TESSERACT_CMD if needed.