mirror of
https://github.com/csd4ni3l/gp-dl.git
synced 2026-01-01 04:23:44 +01:00
8f0a6909e2
* add user and password parameters (not used if profile_dir is set) * remove mandatory album_url args * auto login with user and password * add locale for FR and GOOGLE_LANG (default en) environment variable to switch * add CHROME_BINARY whenever need to specify chrome binary path * add headless compatibilty for WSL * fix missing gp_temp after first loop * fix unclickable "More option" button by fetching "Share" button first
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 link-shared Google Photos album URLs
- Accepts your own Google Photos album URLs if you supply the profile directory.
- Automatically extracts downloaded
.zipfiles 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?
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, 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.
Disclaimer
- 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.
- Selenium auto-downloads the Chrome driver if not found, which can take up space.
Installation
pip install gp-dl
Usage
CLI
gp-dl --album-urls ALBUM_URL ALBUM_URL2 --output-dir test
As a module
from gp_dl import download_albums
successful_albums, failed_albums, album_times = download_albums(["ALBUM_URL", "ALBUM_URL2"], output_dir="test")