macOS Photos Skill

Control and query Apple Photos.app on macOS using AppleScript (osascript) commands.

Overview

Photos.app exposes an AppleScript dictionary that lets you read albums, media items, metadata, and perform limited write operations like creating albums and managing favorites. All commands use osascript from the terminal.

Core Concepts

• Media item — a photo or video in the library
• Album — a user-created collection of media items
• Folder — a container that holds albums or other folders
• Container — generic term for album or folder
• Keyword — a tag attached to a media item

Listing Albums