Videos Imges Downloader

About

Videos Imges Downloader is a Manifest V3 browser extension for Chrome and Microsoft Edge. It helps users save legally accessible videos and images from the active tab, direct user-provided links, manually configured gallery pages, and explicit screen recordings of the current tab.

The extension is intentionally bounded: it does not decrypt media, bypass DRM, bypass paywalls, bypass login restrictions, evade CORS or site controls, impersonate user agents, or perform hidden downloads. All metadata and saved files stay local in the browser profile.

## Features

- Active-tab media detection from browser network response metadata.
- Direct media export through the browser Downloads flow.
- Local offline library backed by IndexedDB.
- Manual screen recording with `chrome.tabCapture` and `MediaRecorder`.
- Current-page image scanning across `img`, `srcset`, linked files, and CSS image references.
- Deep-link image extraction for page-provided original URLs such as `imgurl`, `mediaurl`, and `murl`.
- Image export scale controls for preferring larger responsive/original image candidates.
- User-configured gallery/catalog crawl with origin and page limits.
- Popup, side panel, offline library, settings, onboarding, and progress pages.
- Light, dark, and system themes.
- Chrome and Edge builds from one codebase.

## Keywords

video downloader, image downloader, screen recorder, tab recorder, screen recording, offline media, Chrome extension, Edge extension

## Categories

Productivity, Photos, Screen Recording, Video Tools

## Requirements

- Node.js 20.11 or newer.
- pnpm 10.15 or newer. If the bare `pnpm` command is not on PATH, use `corepack pnpm` for the commands below.

```powershell
npm run bootstrap
```

## Install Dependencies

```powershell
corepack prepare [email protected] --activate
corepack pnpm install
```

## Build

```powershell
pnpm build
```

Build output:

- `dist/chrome`
- `dist/edge`

## Load in Chrome

1. Open `chrome://extensions`.
2. Enable Developer mode.
3. Choose Load unpacked.
4. Select `dist/chrome`.

## Load in Microsoft Edge

1. Open `edge://extensions`.
2. Enable Developer mode.
3. Choose Load unpacked.
4. Select `dist/edge`.

## Test

```powershell
pnpm test
pnpm typecheck
pnpm validate
```

Optional Playwright extension smoke test:

```powershell
pnpm build:chrome
pnpm test:e2e
```

## Package

```powershell
pnpm package
```

Release archives are written to `release/`.

## Project Structure

- `apps/extension` - MV3 React extension app.
- `packages/core` - shared TypeScript logic for validation, storage, scanning, manifests, settings, and queues.
- `scripts` - build, validation, versioning, icon generation, and packaging tools.
- `docs` - user, developer, permission, privacy, limitation, test, and store listing notes.
- `media/videos-imges-downloader` - public media source for this extension's icons, README images, store assets, and hosted policy copy. This folder is part of the Reallexi public media repository: <https://github.com/ddkits/Reallexi-Public-media-and-files>.

## Important Limitations

Videos Imges Downloader only handles content that the browser and site make legally and technically accessible. Protected, encrypted, restricted, paywalled, login-only, or unsupported streams are blocked with a user-facing message.

See [docs/LIMITATIONS.md](docs/LIMITATIONS.md) for details.