SuperGoogleImages: a browser addon for Google Images

A browser-plugin/script to add features to Google images.

Watch demo video

Key features:

• Download all full quality images in a single click (as zip or individually)
• Bring back the old view image button! (Now you won't have to visit the website just to see the fullres image)
• Add download button Directly download the image
• Replace thumbnails with full resolution images. (also animates all GIFs)
• replace google redirect links

All features

---

WARNING: everything is very experimental up till now, there is a major reboot coming soon of the script. Thanks to Google for changing their HTML every few months and making life difficult.

Also most of the features listed bellow are actually not working anymore

Other similar and promising projects:

• https://github.com/bijij/ViewImage
• https://gist.github.com/bijij/58cc8cfc859331e4cf80210528a7b255/

I am also working on reverse engineering extracting the links for the full resolution images

---

Installation

UserScript (Tampermonkey)

1. Install Tampermonkey for your browser (or any UserScript client).
2. Click DOWNLOAD (or visit the RAW file url).
3. Allow downlaods. (Optional) (Click to expand)

   • Enable Browser API.
     
     
     • Go to the Tampermonkey options page
     • Scroll down to the Downloads section
     • Double-check the Whitelisted File Extensions setting to not contain file extensions of executable files
     • Select Browser API at the Download Mode option
     • A notification may come up, you need to click at it and to click confirm at the permission grant dialog
   • When prompted, allow the script to load images, click Always allow all domains (only needed once).
     
4. Open any google image search page and press on the button "Display originals" at the top (or hold Ctrl and hover over the images with your mouse)

On mobile

for mobile, download a browser that supports the tampermonkey addon like kiwibrowser and follow the same steps above

Browser extension

Not yet supported, but coming soon!

Usage

Below is a list of the available features, sorted by most useful first.

Download all the images

You can download all the loaded images as a zip file or indipendantly (although this option is not advised due to it causing crashes).
You can even specify the minimum dimension for images using the sliders (to only download large images for example).

Display original images

One of the most important features, replaces thumbnails with the original source images, even GIFs!

Enhance the image panels

Adds the following features to the image panel:

• 1 - Add view image button

  Bring back the old view image button! Now you won't have to visit the website just to see the fullres image.

• 2 - download button

  Directly download the image

• 3 - Clickable description

  Lookup the description text, open another Google images page searching for the description text

• 6 - Clickable image host text

  Click the image host to search google for more images from that site. For example if it was hosted by example.com, then clicking it would open a google image search of "site:example.com"

• 7 - Download Related button

  Click to download this image and all the related images (the ones on the bottom right)

Hotkeys

Global hotkeys

Hotkey	Action
O O	Enable display original images
s s	Force disable safe search (using ipv4.google.com)

Panel-specific (hotkeys that work for an image panel when it is open)

Hotkey	Action
o	Display original images for current panel
UpArrow	Go to previous related image
DownArrow	Go to next related image
b	search by image

Documentation

• The docs file contains info about the code and any complicated parts.
• The reverse engineering contains info about how the website works and the main components it contains (based on observations), such as the CSS selectors for the panels and components, where the info is kept in the page, where thumbnails are loaded and where main images are.

Logs

Dec-2019 backend update

Google changed their webpage HTML AGAIN! :( And now the images aren't in .rg_meta, they're hidden somewhere deep in an array, this is called json transpose. And also the CSS selectors for the elements have been changed, they used to make sense but now they're just gibberish.

Notes and observations:

• so many anchor.href === "https://www.google.com/null" Reason was that 3361: return normalizeUrl(this.getAttribute('href')); href was null, and normalizeUrl was forcing it to be a string.
• I noticed that when you right-click, you get the correct URL, but when running showImages(), the anchor.href is null.
• pretty much all the google functions are inside an object called _
• clicking the images all the time causes issues. Such as unresponsiveness, ruining the panels (all 3)

Development TODO list

• add button to download ris images
• fix navbar, add buttons to hide and show
• navbar move hide/show buttons to be next to eachother
• navbar fix that invisible thing that blocks everything
• add hotkey to go to (s)earch or (i)mages
• add a listener when a panel appears, to get the same image that the imgbox is using, cuz usually it's blocked or sth so we should just use the one on the imgbox
• bug: sometimes image anchors are not replaced, they stay https://www.google.com/imgres?imgurl=, and then it fails to load and then it uses DDG proxy
• SO SLOW!!!! Must optimize
• panels
  • related images don't actually get observed and don't get direct links replaced
  • fix download button (it)
• there is some null text on the top left corner
• remove unneeded buttons and hotkeys
• select image slider isn't selecting the images. none are qualified for some reason.
  • the reason is that the width and height are not in the meta object
• related images don't have onhoverListeners

Actions that must be taken:

• image null URLs are turning into "null" strings, this must be stopped. the anchor is having a null href, that's one of the reasons
• update selectors
  • should put them all in Consts.Selectors
  • navbar
  • image boxes
  • images
• get image meta info. (This is from the script json transpose)

External Libraries

This script does use several other external libraries and scripts, they will be listed below with links to their sources.

Scripts

• Google Direct Links for Pages and Images.user.js, [source]

Libraries

these are used via UserScript @requires tags

• jQuery
• Mousetrap.js keybindings
• progressbar.js progress bar when downloading
• JSZip zip and compress functionality

License

Apache License
Version 2.0, January 2004