Metadata-Version: 2.1
Name: image_mint
Version: 1.0.3
Summary: image_mint is a python package for searching for and downloading images
Home-page: https://github.com/kouroshparsa/image_mint
Author: Kourosh Parsa
Author-email: kouroshtheking@gmail.com
License: UNKNOWN
Keywords: google,bing,yahoo,images,scraping,search
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE

<i>image_mint</i>

# 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:
  ```wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
  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:
```python
    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
```


