gp-dl 0.4.0

A Python-based Google Photos downloader built with Selenium.

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 .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?

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")