Cloud Vision API

Similarity is a script for Adobe Photoshop that can communicate with Google Cloud Vision API (machine learning image analysis service) in order to classify your image and search for exact copies or similar images over whole web. This information will let you:

  • track unauthorized use of your image on 3rd party sites
  • get additional inspiration or avoid going into similar style created already by the others
  • automatically set keywords for your artwork.

Similarity plugin for Adobe Illustrator and CorelDRAW is coming soon...

Features

  1. Suggesting and store keywords for your image based on automatic classification
  2. List web links to copies of your images over the web as:
    • Fully matched images
    • Partially matched images
    • Web sites where image was matched
  3. List web links to images similar to yours. Similar images may be:
  4. downloaded and opened in Photoshop as:
    • floating windows
    • tiles
    • tabs
    • opened in your default browser
  5. Save summarized text report with all the detected descriptions and web links to copies and similar images.

Requirements

  1. Adobe Photoshop. Tested on Windows and CS4 and CC 2017.1.0.
    Not tested on Macintosh, but theoretically should work as well.
    *If you have got a Mac - try and let me know about issues if any.
  2. Google Cloud Platform account with Cloud Vision API enabled. At moment of writing this article, Google offers cloud services with free trial + extra 300$ to be used within one year period.

No costs of use in most cases

You can download and use Krasbit Similarity for free. However, this script communicates with Google Cloud Vision API / Web Detection feature. It may generate costs at your Google Cloud Platform billing if you will exceed a monthly limit of 1000 requests and your initial 300$ gift from Google is already spent. Visit Google Cloud Vision API on your own to get any updates on pricing and limits. At moment of writing this article they are as follows:

  • first 1000 units per month is free
  • every next 1000 requests will cost 3.5$

Setup

Obtain an API Key from Google

  1. Visit https://cloud.google.com/vision/
  2. Click TRY IT FREE button.
  3. You may sign in to Google using your existing gmail account or create a new one.
  4. Read the Terms of Service and accept them
  5. Setup your billing information
  6. Once you are up and running at Google Cloud Platform console, expand the main menu button at upper left corner
  7. Browse to APIs & services
    • Library
      • Search for “Google Cloud Vision API” and enable this API
    • Credentials
      • Click Create credentials
      • Select: API Key - this will generate a long string with random characters. You will need to copy / paste it later into Krasbit Similarity Setup Window
      • Keep your generated key in secret and do not share it. This key is related to you your billing account and all the requests made with use of it - will be accounted into your billing account.
      • If your computer that will run Photoshop and Similarity script runs on a network with static IP address - consider to configure additional restriction for your API Key so it can only be used with that given IP address

Install script manually

For maximum compatibility with variety of Photoshop versions, Similarity is published as ExtendScript .jsx file and all the interface is based on ScriptUI.

  1. Extract zip archive
  2. Close Adobe Photoshop
  3. Copy Krasbit_Similarity_Photoshop_min.jsx file into Photoshop script default folder. On Windows, this is in most cases:
    C:\Program Files\Adobe\Adobe Photoshop {VERSION NUMBER}\Presets\Scripts
  4. Start Adobe Photoshop
  5. The goal of script is to analyze active document. Create or open any image.
  6. Run
    Menu: File -> Automate-> Similarity...

Install via Adobe Extension Manager

TBD...

Usage

Once you have both API key from Google Cloud Platform and Similarity script installed - run script via menu item:

Menu: File -> Automate-> Similarity...

For the first time you run that command - you will see a Setup Window where you need to configure crucial, initial settings.

Setup Window

 

API Key

Copy / Paste here a random characters string of API Key that you have generated earlier at Google Cloud Console.

Usage counter

Will count and display the amount succesfully finished request calls you have made so far to Cloud Vision API. It may help you keep your use of service under the free limit / month and avoid any costs from Google.

Reset Counter

Hit this button to reset your Usage counter. By example at the day when your monthly Google billing period starts.

Download options

This panel controls target folder where script will be downloading similar images from web, in order to open in Photoshop next to your original image. This folder also may store automatically generated textual reports from results of your search.

Browse

Click to open system browse to folder dialog and specify desired location.

Folder

Shows the current settings of target download folder.

Skip setup dialog next time

You may prefer to go through this dialog only once so check this option in order to display search results at Main Window immediately. You can back to Setup Window from Main Window at any time.

Search

Click “Search” button to send Cloud Vision API request and display search results that will be presented on the Main Window.

Cancel

Will close the window with no more actions.

Main Window

Found image descriptions

