Browser Extension

Seamless integration between your web browser and DLMan desktop app. Capture downloads from Chrome, Firefox, and Edge.

Chrome& Brave

FirefoxAdd-ons Store

EdgeChromium

Features

Auto-Intercept

Automatically intercepts browser downloads and sends them to DLMan for accelerated downloading.

Context Menu

Right-click any link to download with DLMan. Works on files, images, and media.

Batch Downloads

Download all links on a page at once. Filters by file type and pattern.

Per-Site Settings

Disable DLMan on specific websites. Your rules are synced across browser sessions.

Cookie-Based Auth

Automatically passes session cookies for authenticated downloads. No manual setup needed.

Real-time Status

Shows connection status and active downloads in the popup. Visual feedback for every action.

Installation

Chrome / Edge / Brave

Download the extension zip from GitHub Releases

Extract the zip file to a folder

Navigate to chrome://extensions

Enable Developer Mode (top right toggle)

Click Load Unpacked and select the extracted folder

Firefox

Install directly from the Firefox Add-ons Store. No developer mode needed.

How It Works

The extension communicates with the DLMan desktop app through a local HTTP/WebSocket server on localhost:7899.

Communication Flow

Intercept

Extension intercepts download or receives right-click action

Request

Sends request to DLMan's local server on localhost:7899

Dialog

DLMan opens the New Download dialog via deep link

Configure

You set destination, queue, and segment count

Download

Download starts with full multi-segment acceleration

API Endpoints

Method	Path	Description
GET	/ping	Health check
GET	/api/status	Get app status
GET	/api/queues	List download queues
POST	/api/downloads	Add a new download
POST	/api/show-dialog	Show new download dialog
WS	/ws	WebSocket for real-time updates

Architecture

Background Script

src/entrypoints/background.ts

Manages extension lifecycle, handles download interception, communicates with the desktop app, and sets up context menus.

Content Script

src/entrypoints/content.ts

Runs on web pages. Detects downloadable links, handles deep link opening for dialogs, and collects page information.

Popup UI

src/entrypoints/popup/

Shows extension status, displays active downloads, and allows quick configuration without leaving the page.

API Client

src/lib/api-client.ts

WebSocket and HTTP client for desktop app communication. Handles request/response matching and connection lifecycle.

Configuration

Access extension settings through the popup or options page:

Enable/Disable

Toggle download interception globally

Port

Desktop app port (default: 7899)

Auto-intercept

Automatically intercept browser downloads

Fallback to browser

Use browser downloads when DLMan is not running

Intercept patterns

File patterns to intercept (e.g., .zip, .exe, .dmg)

Troubleshooting

Extension Not Connecting

·Ensure DLMan desktop app is running
·Check that the port matches (default: 7899)
·Look for error badge ("!") on the extension icon

Downloads Not Intercepted

·Verify "Auto-intercept" is enabled in settings
·Check that the file type matches intercept patterns
·Ensure the site is not in the disabled list

Deep Links Not Working

·Ensure DLMan is registered as protocol handler
·On macOS: Check System Settings → Default Apps
·Try restarting the desktop app

← CLI Reference

Command-line interface

Architecture →

System design and technical details