Skills
skills/clawdbot/skills/apple-photos

apple-photos

SKILL.md

Apple Photos

Access Photos.app via SQLite queries. Run scripts from: cd {baseDir}

Requirements

  • Full Disk Access for terminal (System Settings → Privacy → Full Disk Access)

Commands

Command Usage
Library stats scripts/photos-count.sh
List albums scripts/photos-list-albums.sh
Recent photos scripts/photos-recent.sh [count]
List people scripts/photos-list-people.sh
Search by person scripts/photos-search-person.sh <name> [limit]
Search by content scripts/photos-search-content.sh <query> [limit]
Search by date scripts/photos-search-date.sh <start> [end] [limit]
Photo info scripts/photos-info.sh <uuid>
Export photo scripts/photos-export.sh <uuid> [output_path]

Output

  • Recent/search: Filename | Date | Type | UUID
  • People: ID | Name | Photo Count
  • Default export: /tmp/photo_export.jpg

Workflow: View a Photo

  1. Get UUID: scripts/photos-recent.sh 1
  2. Export: scripts/photos-export.sh "UUID"
  3. View at /tmp/photo_export.jpg

Notes

  • Date format: YYYY-MM-DD or YYYY-MM-DD HH:MM
  • Content search uses ML, slower (~5-10s) than date/person (~100ms)
  • HEIC auto-converts to JPEG on export
  • Name search is case-insensitive, partial match
Weekly Installs
3
Repository
clawdbot/skills
Installed on
windsurf2
codex2
trae1
opencode1
cursor1
claude-code1