This panel will show you a suggested descriptions for your image as a checkboxes you can select. Every image may generate a different set of checkboxes due to how machine learning image analysis service from Google is understanding your image. Selected checkboxes from this panel may be transferred into Image keywords. This may help you later to search or filter images by any software capable to work with keywords like Bridge or Lightroom.

Save selected descriptions into image keywords

Use this checkbox to enable / disable transferring selected descriptions into active document  keywords.

Select all

Will quickly select all suggested descriptions for you.

Deselect all

Will quickly deselect all suggested descriptions for you.

Found images and pages

This panel displays four tabs with a search results and web links to exact copies or visually similar images and the quantities it found. You may double click any list item in order to open the link in default browser.

Visually similar images

Contains the list of images that machine learning image analysis service of Google consider as images similar to yours.

Full matching images

Contains the list of images that are considered as a copy of your image.

Partial matching images

Contains the list of images that are considered as a partial copy of your image.

Pages with matching images

Contains the list of websites where all the matching images were found.

Download and show images options

In case of Visually similar images, you may automatically download up to 10 images from list and place them next to your working active document in order to compare or get additional inspiration and thoughts. You can control the way how script will show downloaded images. With following options:

Show similar images as

  • Window - will open each image as new float window,
  • Tile - will open images as tile,
  • Tabs - will open images as tabs,
  • Browser - will open images in default browser

Maximum number of similar images to download

Limit the number of automatic download and open in Photoshop to given number from 0 - 10. If you will specify 0, then script will skip downloading and opening of similar images, and just create a textual report file or transfer descriptions to keywords for active document.

Keep downloaded files

Whatever to keep or delete similar image files that were downloaded after they were loaded into Photoshop interface.

Create and show report file

Select this checkbox to produce and open a textual version of summarized report with descriptions and links that were presented in dialog.

Cancel

Will close the window with no more actions.


Examples

Random Han Solo image found at Google images:

Wikipedia: Harrison Ford as Han Solo in promotional image for Star Wars

Search results at Main Window

Adobe Photoshop with automatically downloaded images shown as Tile.

Report file text

Krasbit  - Similarity report. Version 1.1.0 | © 2017 KRASBIT Jarosław Kraska | https://www.krasbit.com 

Found image descriptions:
Han Solo;Chewbacca;Star Wars;Harrison Ford;Star Wars;Star Wars sequel trilogy;Film;Jedi;Star Wars Day;The Force

Full matching images:
https://www.technobuffalo.com/2015/07/07/star-wars-spinoff-about-young-han-solo-in-the-works/
https://www.technobuffalo.com/2017/09/20/han-solo-kessel/
https://www.reddit.com/r/StarWars/comments/6bpbe1/i_really_hope_they_remembered_that_he_said_this/
https://aminoapps.com/page/star-wars/6474623/han-solo
https://aminoapps.com/page/star-wars/4942481/han-solo
https://www.pinterest.com/allthingssw/han-solo/
https://www.pinterest.com/lisasunshinegrl/han-solo/
https://www.newrisingmedia.com/all/2013/2/15/harrison-ford-to-return-as-han-solo-in-star-wars-episode-vii.html
http://www.digitalspy.com/movies/feature/g24557/star-wars-concept-art-original-designs/
https://twitter.com/tonystiles/status/494002809214615552?lang=en

Partial matching images:
https://www.neostuff.net/wp-content/uploads/2016/01/Han-Solo.jpg
https://i.ytimg.com/vi/T1tTGRvOPeo/maxresdefault.jpg
http://www.tapeciarnia.pl/tapety/normalne/34634_star_wars_harrison_ford_stoi_uzbrojony.jpg
https://www.technobuffalo.com/wp-content/uploads/2014/08/Han-Solo-han-solo-21177409-1280-1024.jpg
http://www.confrerie-des-traducteurs.fr/forum/upload/Isis/Isis_1444923590_Han_Solo_han_solo_21177409_1280_1024_Copie.jpg
http://1.bp.blogspot.com/-2rx1hBtp6Nc/UNA2YWoG7-I/AAAAAAAAAVk/sgw2raSYJE4/s1600/Han+solo+1.jpg
https://lh3.googleusercontent.com/-nCc9gxmBV8k/VmCbrq8lEjI/AAAAAAAAAUk/PVm-BQPAAXM/s1280/Photo%25252020151203094429706.jpg
http://3.bp.blogspot.com/-FLZOv3tjBYQ/VFOFHT8DzTI/AAAAAAAAFdo/E-zR6ODizuI/s1600/z.jpg
http://livedoor.blogimg.jp/drazuli/imgs/0/6/06a11892.jpg
https://modaellos.com/wp-content/uploads/2015/02/carnaval-2011-disfraces-hombre-disfraz-de-han-solo.jpg

