goris

Overview

This is a CLI tool to search for images with Google Reverse Image Search.

Description

Images can be searched by image files and image URLs. Searched images display URLs and also can be downloaded as image files.

How to Install

Download an executable file from the release page and put to a directory with path.

or

Use go get.

go install github.com/tanaikech/goris@latest

IMPORTANT

20230406: In the current stage, the specification for running the reverse image search was changed at Google side. I could modify the script for searching the images using an image URL. But, I have still not modified the script for searching the images using an image file. I'm sorry for this. Now, I am analyzing. When I could do it, I would like to modify this. So, in the current stage, please use the following command.

goris s -u [image URL]

Usage

Search images from an image file. You can select number of output URLs using -n. The maximum number of output URLs is 100. (The current default value is 10. So when -n is not used, 10 URLs are returned.)

goris s -f [image file] -n 50

Search images from an image URL.

goris s -u [image URL]

A simlpe test is as follows.

goris s -u https://stackoverflow.design/assets/img/logos/so/logo-stackoverflow.png

Download searched images from an image file. Following sample downloads 10 searched images using an image file.

goris s -u https://stackoverflow.design/assets/img/logos/so/logo-stackoverflow.png -d -n 10

goris s -f [image file] -d -n 10

Retrieve web pages with matching images on Google top page. When this is not used, images are retrieved.

goris s -u [image URL] -w

goris s -f [image file] -w

Licence

MIT

Author

TANAIKE

If you have any questions and commissions for me, feel free to tell me using e-mail of tanaike@hotmail.com

Update History

• v1.0.0 (April 26, 2017)

  Initial release.

• v1.0.1 (May 16, 2017)

  1. A bugfix
     • When number of retrieved URLs is smaller than number of default output, an error had occurred. This was fixed. (Thank you! Steve Davis)

• v1.1.0 (June 13, 2017)

  1. Add option
     • When images are matched to a searched image, web pages with matching images are retrieved. These are web pages displayed on Google top page. When this is not used, images are retrieved. This was added as a boolean option. (This was added by a request.)

• v1.1.1 (January 3, 2020)

  1. It seems that the specification of github.com/urfave/cli was changed by the update of https://github.com/urfave/cli. By this, when go get -u github.com/tanaikech/goris is run, an error occurred. So this error was removed.

• v2.0.0 (April 23, 2020)

  1. The specification for running the reverse image search was changed at Google side. By this, this application was also changed.

• v3.0.0 (February 23, 2022)

  1. The specification for running the reverse image search was changed at Google side. By this, this application was also changed.

• v3.0.1 (May 2, 2022)

  1. About the option -w, a bug was resolved. By this, the URLs of the related Web site are returned. As the default, 10 URLs are returned. If you want to retrieve more, please use the option -n like -n 20.

• v3.0.2 (February 2, 2023)

  1. Modified go.mod and go.sum.

• v3.0.3 (April 6, 2023)

  1. Rebuild with the latest version.

• v3.0.4 (April 6, 2023)

  1. The specification for running the reverse image search was changed at Google side. By this, this application was also changed. But, in the current stage, an image file in the local PC cannot be searched while an image URL can be searched. Now, I am analyzing. When I could do it, I would like to modify this. So, in the current stage, please use the following command.

  goris s -u URL
  

• v3.0.5 (June 14, 2025)

  1. I updated goris because the specification for running the reverse image search was changed on the Google side.
  2. Rebuild goris by go1.24.4.

TOP