download_images
download_images is a Python library for downloading images from google.
Installation
Use the package manager pip to install download_images.
pip install download_imagesDownload download_images from my github and use in your project
Usage
import download_images
download_images.main(["-q", "<query>", <args>"]) searches google for images from args and downloads them
Example
An example use is given on my github in the examples repository
Args
usage: download_images.main([-h] -q QUERY [QUERY ...] [-l LIMIT] [-o OUTPUTDIR]
[-c CHROMEDRIVER] [-epq EXACTQUERY]
[-oq OPTIONALQUERY] [-eq EXCEPTQUERY]
[-cs CUSTOMSIZE | -sz {s,m,l,i,>2MP,>4MP,>6MP,>8MP,>10MP,>12MP,>15MP,>20MP,>40MP,>70MP,>400*300,>640*480,>800*600,>1024*768}]
[-ar {s,t,w,p}]
[-co {red,orange,yellow,green,teal,blue,purple,pink,white,gray,black,brown} | -ct {full-colour,black-and-white,transparent}]
[-it {face,photo,clipart,lineart,animated}]
[-ft {jpg,gif,png,bmp,svg,webp,ico,raw}] [-s SITE]
[-ss {True,False}] [-ur {CC,Commercial,Other}])
Get arguments for searching for images
optional arguments:
-h, --help show help message and exit
-q QUERY [QUERY ...], --query QUERY [QUERY ...]
Query to search for
-l LIMIT, --limit LIMIT
Max images to download
-o OUTPUTDIR, --outputDir OUTPUTDIR
Full directory to store images in
-c CHROMEDRIVER, --chromedriver CHROMEDRIVER
Full directory to the chromedriver
-epq EXACTQUERY, --exactQuery EXACTQUERY
Words that must be included (e.g. bat under)
-oq OPTIONALQUERY, --optionalQuery OPTIONALQUERY
Words that are optional (e.g. apple tree)
-eq EXCEPTQUERY, --exceptQuery EXCEPTQUERY
Words that must not be included (e.g. cat vote)
-cs CUSTOMSIZE, --customSize CUSTOMSIZE
Find image of specific size
-sz {s,m,l,i,>2MP,>4MP,>6MP,>8MP,>10MP,>12MP,>15MP,>20MP,>40MP,>70MP,>400*300,>640*480,>800*600,>1024*768}, --size {s,m,l,i,>2MP,>4MP,>6MP,>8MP,>10MP,>12MP,>15MP,>20MP,>40MP,>70MP,>400*300,>640*480,>800*600,>1024*768}
Find images of specific size (s, m, l, icon, >x MP,
>x*y)
-ar {s,t,w,p}, --aspectRatio {s,t,w,p}
Find images of specific aspect ratio (square, tall,
wide, panoramic)
-co {red,orange,yellow,green,teal,blue,purple,pink,white,gray,black,brown}, --colour {red,orange,yellow,green,teal,blue,purple,pink,white,gray,black,brown}
Find images containing specific colour
-ct {full-colour,black-and-white,transparent}, --colourType {full-colour,black-and-white,transparent}
Find images of specific type
-it {face,photo,clipart,lineart,animated}, --imageType {face,photo,clipart,lineart,animated}
Type of image
-ft {jpg,gif,png,bmp,svg,webp,ico,raw}, --fileType {jpg,gif,png,bmp,svg,webp,ico,raw}
Type of file
-s SITE, --site SITE Specific site or domain to search (e.g. example.com,
.org
-ss {True,False}, --SafeSearch {True,False}
Should SafeSearch be on
-ur {CC,Commercial,Other}, --usageRights {CC,Commercial,Other}
Filter by usage rightsContributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.
License
Disclaimer
This program lets you download images from Google. Please do not use any image in a way 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 code judiciously.
Support Us
To show your support for this project you can thank me or buy me a coffee
