csd4ni3l/gp-dl
1
0
Fork 0
mirror of https://github.com/csd4ni3l/gp-dl.git synced 2026-01-01 04:23:44 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add median time statistics, log levels, print successful and failed album titles, update README

Browse Source
This commit is contained in:
csd4ni3l
2025-06-17 11:08:07 +02:00
parent efd60fd633
commit 301956a954
5 changed files with 71 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
README.md
View File

@@ -4,38 +4,37 @@
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
## 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
* Accepts link-shared Google Photos album URLs
* Accepts your own Google Photos album URLs if you supply the profile directory.
* 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?
## 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:
**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
* You must select each photo manually, no "select all" option, meaning it can not be automated.
* Limited to a maximum number of items
* It requires setting up a Google Cloud project and API credentials, which is pretty hard.
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
## ⚠️ 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.
* It simulates human actions, but Google might not be happy about someone using this.
## 🧰 Requirements
## Requirements
* Python 3.11+
* Selenium
* Chrome or Chromium + WebDriver
* Chrome or Chromium + WebDriver (Auto-installed by Selenium if not found)
## 💡 Usage
## Installation
```bash
python main.py --album-urls YOUR_ALBUM_LINK_HERE --output-dir test_images
```
`pip install gp-dl`
## Usage
`gp-dl --album-urls ALBUM_URL ALBUM_URL2 --output-dir test --log-level info`