image_mint

Purpose

• This python package can be used to search for and download images from various search engines. You can specify minimum width and height of the image if you want.

Installation

• You must have Chrome browser installed. You can download it from https://www.google.com/chrome/ On Ubuntu, you can run:

  sudo dpkg -i google-chrome-stable_current_amd64.deb```
  

• You must download Chrome webdriver. You can download it from https://chromedriver.chromium.org/downloads To know which version of Chrome is installed to match the driver version, you can use this command on Ubuntu: dpkg --list|grep chrome
• After that, you can install the package using pip:

  pip install image_mint
  

Usage:

You can use the package in python code like so:

    from image_mint import Scraper  
    from image_mint.engines import Google
    scraper = Scraper(Google('c:/temp/animals/chromedriver.exe'))
    scraper.download("cat", "c:/temp/animals/images", limit=100, min_width=200)

Example on Windows You can also use command line:

image_mint.exe -c C:\temp\animals\chromedriver.exe -d C:\temp\animals\images -e Bing "Wild cats" -l 20 -mw 200

Note that the windows executable can be downloaded from https://github.com/kouroshparsa/image_mint/blob/main/image_mint/bin/image_mint.exe

Here are the flags that can be used:

• -e : the search engine, possible values: DogPile/Bing/Google/DuckDuckGo/Yahoo
• -d : the destination folder to download images to
• -c : the chrome driver path using
• -l : number of images to download
• -mw : minimum width
• -mh : minimum height

Example on Linus You can use other languages as well:

image_mint -c /tmp/chromedriver -d /tmp/images -e Google "πλοίο" -l 20 -mw 200

On some linux environment particularly Docker images, it is possible that after installing the package it does not recognize the image_mint executable. In that case, run:

export PATH=$PATH:~/.local/bin

or if you want it persist, add it to ~/.bashrc