Pages with matching images:
https://www.technobuffalo.com/2015/07/07/star-wars-spinoff-about-young-han-solo-in-the-works/
https://www.technobuffalo.com/2017/09/20/han-solo-kessel/
https://www.reddit.com/r/StarWars/comments/6bpbe1/i_really_hope_they_remembered_that_he_said_this/
https://aminoapps.com/page/star-wars/6474623/han-solo
https://aminoapps.com/page/star-wars/4942481/han-solo
https://www.pinterest.com/allthingssw/han-solo/
https://www.pinterest.com/lisasunshinegrl/han-solo/
https://www.newrisingmedia.com/all/2013/2/15/harrison-ford-to-return-as-han-solo-in-star-wars-episode-vii.html
http://www.digitalspy.com/movies/feature/g24557/star-wars-concept-art-original-designs/
https://twitter.com/tonystiles/status/494002809214615552?lang=en

Visually similar images:
http://www.fansshare.com/photos/harrisonford/star-wars-han-solo-harrison-ford-han-solo-605404650.jpg
https://i.pinimg.com/736x/18/c7/ee/18c7ee8b164cc95e5d2b0612264264ea--star-wars-episode--episode-iv.jpg
https://denverartmuseum.org/sites/default/files/slides/Media%20browser/Han-Solo.jpg
http://costume.box23.net/images/badger-solo-ref.jpg
https://guideimg.alibaba.com/images/shop/2015/08/18/83/sideshow-heroes-of-the-rebellion-collectibles-star-wars-deluxe-12-inch-action-figure-han-solo-smuggler-tatooine_7939683.jpeg
http://www.actiontoys.com/Merchant2/graphics/00000001/SWSIDE12-HAN.jpg
https://images-na.ssl-images-amazon.com/images/I/41FsJUXiOzL.jpg
http://d2ydh70d4b5xgv.cloudfront.net/images/4/0/vintage-1977-star-wars-action-figure-big-head-han-solo-original-blaster-8cef388200e59088e9c7ea8106c8ef2d.jpg
https://www.sideshowtoy.com/mas_assets/jpg/7118_press01-001.jpg
https://images-na.ssl-images-amazon.com/images/I/61xGwvK1biL._UY445_.jpg

 

Self-made sample. *Picasso mode enabled ;)

Adobe Photoshop with automatically downloaded images shown as Tile.

Report file text

Krasbit  - Similarity report. Version 1.1.0 | © 2017 KRASBIT Jarosław Kraska | https://www.krasbit.com 

Found image descriptions:
Font;Logo;Brand;Black and white;Area;Angle;Black;White

Visually similar images:
http://clipart-library.com/images/8cAb9kaRi.jpg
https://i.pinimg.com/736x/2b/62/a1/2b62a18ea87987090953ce916734fc00--chinese-tattoos-chinese-writing.jpg
https://i.pinimg.com/736x/ce/09/44/ce0944b14b0961f8dc2d0f26968958b9--friendship-tattoos-sister-tattoos.jpg
https://thumb7.shutterstock.com/display_pic_with_logo/831460/675124009/stock-vector-faith-hope-love-calligraphy-word-design-from-bible-verse-inspiration-in-color-black-and-white-675124009.jpg
https://i.pinimg.com/736x/4f/0d/f8/4f0df84dd160c956d937ccac01c7b7c5--simbolos-chineses-chinese-decorations.jpg
https://thumb7.shutterstock.com/display_pic_with_logo/2327279/275112401/stock-vector-thank-you-hand-lettering-custom-handmade-calligraphy-vector-275112401.jpg
https://thumb9.shutterstock.com/display_pic_with_logo/3323144/693207022/stock-vector-beer-fest-phrase-ink-illustration-modern-brush-calligraphy-isolated-on-white-background-693207022.jpg
https://thumb7.shutterstock.com/display_pic_with_logo/1877789/398470657/stock-vector-faith-hope-love-handwritten-faith-hope-and-love-calligraphy-words-vector-lettering-398470657.jpg
https://thumb9.shutterstock.com/display_pic_with_logo/3908108/521817442/stock-photo-hello-winter-text-brush-lettering-hello-winter-card-design-with-custom-calligraphy-winter-521817442.jpg
https://thumb7.shutterstock.com/display_pic_with_logo/1184516/701543995/stock-vector-autumn-sale-hand-drawn-calligraphy-and-brush-pen-lettering-design-for-holiday-greeting-card-and-701543995.jpg

Download

Files:
Author Jarosław Kraska
Date 2017-12-01
Language  English
File Size 12.35 KB
Download 6

Author Jarosław Kraska
Date 2017-12-01
Language  English
File Size 2.49 MB
Download 5