Skip to content

Google Images Download

GitHub Repository

Summary

This is a command line python program to search keywords/key-phrases on Google Images and optionally download images to your computer. You can also invoke this script from another python file.

Important: Chrome/Chromium browser is required for this tool to work. Google Images now requires JavaScript execution, so Selenium with Chrome is mandatory for all downloads.

The tool automatically manages chromedriver installation using webdriver-manager, so no manual setup is needed.

Compatibility

This program is compatible with Python 3.x (Python 2.x support has been deprecated).

It is a download-and-run program with no complex setup required. You will just have to specify parameters through the command line or programmatically.

Installation

Detailed instructions on how to install the library.

Usage

Learn how to use the library from CLI or by standard imports.

Arguments

Complete reference of all arguments/parameters/options you can provide to this library.

Examples

Many examples to help new users quickly understand the usage.

Troubleshooting

Troubleshooting guide for commonly seen issues.

Workflow

Algorithm used within this module to download images.

Contribute

Anyone is welcomed to contribute to this script. If you would like to make a change, open a pull request. For issues and discussion visit the Issue Tracker.

The aim of this repo is to keep it simple, stand-alone, backward compatible and minimize 3rd party dependencies.

Disclaimer

Copyright Notice

This program lets you download tons of images from Google. Please do not download or use any image that violates its copyright terms.

Google Images is a search engine that merely indexes images and allows you to find them. It does NOT produce its own images and, as such, it doesn't own copyright on any of them. The original creators of the images own the copyrights.

Images published in the United States are automatically copyrighted by their owners, even if they do not explicitly carry a copyright warning. You may not reproduce copyright images without their owner's permission, except in "fair use" cases, or you could risk running into lawyer's warnings, cease-and-desist letters, and copyright suits.

Please be very careful before its usage! Use this script/code only for educational purposes.