Bulk Media Harvester

Version: 0.4.0 License: Mozilla Public License 2.0 (MPL-2.0)

A powerful browser extension for capturing, organizing, and downloading media resources from websites you visit. Features advanced filtering, batch renaming, undo/redo functionality, and more.

Features

Core Functionality

• Automatic Media Detection - Captures images, videos, and audio files as you browse
• Advanced Filtering - Show only specific domains or MIME types, filter them out, or block them permanently
• Sorting - Sort by size or timestamp with visual indicators
• Batch Operations - Select multiple items for downloading or batch renaming
• Undo/Redo - Full undo/redo support for all filter, sort, and rename operations
• Preview - Hover over links to preview images and videos before downloading
• Drag and Drop - Manually reorder items by dragging rows

Filtering Options

• Only (show ONLY matching items)
  • Only specific domain
  • Only specific MIME type
• Filter (hide matching items temporarily)
  • Filter by domain
  • Filter by MIME type
• Block (hide matching items permanently)
  • Block domain forever
  • Block MIME type forever

Renaming

• Individual Rename - Right-click any filename to rename it
• Batch Rename - Add numbers or prefixes to multiple files at once
• Smart Extension Handling - Automatically preserves file extensions when renaming
• All rename operations can be undone

Advanced Features

• Action History - Right-click Undo/Redo buttons to view full history and remove specific actions
• External Download Managers - Optional integration with IDM, FDM, wget via "External Application Button" extension
• RegExp Matching - Filter items using regular expressions
• Persistent Settings - All preferences saved locally in your browser

Important Usage Notes

⚠️ Please read to avoid common misconceptions:

1. Does nothing on its own - You must continue to navigate the page normally
2. Already loaded pages - If a page is already loaded, try refreshing it to capture media
3. Thumbnails - Will NOT expand thumbnails into full-size images - you must open links/galleries yourself
4. Cached websites - If a website is fully cached, media may not appear here
5. Download location - Cannot change download location - that's controlled by your browser settings

Basically: We only harvest links to media that your browser has loaded. YOU have to load the media by browsing normally.

Installation

Firefox

Install from Mozilla Add-ons (pending submission)

Chrome/Edge

Install from Chrome Web Store (coming soon)

Manual Installation

1. Clone this repository
2. Open your browser's extension management page
3. Enable "Developer mode"
4. Click "Load unpacked" and select the v3 directory

How to Use

1. Navigate normally - Browse websites as you usually would
2. Click extension icon - Open the Bulk Media Harvester panel
3. Media appears automatically - Images, videos, and audio will be listed as they load
4. Filter and organize - Use right-click menus to filter by domain or MIME type
5. Rename if needed - Right-click filenames to rename individually or in batch
6. Sort - Click column headers to sort by size or timestamp
7. Download - Select items and click "Download" button
8. Undo mistakes - Use Undo/Redo buttons to revert any changes

Privacy

This extension does NOT collect, store, or transmit any personal data to external servers.

• All data stays on your device
• No analytics or tracking
• No third-party services
• Local storage only (preferences, block lists)
• Open source for full transparency

See PRIVACY.txt for full privacy policy.

Permissions

• storage - Save your preferences locally
• webRequest - Monitor network traffic for media detection
• downloads - Download media files
• notifications - Show status messages
• contextMenus - Add right-click menu options
• http://*/* and https://*/* - Detect media on websites you visit

Development

Project Structure

v3/
├── manifest.json          # Extension manifest
├── worker.js              # Background service worker
├── PRIVACY.txt            # Privacy policy
└── data/
    ├── window/
    │   ├── index.html     # Main UI
    │   ├── index.css      # Styles
    │   ├── index.js       # Core logic
    │   ├── elements.js    # DOM utilities
    │   ├── persist.js     # Storage handling
    │   ├── undo-redo-menu.js  # Undo/redo UI
    │   └── external.js    # External app integration
    └── icons/             # Extension icons

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Credits

• InBasic - Original addon creator
• William Cody Laeder - Enhancements and maintenance
• Muhammad Naufal Subhiansyah - Icon design

Support

For questions, issues, or feature requests:

• Open an issue on GitHub

License

This extension is licensed under the Mozilla Public License 2.0 (MPL-2.0).

See the repository for full license text.