One-click Downloader

Development of this extension was stopped on January 30, 2021. The extension will function as long as there are no incompatible API changes. The download functionality will be broken when the hosters change their sites.

Description
-----------

This Chrome/Chromium extension allows you to mass-download images from common one-click hosters (like ImageVenue, imgur, ImageBam, etc.) usually used on various image boards and websites.

This extension comes fully localized in German and English and does not need any 3rd-party applications installed on the computer. All you need is your web browser and this extension!

Usage
-----

You might want to set up Chrome so it does not ask where to store the downloads but automatically downloads them without bringing up the save-as dialog.

1. Open the tabs you want to scrape
2. Run the extension
3. Select the tabs from the tabs list and click “Scrape tabs”
4. Select the links of the images you want to download, or select all of them
5. When set: Enter the download path relative from you default download folder
6. Click “Download images” and wait until all images are downloaded
7. Close the window or start over

It is possible to “shift select” the entries in the tabs list or in the images list after scraping. Simply click a checkbox to set it to a state of your liking and then shift-click another checkbox to check all checkboxes between the initially clicked checkbox and the shift-clicked checkbox to the same state.

There are also some variables to use for the file name or the download path. See “Variables Help” from the images download section of the extension.

Currently supported hosters
---------------------------

Because of Googles automatic service for detecting malicious extensions always detecting the list of supported hosters as a *false positive* it is not possible to provide a list of supported hosters anymore in the extension description for checking if the extension matches the intended use case.

Listing the hosters via the extension’s configuration after installing the extension is not affected by this.

Add hosters
-------------------

Adding hosters needs some Javascript. A technical documentation on how to do this is available in `downloader/hosters.js`.

A word on permissions
---------------------

This extension uses some permissionsthat might be seen as critical by some users. Besides the fact that interested users can check the extension’s code at GitLab, the following permissions are needed.

1. **tabs** for extracting the page’s title and collecting the tab ID for injecting the necessary Javascript code for image collection.
2. **downloads** to initiate the image downloads.
3. **storage** for reading and writing the extension’s options.
4. **all_urls** because the extension needs “write permission” on all pages for injecting the necessary Javascript code for image collection.

Feel free to analyze the code at GitLab.

A word on the version number
----------------------------

The version number is actually not only a version number. It is a version string which contains two informations. The first quarter is the version number without dots (1.2.3 becomes 123). The second to fourth quarter represents the date of when the last hoster was added to the “database”. It written in ISO 8601 format (YYYY-MM-DD) without leading zeros and dashes replaced by dots (2015-05-21 becomes 2015.5.21).

The Chrome Web Store uses the version string and displays it correctly (Version number, space, date).

Bugs
----

Sometimes the images get not recognized the first time. I set a short waiting period for chrome inserting the necessary Javascript code to the website displayed in the selected tab(s), but sometimes it takes too long. Simply restart the process and the images will be there.