Download to Index Autor: Houdini99

Download to Index adds a "Download to Index" entry to your right-click menu for images, videos, and audio. One click sends the media — plus your own tags — to a self-hosted media index server you control.

The extension is host-agnostic. Configure your server URL once in Settings, and right-click upload works on every site you visit.

WHAT IT DOES

• Right-click any image, video, audio element, or direct media link → "Download to Index"
• A small modal lets you confirm the URL and add optional comma-separated tags
• A floating progress pill tracks each upload (download → upload → server processing)
• Up to 2 uploads run in parallel; the rest queue automatically
• Multiple uploads can run side-by-side without blocking the page
• Smart fallbacks for tricky sites: looks past transparent overlays, walks media containers, follows <source> elements, and reads CSS background-images

SUPPORTED SITES

Works out of the box on any site that exposes media via standard HTML elements (<img>, <video>, <audio>, <source>) or direct URLs. Special handling included for:
• Telegram Web (web.telegram.org) — bypasses the nojs.mp4 anti-download placeholder by fetching from the page's own service-worker context
• WhatsApp Web (web.whatsapp.com) — same in-page-fetch approach for SW-served media

Optional yt-dlp helper (separately installed) resolves streaming URLs (HLS/DASH and supported video sites) into direct downloadable media. Without the helper, only directly downloadable media works.

PRIVACY

• No analytics, no telemetry, no third-party requests
• Uploads go ONLY to the server URL you configure
• Cookies are read only for that server (to forward your login session)
• No host permissions are granted at install — Firefox prompts for access only when you save your server URL in Settings, and the previous host's access is automatically removed when you switch servers
• Settings (server URL and helper name) are stored locally with browser.storage.local

REQUIREMENTS

• Firefox 128 or later
• A compatible self-hosted media index server. The matching backend, written by the same developer as this extension, is open source at:
https://github.com/Houdini99/media_index
• Optional: a separately-installed native-messaging yt-dlp helper for streaming-site support

GETTING STARTED

1. Install and set up your media index server (https://github.com/Houdini99/media_index)
2. Install the extension
3. Click the toolbar icon (or open about:addons → Preferences) to open Settings
4. Enter your server URL and click Save — Firefox will prompt for access to that host
5. Log in to your server in a browser tab
6. Right-click any media on any page and choose "Download to Index"

OPEN SOURCE

The extension's source code is unminified and unobfuscated. The companion server is also open source: https://github.com/Houdini99/media_index. All processing happens locally in your browser; the only network requests are the media download from the source page and the upload to your own server.