Apple Photos Cleaner
Skill by and3rn3t
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/and3rn3t/apple-photos-cleanerWhat This Skill Does
The Apple Photos Cleaner skill is a specialized diagnostic and utility suite designed to gain deep insights into your local macOS Photos library. By interfacing with the underlying SQLite database, this tool provides a level of visibility that the standard Photos.app interface lacks. It identifies storage-consuming junk, manages duplicate files, and structures your media archive using advanced analysis. The core operations are non-destructive, performing read-only queries on the library database to ensure the integrity of your original media. Whether you are reclaiming disk space or curating your life's captured memories, this tool provides the granularity needed to manage large-scale photo collections efficiently.
Installation
To add this skill to your OpenClaw environment, execute the following command in your terminal:
clawhub install openclaw/skills/skills/and3rn3t/apple-photos-cleaner
Ensure your system is running macOS and has Python 3.9 or higher installed. As this script requires direct access to your local Photos SQLite database, the agent will request appropriate system permissions to read your Library file upon the first execution.
Use Cases
- Disk Space Recovery: Identify and purge high-resolution screenshots, low-quality images, and burst-mode leftovers that are needlessly consuming iCloud or local storage.
- Duplicate Management: Use intelligent quality scoring to find and group similar photos, ensuring you keep the best version while clearing out pixel-perfect duplicates.
- Automated Curation: Generate 'Year-in-Review' or 'Seasonal Highlight' recaps to surface memories you might otherwise overlook.
- Library Auditing: Find 'orphan' photos not assigned to any album or detect storage hogs by file type and year.
- Shared Library Insights: Analyze the distribution of your Shared Library to understand how much space is being contributed by various participants.
Example Prompts
- "Analyze my Photos library and tell me which year is taking up the most storage space and identify the top 50 junk screenshots to remove."
- "Find all duplicate photos taken within 5 seconds of each other and suggest which ones to delete based on resolution and quality score."
- "Generate a narrative recap of my summer trip to Japan based on the photos and videos in my library, focusing on key locations and people."
Tips & Limitations
This tool is exclusively designed for macOS and requires access to your Photos library database file. While the analysis is read-only, any cleanup action involving deletion requires you to grant AppleScript permissions to the agent to interact with the Photos application directly. Always ensure your library is backed up before running batch deletions. Note that processing very large libraries (over 100,000 items) may require a few moments for the initial indexing phase to complete.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-and3rn3t-apple-photos-cleaner": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, code-execution