photos-app-cli

Automates querying, organizing and exporting macOS Photos library media via SQLite-backed CLI commands.

3|1|Updated May 19, 2026
One-click install
npx skills add https://github.com/adbertram/cli-tools --skill photos-app-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: photos-app-cli
Source: https://github.com/adbertram/cli-tools/tree/main/_repo/skills/photos-app-cli
Command: npx skills add https://github.com/adbertram/cli-tools --skill photos-app-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the difficulty of programmatically interacting with the macOS Photos library, allowing for automated organization, metadata retrieval, and batch exporting without manual UI navigation.

Core Features & Use Cases

  • Library Management: List, count, and organize photos into albums using simple command-line flags.
  • Batch Exporting: Download photos or entire albums to local storage with support for date-based filtering.
  • Use Case: You can quickly export all photos from a specific vacation album to a desktop folder or auto-enhance a batch of photos for an online listing.

Quick Start

Use the photos-app-cli to list the ten most recent photos from your library in a table format.

Frequently Asked Questions about photos-app-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch export photos from the macOS Photos library via command line?

You can batch export photos from the macOS Photos library via command line by using this skill to automate downloading photos or entire albums to local storage with support for date-based filtering.

What is the best way to extract metadata from a macOS Photos library without the UI?

The best way to extract metadata from a macOS Photos library without the UI is using this skill to automate metadata retrieval and organization for local file processing without manual navigation.

Can I automate album management and organization in the macOS Photos app?

Yes, you can automate album management and organization in the macOS Photos app by passing simple command-line flags to list, count, and organize photos into albums.

Do I need special permissions to query the macOS Photos SQLite database for automation?

Yes, you need direct access to the macOS Photos.app SQLite database and system-level automation permissions to execute library operations and query your media.

Does this macOS photos CLI automation tool support filtering by date?

Yes, this macOS photos CLI automation tool supports date-based filtering, allowing you to quickly export photos from specific albums or timeframes to a designated local folder.

What are the limitations of using a CLI to manage a macOS Photos library?

A key limitation is that this approach requires direct access to the macOS Photos.app SQLite database, meaning it is strictly limited to macOS environments and requires system-level automation permissions to function.