Skip to main content

Tools to download images from Google search

Project description

It provides tools to grab images from a google search by extracting the links of the images and downloading original images.

This module is written for windows 10 on 64-bit processor. It uses Selenium to open browser so as to scroll down to get more images than possible otherwise. Thus it needs a browser to work correctly. This is on default set to use chrome browser in case of inability to open it Firefox will be used. The package comes with chromedriver and geckodriver with it.


To install gImageGrabber do as follow:

$ pip install gImageGrabber

There are two python files imgScrape and imgTools.

imgScrape has all the utilities needed to run the script but if you want to have additional control over the functions you could explore imgTools.


To import this module to your script do this :

from imggrabber import imgScrape
from imggrabber import imgTools


Building URL


This is to compose a google search URL for your search term. To specify your search term use search argument of the function to build the URL.

Usage :

from imggrabber import imgScrape

searchTerm = "kamikaze eminem"

url = imgScrape.build_url(searchTerm)

Getting Source Data

imgScrape.browser(url, test=False)

This to start a browser windows and scroll down the webpage to let more pictures load.It returns a raw source code data of the webpage encoded in utf-8 format. It takes 2 arguments url and test .

  1. url is the url of the page it needs to open.
  2. test is to make the browser scroll down less thus taking less time to return the source code. This is useful when you are writing or debugging something in your script.

It uses Chrome or Firefox to work so make sure you have Google chrome or Firefox installed at their default directory.

Sometimes you might need to click on show more images on webpage to load even more images

If you cant seem to open browser make sure you are on 64-bit OS and that you have chrome or Firefox installed.

If you are on 32-bit processor you need to use Firefox and you also have to download 32 bit driver from here and replace it with the already present geckodriver.exe saved in driver folder in root director of your python .

Usage :

from imggrabber import imgScrape

searchTerm = "kamikaze eminem"

url = imgScrape.build_url(searchTerm)
raw_data = imgScrape.browser(url)
print(raw_data) #FOR DEBUG PURPOSE

Saving Images

imgScrape.saveImages(data, name, onlyType, startingnos, prefix)

This saves all the images given to it in a list of format [link: file extension].

It takes 3 arguments:

  1. data This is to provide dictionary containing links to images in format [link: file extension].
  2. name This is to provide the name for the folder under which images will be saved.
  3. onlyType If you want only a particular file extension then use this mention that. If not, then pass it a empty string or just don’t use that argument.
  4. startingnos If you want to start the file naming to start from a certain number use this argument to provide that point
  5. prefix Any prefix you want in your file name goes in this argument

The format in which it saves images is

Root folder
|-- Search Term
    |-- file extension(eg 'jpg')
        |-- 000001.jpg
        |-- 000002.jpg

Usage :

from imggrabber import imgScrape

searchTerm = "Kamikaze"
extension = '' #save all types of images
sNos = 0 #starting nos
prefix = "" #prefix to file name

url = imgScrape.build_url(searchTerm)
raw_data = imgScrape.browser(url)
links = imgScrape.imageLink(raw_data)

Example Code

This code is included in the package as

from imggrabber import imgScrape

# Search term
search = 'kamikaze eminem'
fType = ''  # if you want all the files them make it empty string
sNos = 0
debug = False
prefix = ""

html = imgScrape.browser(imgScrape.build_url(search), debug)
data = imgScrape.imageLink(html)
imgScrape.saveImages(data, search, fType,sNos,prefix)


Saksham Sharma

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gImageGrabber, version 0.1.15
Filename, size File type Python version Upload date Hashes
Filename, size gImageGrabber-0.1.15.linux-x86_64.tar.gz (11.7 MB) File type Source Python version None Upload date Hashes View hashes
Filename, size gImageGrabber-0.1.15-py3-none-any.whl (11.8 MB) File type Wheel Python version py3 Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page