DLDeez

Introduction

DLDeez is a serverless media downloader built on the Cloudflare Workers platform. It leverages Cloudflare's edge infrastructure to provide a fast, scalable, and globally distributed download service. The application uses yt-dlp and FFmpeg under the hood to support a wide range of media platforms.

Features

• Multi-Platform Support: Download from YouTube, SoundCloud, Niconico, Bilibili, and more
• Format Discovery: Automatically detects all available video and audio formats
• Flexible Output: Support for multiple file types (MP4, WebM, MKV, AVI, MP3, M4A, OGG, Opus, FLAC, WAV)
• Serverless Architecture: Runs entirely on Cloudflare's edge network
• Async Processing: Uses Cloudflare Workflows for reliable background job execution
• Container-based Extraction: Leverages Cloudflare Containers running Deno + yt-dlp for media processing
• Modern UI: Clean and responsive interface built with SvelteKit and Tailwind CSS

Architecture

graph TB
    subgraph "User"
        U[Browser]
    end

    subgraph "Cloudflare Edge"
        subgraph "Web App (SvelteKit Worker)"
            WEB[dldeez-web]
            ROUTE1[POST /discover]
            ROUTE2[GET /discoveries/:id]
        end

        subgraph "Discoverer Service"
            DW[Discoverer Worker]
            DWF[Discoverer Workflow]
            DC[Discoverer Container]
        end

        subgraph "Downloader Service"
            DLW[Downloader Worker]
            DLWF[Downloader Workflow]
            DLC[Downloader Container]
        end

        HYPERDRIVE[Hyperdrive]
        R2[R2 Bucket]
    end

    subgraph "External"
        NEON[(Neon PostgreSQL)]
        YTDL[yt-dlp]
    end

    U -->|1. Paste Link| WEB
    WEB -->|2. Create Discovery| HYPERDRIVE
    WEB -->|3. Run Workflow| DW
    DW -->|4. Create| DWF
    DWF -->|5. Fetch Container| DC
    DC -->|6. Execute| YTDL
    YTDL -->|7. Return Formats| DC
    DC -->|8. JSON Response| DWF
    DWF -->|9. Save Results| HYPERDRIVE
    HYPERDRIVE -->|10. Persist| NEON

    U -->|11. Select Format| WEB
    WEB -->|12. Create Download| HYPERDRIVE
    WEB -->|13. Run Workflow| DLW
    DLW -->|14. Create| DLWF
    DLWF -->|15. Fetch Container| DLC
    DLC -->|16. Execute| YTDL
    YTDL -->|17. Stream Media| DLC
    DLC -->|18. Upload| R2
    DLWF -->|19. Update Status| HYPERDRIVE

    U -->|20. Download File| R2

    style WEB fill:#ff6b35,stroke:#333,color:#fff
    style DW fill:#4ecdc4,stroke:#333,color:#fff
    style DLW fill:#4ecdc4,stroke:#333,color:#fff
    style DC fill:#95e1d3,stroke:#333,color:#000
    style DLC fill:#95e1d3,stroke:#333,color:#000
    style HYPERDRIVE fill:#f38181,stroke:#333,color:#fff
    style R2 fill:#aa96da,stroke:#333,color:#fff
    style NEON fill:#fcbad3,stroke:#333,color:#000

Project Structure

dldeez/
├── apps/
│   ├── web/              # SvelteKit frontend
│   ├── discoverer/       # Media format discovery service
│   │   ├── src/          # Worker + Workflow logic
│   │   └── container/    # Deno container running yt-dlp
│   └── downloader/       # Media download service
│       ├── src/          # Worker + Workflow logic
│       └── container/    # Deno container running yt-dlp + ffmpeg
├── packages/
│   ├── contracts/        # Shared TypeScript service interfaces
│   └── db/               # ZenStack database client + schema
└── package.json          # Monorepo root

Tech Stack

Prerequisites

• Node.js 20+
• npm
• Docker
• Wrangler CLI
• Cloudflare account with Workers, R2, Hyperdrive, and Containers enabled
• PostgreSQL database (e.g., Neon)

Setup

1. Clone the repository:

git clone https://github.com/h4ckedneko/dldeez.git && cd dldeez

2. Install dependencies:

npm install

3. Copy the example configuration files and fill in your values:

cp apps/web/wrangler.toml.example apps/web/wrangler.toml
cp apps/discoverer/wrangler.toml.example apps/discoverer/wrangler.toml
cp apps/downloader/wrangler.toml.example apps/downloader/wrangler.toml
cp packages/db/.env.example packages/db/.env

4. Generate TypeScript definitions:

npm run generate

Development

Start all services in development mode:

# Web frontend
npm run web:dev

# Discoverer service
npm run discoverer:dev

# Downloader service
npm run downloader:dev

Deployment

Deploy each service to Cloudflare:

# Web frontend
npm run web:deploy

# Discoverer service
npm run discoverer:deploy

# Downloader service
npm run downloader:deploy

Scripts

Ethics

DLDeez is designed to simplify downloading publicly available content. We assume no liability for how the tool is used. Users bear full responsibility for their downloads, including how they choose to use or share the content. This is not a piracy tool and should not be treated as one. It only works with free, publicly accessible media that could otherwise be saved using a browser's built-in developer tools.

Acknowledgements

• yt-dlp - Media extraction engine
• FFmpeg - Media processing framework
• Cloudflare Workers - Serverless platform
• SvelteKit - Web framework
• Hono - Lightweight web framework for containers
• Deno - Runtime for containers

Inspirations and Alternatives

• cobalt
• Parabolic
• NewPipe
• Invidious