skills.rest
and3rn3t
and3rn3tCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

apple-photos-cleaner

Analyze Apple Photos SQLite databases to identify junk photos and duplicates.

Updated Mar 3, 2026
Search Tags:#screenshots#cleanup#organization#storage#duplicates#photos
One-click install
npx skills add https://github.com/and3rn3t/apple-photos-cleaner --skill apple-photos-cleaner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-photos-cleaner
Source: https://github.com/and3rn3t/apple-photos-cleaner/tree/main
Command: npx skills add https://github.com/and3rn3t/apple-photos-cleaner --skill apple-photos-cleaner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pytest, pytest-cov, ruff, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Manually cleaning and organizing the Apple Photos library is time-consuming and often overwhelming, with many photos being duplicates, low-quality, or simply junk. This Skill automates the identification and cleanup of these unwanted items.

Core Features & Use Cases

  • Junk Identification: Automatically finds screenshots, low-quality photos, burst leftovers, and duplicates.
  • Storage Analysis: Provides detailed breakdowns of library size by year, type, and file format.
  • Use Case: A user wants to free up space on their Mac and asks, "How can I clean up my Photos library?" This Skill can identify thousands of old screenshots and duplicate photos, estimate the potential storage savings, and even offer to move them to the Recently Deleted folder.

Quick Start

Use the apple-photos-cleaner skill to find junk photos in your library.

Frequently Asked Questions about apple-photos-cleaner

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

FAQPage Schema
How do I clean up my Apple Photos library to free up Mac storage?▼

You can clean up your Apple Photos library by querying the macOS SQLite database to identify junk photos like screenshots, duplicates, and burst leftovers, estimating potential storage savings before moving them to Recently Deleted.

What types of junk photos are automatically identified for organization?▼

The junk photos identified for organization include screenshots, low-quality images, burst leftovers, and duplicates. This automated identification helps estimate potential storage savings across your library.

Do I need Python installed to analyze my Apple Photos library?▼

Yes, you need Python 3.9 or higher installed on your macOS system to run the database queries that analyze your Apple Photos library and identify unwanted photos for cleanup.

Is it safe to run a Photos library cleanup on my Mac?▼

Running a Photos library cleanup is safe because the Skill operates read-only on the SQLite database, meaning it analyzes and identifies junk without modifying your original photo files directly.

Can I get a storage breakdown of my Apple Photos library by year and file format?▼

Yes, you can get a detailed storage breakdown of your Apple Photos library by year, file type, and format, alongside timeline recaps and export planning for managing your identified photos.

Related Skills

Explore More Personal & Entrepreneur Skills→
n0rvynn0rvyn
1

photos

Query the Apple Photos.sqlite database to search and retrieve local photos.

Community
Advanced
Albatross679Albatross679

ml-project-migration

Categorize ML project files for Git versus cloud storage migration.

Community
Intermediate
huangzthuangzt
17

sqlite-tools

Execute SQL queries and inspect schemas in SQLite database files.

Community
Intermediate
adbertramadbertram
3

photos-app-cli

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

Community
Intermediate