Mass Image Downloader is a Chromium Manifest V3 extension for collecting and downloading images at scale from open tabs, single pages, and multi-page galleries while keeping results filtered, named, and reproducible.

• Bulk image download across open tabs.
• Gallery extraction for direct links, visual galleries, and web-linked gallery pages.
• Format and dimension filters for JPG/JPEG, PNG, WEBP, AVIF, and BMP.
• Deterministic filename modes using prefix, suffix, both, or timestamp.
• One-click manual save overlay for selective curation.
• Image Inspector mode with preview, metadata, navigation, and save controls.
• Clipboard hotkeys for dataset labeling.
• Toast notifications, badge states, debug levels, pacing, batching, and concurrency controls.

1. Clone this repository using HTTPS or SSH:

   git clone https://github.com/del-Pacifico/Mass-Image-Downloader.git

   git clone git@github.com:del-Pacifico/Mass-Image-Downloader.git

2. Open a Chromium-based browser and go to the extensions page:

   • Edge: edge://extensions
   • Brave: brave://extensions
   • Opera: opera://extensions
   • Vivaldi: vivaldi://extensions

3. Enable Developer Mode.

4. Select Load unpacked.

5. Choose the cloned repository root folder, the one containing manifest.json.

For the long-form unpacked installation notes, see the Extended Project Overview.

1. Pin the extension icon.
2. Open the popup and choose a download mode.
3. Configure formats, size filters, naming, pacing, and gallery limits from the Options page.
4. Run the workflow from the popup or with the configured keyboard shortcuts.

Contributors can run local compliance checks before opening a pull request:

npm run check
npm test

These commands validate the extension manifest, declared paths, version alignment, command limits, required permissions, and JavaScript syntax.

Contributions should follow the project flow: feature or chore branch, PR to dev, merge to main, then tag/release.

• Documentation Hub - entry point for all manuals.
• User Manual - basic usage and workflows.
• Configuration Guides - scenario-based setup.
• Technical Manual - internal behavior and execution flow.
• Advanced Manual - design rationale, trade-offs, and edge cases.
• Extended Project Overview - the previous long-form README preserved as a reference, including Release Highlights.
• Hotkeys Policy - official shortcut policy.

• Chromium-based browser.
• Minimum Chromium version: 93.
• Manifest version: 3.
• QA tested primarily on Brave, with additional QA coverage on Microsoft Edge, Opera One, and Vivaldi.
• Google Chrome has not been validated by the project QA process.
• Browser-level shortcut conflicts or restrictions may require manual configuration.

The current public version is shown by the GitHub Release badge above.

For source-level validation, check:

• the latest GitHub tag/release
• the root VERSION file
• manifest.json

See CHANGELOG.md for release history.

Mass Image Downloader is built on a set of core principles: reliability, user control, performance, security, quality, and open collaboration.

These values guide every decision – from code architecture to user feedback design. For a deeper dive, see the full Project Philosophy document.

Contributions should follow the project flow: feature or chore branch, PR to dev, merge to main, then tag/release.

All issues, pull requests, and discussions should use the repository's descriptive label taxonomy so planning, review, and release work stay traceable.

See CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.

If Mass Image Downloader helps your workflow, consider starring the repository, opening focused issues, sharing reproducible test cases, or contributing documentation and fixes through the standard branch flow.

Responsible feedback is especially useful for gallery edge cases, browser compatibility checks, and real-world configuration scenarios.

Thank you for using Mass Image Downloader and supporting a focused, privacy-friendly tool for collecting images with predictable, browser-native workflows.

Built for power users, researchers, curators, QA teams, dataset builders, and automation workflows that need controlled output without external services, tracking, or unnecessary complexity.

Made with ❤️ by Del-Pacifico.

Mass Image Downloader is licensed under the Mozilla Public License 2.0.