https://github.com/csd4ni3l/gp-dl
A Python-based Google Photos downloader built with Selenium.
https://github.com/csd4ni3l/gp-dl
google google-photos google-photos-albums google-photos-backup google-photos-download google-photos-python python selenium selenium-python selenium-python-bot
Last synced: 4 months ago
JSON representation
A Python-based Google Photos downloader built with Selenium.
- Host: GitHub
- URL: https://github.com/csd4ni3l/gp-dl
- Owner: csd4ni3l
- License: gpl-3.0
- Created: 2025-06-09T15:15:04.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-09T16:14:54.000Z (4 months ago)
- Last Synced: 2025-06-09T17:27:09.679Z (4 months ago)
- Topics: google, google-photos, google-photos-albums, google-photos-backup, google-photos-download, google-photos-python, python, selenium, selenium-python, selenium-python-bot
- Language: Python
- Homepage:
- Size: 20.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Google Photos Downloader
**A Python-based Google Photos downloader built with Selenium.**
This tool automates the process of downloading photos from Google Photos albums by simulating user interaction with the web interface. It uses Selenium to open shared album links, click the "Download all" button, and extract the images to your local system.
## ✨ Features
* 🔗 Accepts public/shared Google Photos album URLs
* 🖱️ Simulates browser behavior to download photos via the "Download all" option
* 🗃️ Automatically extracts downloaded `.zip` files into organized folders
* 🛠️ Works without needing any API keys or OAuth setup
* 📂 Supports batch downloading of multiple album links
## 🛑 Why not use the Google Photos API?
As of recent updates, **the original Google Photos API is deprecated**. While the **Google Picker API** is still available, it comes with several major limitations:
* 🚫 You must select each photo manually — no "select all" option
* 📉 Limited to a maximum number of items (up to 100 photos per interaction)
* 🔐 Requires setting up a Google Cloud project and API credentials
Due to these restrictions, this Selenium-based solution is one of the few remaining ways to fully automate bulk downloads from Google Photos albums.
## ⚠️ Disclaimer
* The project was not made by AI, just the README.
* It automates actions that a human user would normally perform in a browser.
* Be aware of Google’s Terms of Service before using this tool.
## 🧰 Requirements
* Python 3.11+
* Selenium
* Chrome or Chromium + WebDriver
## 💡 Usage
```bash
python main.py --album-urls YOUR_ALBUM_LINK_HERE --output-dir test_images
```