Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/FarisHijazi/SuperGoogleImages
Userscript to 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
https://github.com/FarisHijazi/SuperGoogleImages
Last synced: 12 days ago
JSON representation
Userscript to 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
- Host: GitHub
- URL: https://github.com/FarisHijazi/SuperGoogleImages
- Owner: FarisHijazi
- License: apache-2.0
- Created: 2019-04-03T09:36:01.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-06-14T11:11:05.000Z (5 months ago)
- Last Synced: 2024-10-27T12:48:45.966Z (15 days ago)
- Language: JavaScript
- Homepage:
- Size: 14 MB
- Stars: 33
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SuperGoogleImages: a browser addon for Google Images
A browser-plugin/[script](https://openuserjs.org/about/Userscript-Beginners-HOWTO) to add features to [Google images](https://www.google.com/search?q=example&tbm=isch&safe=strict).
## 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](#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](install:tampermonkey-chrome))
1. Install [Tampermonkey](install:tampermonkey-chrome) for your browser (or any [UserScript client][guide:get-user-script]).
2. Click [DOWNLOAD][download-link] (or visit the RAW file url).
3.
Allow downlaods. (Optional) (Click to expand)
-
EnableBrowser 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](https://www.google.com/search?q=metal+sslug+pixel+art&tbm=isch&tbs=itp:animated&safe=strict) 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](https://kiwibrowser.com/) 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 **b**y image |
| | |
## Documentation
- The [docs](docs/doc.md) file contains info about the code and any complicated parts.
- The [reverse engineering](docs\ReverseEngineering.md) 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](https://codesandbox.io/s/vue-json-transpose-dt915?from-embed).
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
- [x] fix navbar, add buttons to hide and show
- [x] navbar move hide/show buttons to be next to eachother
- [x] 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
- [x] 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
- [x] SO SLOW!!!! Must optimize
- [ ] panels
- [x] 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
- [x] 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
- [x] related images don't have onhoverListeners
Actions that must be taken:
- [x] 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
- [x] image boxes
- [ ] images
- [x] 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](lib/Google%20Direct%20Links%20for%20Pages%20and%20Images.user.js), [[source]](https://greasyfork.org/scripts/19210-google-direct-links-for-pages-and-images/code/Google:%20Direct%20Links%20for%20Pages%20and%20Images.user.js)
### Libraries
these are used via UserScript `@requires` tags
- [jQuery](https://jquery.com/)
- [Mousetrap.js](https://github.com/ccampbell/mousetrap) keybindings
- [progressbar.js](https://github.com/kimmobrunfeldt/progressbar.js/) progress bar when downloading
- [JSZip](https://github.com/Stuk/jszip) zip and compress functionality
## License
[Apache License](LICENSE.md)
Version 2.0, January 2004
[guide:get-user-script]: https://openuserjs.org/about/Userscript-Beginners-HOWTO#how-do-i-get-going-
[guide:userscript]: https://simply-how.com/enhance-and-fine-tune-any-web-page-the-complete-user-scripts-guide#section-2
[guide:browser-API-beta]: https://www.tampermonkey.net/faq.php#Q302
[guide:browser-API-beta-gif]: https://www.tampermonkey.net/images/animated/gm_download.gif
[download-link]: https://github.com/FarisHijazi/SuperGoogleImages/raw/master/SuperGoogleImages.user.js
[install:tampermonkey-chrome]: https://www.tampermonkey.net/index.php?ext=dhdg&browser=chrome
[chrome-icon]: https://imgur.com/3C4iKO0.png
[firefox-icon]: https://imgur.com/Dy442GK.png
[edge-icon]: https://imgur.com/RlmwPGO.png
[opera-icon]: https://imgur.com/nSJ9htU.png
[safari-icon]: https://imgur.com/ENbaWUu.png
[webbrowser-icon]: https://imgur.com/EuDp4vP.png
[brave-icon]: https://imgur.com/z8yjLZ2.png
[torr-icon]: https://imgur.com/uhb8M86.png