elssuh / supergoogle

Super-charge Google images with rich features, like: download all full-resolution images, replace thumbnails with full-res images, add "view image" and "download" buttons and much more

SuperGoogle: 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

---

Table of contents:

• SuperGoogle: a browser addon for Google Images
  • Key features:
  • Installation
    • UserScript (Tampermonkey)
    • Browser extension
  • Usage
    • Download all the images
    • Display original images
    • Enhance the image panels
    • Hotkeys
  • Documentation
  • External Libraries
    • Libraries
  • Contributing
  • License

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 enjoy the enhanced experience

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.

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

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

Contributing

• Fork it!
• Create your feature branch: git checkout -b my-new-feature
• Commit your changes: git commit -am 'Add some feature'
• Push to the branch: git push origin my-new-feature
• Submit a pull request!

License

Apache License
Version 2.0, January 2004