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 [limit]
Search by content	scripts/photos-search-content.sh [limit]
Search by date	scripts/photos-search-date.sh [end] [limit]
Photo info	scripts/photos-info.sh
Export photo	scripts/photos-export.sh [output_path]

Output

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

Workflow: View a Photo

Get UUID: scripts/photos-recent.sh 1

Export: scripts/photos-export.sh "UUID"

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