gooise 2020.7.18.8

Search for similar images on Google using Selenium

gooise

gooise (pronounced as goo-ee-se) is a Google Image Search automation tool.

Usage

Installation

gooise is available at Python Package Index and thus can be installed by pip:

$ pip install gooise

pip will also install gooise script to PATH.

Basic usage

Searching for local/remote image

$ gooise image.jpg
$ gooise https://example.com/img/image.jpg

Note: by default, gooise uses any available web driver, so you need to have at least one of these supported browsers installed:

• Chrome (or any other chromium-based browsers)
• Firefox
• Opera
• Internet Explorer
• Edge

If your browser is installed in some uncommon location or is not in PATH, you'll need to pass some extra parameters to gooise (see Configuring web driver.)

Advanced usage

Configuring web driver

Use -d {chrome,firefox,opera,ie,edge} option to specify type of browser, and -b PATH to specify browser executable.

$ gooise -d firefox -b /usr/bin/firefox image.jpg

Running in headless mode

Note: gooise supports headless mode in Chrome/Firefox only.

Headless mode (enabled by default, disabled by -r option) hides automated browser window preserving its full functionality. It's usually more preferable since browser in regular mode has to stay focused (Selenium might fail to interact with a web page if browser window is kept in background).

Contributing

Google tends to update their frontend once in a while, and thus all HTML tag IDs/classes are updated, too.

If you noticed that gooise isn't working as expected anymore (or not working at all) - you can open an issue or propose a fix via merge request.

These files contain CSS selectors and web page interaction logic:

• Logic - flow.py
• Conditions - condition.py
• Web page elements location - locator.py
• URL image search - searcher.py
• Local image uploader - uploader.py