Skip to content

README.md

Latest commit

 

History

History
40 lines (27 loc) · 2.09 KB

README.md

File metadata and controls

40 lines (27 loc) · 2.09 KB

Google Photos Deletion Script

A modern and resilient script to bulk-delete photos from your Google Photos library. Paste it into the developer console and let it run.

✨ Core Features

  • Modern JavaScript (async/await): Clean, readable, and easy to maintain.
  • Intelligent Waiting: Adapts to your network speed by waiting for content to actually load, preventing premature stops.
  • Stall Detection: Automatically detects when Google temporarily blocks deletions (rate-limiting). This prevents infinite loops and the script will safely stop.
  • Robust Error Handling: Fails gracefully with clear error messages.
  • Centralized Configuration: All CSS selectors are in one place for easy updates if Google changes their UI.

🚀 How to Use

  1. Navigate to photos.google.com.
  2. Open the Developer Console (Ctrl+Shift+J or Cmd+Option+J).
  3. Copy the code from delete-photos.js.
  4. Paste it into the console and press Enter.
  5. Do not close the tab. The script will run until no photos are left.
  6. If a stall is detected, the script will stop and instruct you to refresh the page. Simply press F5 (or Cmd+R), then paste and run the script again to continue.

⚖️ Why This Script is Better

This script is engineered to be more reliable than older alternatives that use fragile, time-based delays.

  • This Script (Modern async/await):

    • Waits for content, not for time. It proceeds only when the next batch of photos is actually visible.
    • Handles rate-limiting. Includes stall detection to handle Google's temporary blocks.
    • The code is sequential and easy to understand, and errors are clearly reported.

  • Alternative Scripts (Legacy setTimeout):

    • Use fixed delays. They break easily if the network is slow or the UI changes, causing them to fail or stop silently.

⚠️ Disclaimer

Use this script at your own risk. It performs a destructive action. I am not responsible for any data loss. It is recommended to test on a small number of photos first.

📄 License

MIT