Skip to content

Latest commit

 

History

History
172 lines (144 loc) · 6.07 KB

readme.md

File metadata and controls

172 lines (144 loc) · 6.07 KB

Image Viewer

Image Viewer is a manifest V3 Chrome extension that improves your image viewing experience.

If you like this extension, you can buy me a coffee

Features

  1. Collect and view all images on the page.
  2. Support video posters, canvas element and images in iframes.
  3. Auto replace lazy loaded or resized images with original image.
  4. Redirect middle click to original image to open link you want.
  5. Go to original image on the page.
  6. Fit, zoom, rotate and mirror the image.
  7. Hotkey for image reverse search.
  8. Download collected images.
  9. Easy to use.
  10. And more...

Installation

Web Demo (Does not include some extension-only features)

You can install release version from Chrome Web Store or development version follow steps below:

  1. Download the source code and place it anywhere you want.
  2. Open your browser and go to chrome://extensions.
  3. Enable Developer Mode.
  4. Click the "Load Unpacked" button and select the folder with the source code.

Note: Any tabs opened before the installation require a reload.

How to use

After adding this extension to your browser, it is recommended to pin it to the toolbar.

For image tabs, Image Viewer will be activate automatically.

For normal websites, you can activate Image Viewer by choose this extension from the right-click menu, click its icon on the toolbar or use keyboard hotkey (default Alt+1).

For additional options, right-click the extension icon on the toolbar. You can start the Image Viewer with disabled size filter or start with the last picked image (use it when the right-click menu is disabled by the website).

Action Controls
Pick image
(size filter will use this image as reference)
right-click on the image
View previous/next image wasd
Scroll on the control bar
Scroll on the close button
Fast navigation
(10 images, no throttle)
Ctrl+
Auto navigation / Slideshow
(until end or user interrupt)
Shift+
Go to original image on page Enter
click "Move To" button on the control bar
middle-click the original image
(Open tab for post, video, etc.)
middle-click on the image
space or 0 (both number row and numeric keypad)
Fitting image Click fitting buttons on the control bar
Move image click and drag
Ctrl+Alt+wasd
Reset image double-click anywhere
Zoom image Scroll on the image
Alt+ws
Rotate image Hold Alt and scroll
Alt+ad
Mirror image Hold Alt and click
Image reverse search Press the hotkeys defined in setting
Change background color
(loop: transparent -> black -> white)
Shift+b
Download collected images Shift+d (default)
Enable auto scroll Shift+r (default)
Close Image Viewer ESC or NumpadAdd
Click the close button
Close current tab right-click the close button

Browser support

The entire project was written in Vanilla JavaScript with extension API supported by Chromium-based browsers. It should also work on Firefox, but it has not been tested yet.

The standalone image-viewer.js should work on all modern browsers, and you can integrated into your own website with own collect image script.

You may also use image-viewer.js with your own script with Tampermonkey or other alternatives.

ToDo

  1. image-viewer.min.js
  2. support more image display mode

History

The prototype of this project was created by Eky Kwan under the MIT License, and the author of the translations in _locales is unknown. The first release v0.1 was launched on 2012-07-05, and the last release v0.1.6 was on 2012-08-12. However, the license file was either lost or not included in the Chrome Web Store version.

Since I started using this extension, many new features have been added to the project. You can find the oldest version here, some mirroring websites may still have the raw version of v0.1.6.

The old version was hard to extend, and I felt tired of it in June 2022. Therefore, I decided to clean up all the old-style, messy jQuery code and rewrite the project completely. The rewrite is now complete and has also been upgraded to manifest V3.

This project is currently developed and maintained by me.

License

MIT license