HyperDL Docs

Installation

HyperDL is available for macOS, Windows, and Linux. Download the latest installer for your platform.

# macOS (Homebrew)
brew install --cask hyperdl

# Linux (Debian/Ubuntu)
sudo dpkg -i hyperdl_1.0.0_amd64.deb

# Linux (Fedora/RHEL)
sudo rpm -i hyperdl-1.0.0.x86_64.rpm

Quick Start

System Requirements

License Activation

After purchasing a plan, you'll receive a license key via email. Activate it in the app:

Download Engine

HyperDL uses multi-threaded segmented downloading to saturate your connection. Each file is split into segments downloaded in parallel, with dynamic work-stealing to keep all threads busy.

Supported Protocols

Speed Profiles

Create named speed profiles to control bandwidth and concurrency. Profiles auto-activate by schedule.

{
  "profiles": [
    {
      "name": "Work Hours",
      "speed_limit_mbps": 10,
      "max_concurrent": 3,
      "schedule": "Mon-Fri 09:00-17:00"
    },
    {
      "name": "Unlimited Night",
      "speed_limit_mbps": null,
      "max_concurrent": 10,
      "schedule": "Daily 22:00-06:00"
    }
  ]
}

Smart Scheduling

Schedule downloads for off-peak hours. Supports one-time, hourly, daily, and weekly recurring schedules. Downloads start automatically when the scheduled time arrives.

Checksum Verification

Automatic post-download integrity verification. Supported algorithms:

Browser Extension

The HyperDL browser extension intercepts downloads, adds right-click context menu integration, and enables batch page capture. Available for all major browsers.

Chrome / Edge / Brave

Uses Manifest V3 with a service worker background.

Firefox

Uses Manifest V2 with browser API namespace.

Safari

Requires the Safari Web Extension adapter. Build with Xcode:

xcrun safari-web-extension-converter browser-extension/safari/
# Then enable in Safari → Preferences → Extensions

Extension Configuration

Right-click the extension icon → Options, or access via the popup gear icon.

Cloud Upload

Automatically upload completed downloads to your cloud storage. Supported providers:

Configure in Settings → Cloud. Requires Pro or Ultimate license.

P2P Friend Linking

Link your HyperDL instances across devices and users. Send download requests to friends or your other machines. Recipients can accept, reject, or auto-accept from trusted senders.

Remote Downloads

Send URLs to remote HyperDL servers. Perfect for queueing downloads from your phone to your home PC or NAS.

# Send a download request to a remote server
curl -X POST http://your-nas:36457/api/downloads \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/large-file.zip", "path": "/downloads"}'

Share Links

Generate passphrase-protected share links with configurable expiry and max-use limits. Share completed downloads securely with anyone.

Categories & Tags

Auto-categorize downloads by file type/MIME. Add custom tags and group by category, status, or date. Categories: Archives, Video, Audio, Documents, Images, Applications, ISO, Other.

Post-Download Actions

Automate actions after each download completes. Available for Ultimate tier.

RSS Feed Monitoring

Subscribe to RSS/Atom feeds and auto-download new items matching regex filters. Ideal for podcasts, software updates, and recurring content.

Webhook Notifications

Send HTTP POST notifications on download events. HMAC-SHA256 signed for security.

{
  "event": "download.completed",
  "download": {
    "id": "abc123",
    "filename": "report.pdf",
    "size": 15728640,
    "url": "https://example.com/report.pdf",
    "checksum_sha256": "a1b2c3d4..."
  },
  "timestamp": "2026-03-08T12:00:00Z"
}

Compatible with Slack, Discord, Zapier, and any HTTP endpoint.

Docker Setup

Run HyperDL as a standalone web server in Docker. Perfect for NAS devices and headless servers.

docker run -d \
  --name hyperdl \
  --restart unless-stopped \
  -p 36457:36457 \
  -v /path/to/downloads:/data/downloads \
  -v /path/to/config:/data/db \
  hyperdl-server:latest

TrueNAS / Synology

# docker-compose.yml for NAS deployment
version: "3.8"
services:
  hyperdl:
    image: hyperdl-server:latest
    container_name: hyperdl
    restart: unless-stopped
    ports:
      - "36457:36457"
    volumes:
      - /mnt/pool/downloads:/data/downloads
      - /mnt/pool/appdata/hyperdl:/data/db
    environment:
      - RUST_LOG=info

REST API Reference

Plans & Pricing

Use promo code WELCOME10 for 10% off or LAUNCH50 for 50% off your first month.

License Management

Manage your license from the web dashboard or from within the desktop app.

Family Licenses

Family plans let you share one license key across multiple machines in your household.

FAQ