apple-photos-to-sociallisted

# Apple Photos to social posts Turn a personal photo library into a small set of reviewed post candidates. The hard part is not drafting copy, it is narrowing tens of thousands of photos down to the handful worth posting, without redoing that work every month. ## Before you start Run `photos2social doctor`. It reports whether Photos is reachable, whether privacy filters are configured, and how much disk is free. If Photos is not reachable, stop and tell the user which permission is missing. Do not attempt the Full Disk Access route as a workaround; this tool deliberately does not need it. **If `doctor` says privacy filters are NONE CONFIGURED, stop and tell the user before running anything.** Without filters, every photo in the window becomes a candidate, including photos of their family, and you will be looking at all of them. Offer to help set up `privacy.exclude_albums` first. Only pass `--allow-unfiltered` if the user explicitly says to. ## The loop ### 1. Scan first, always ```bash photos2social scan --days 30 ``` Metadata only. Nothing is exported, nothing is written. This tells you how much is actually new versus already reviewed. If "new to review" is zero, say so and stop: there is nothing to do, and that is a useful answer. ### 2. Review ```bash photos2social review --days 30 ``` This exports derivatives, hashes them, collapses bursts into distinct moments, writes numbered contact sheets, and records everything in the ledger. Expect roughly 3 to 5 seconds