VDL - Video Downloader Library

A modular, cross-platform video downloader built with Rust.

🚀 Features

• Memory Safe - Built with Rust for zero-cost abstractions
• Cross-Platform - Linux, macOS, Windows, Android (Termux)
• Extensible Architecture - Plugin system for new platforms
• Multiple Protocols - MP4, M3U8 (HLS), MPD (DASH)
• Progress Tracking - Real-time download progress
• Format Selection - Automatic or manual quality selection

📋 Supported Platforms (5+)

Platform	Status	Extractor
YouTube	✅ Active	src/extractors/youtube/mod.rs
Instagram	✅ Active	src/extractors/instagram/mod.rs
Twitter/X	✅ Active	src/extractors/twitter/mod.rs
Vimeo	✅ Active	src/extractors/vimeo/mod.rs
Facebook	✅ Active	src/extractors/facebook/mod.rs
Generic	✅ Fallback	Built-in generic extractor

📦 Installation

Prerequisites

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Verify
rustc --version
cargo --version

Build

cd vdl
cargo build --release

Run

./target/release/vdl <URL>

🛠️ For Developers

Project Structure

vdl/
├── src/
│   ├── lib.rs          # Library exports
│   ├── main.rs         # CLI entry point
│   ├── downloader.rs   # HTTP download logic
│   ├── extractor.rs    # Base extraction trait
│   └── formats.rs      # Format handling
├── examples/           # Usage examples
├── Cargo.toml          # Dependencies
└── README.md

Using as a Library

Add to your Cargo.toml:

[dependencies]
vdl = { path = "path/to/vdl" }

Basic usage:

use vdl::{Downloader, VideoInfo};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let downloader = Downloader::new();
    
    // Extract video info
    let info = downloader.extract("https://example.com/video").await?;
    
    // Download best quality
    downloader.download(&info.formats.best, "video.mp4").await?;
    
    Ok(())
}

Creating a New Extractor

Implement the Extractor trait:

use async_trait::async_trait;
use crate::{Extractor, VideoInfo, VideoFormat};

pub struct MyPlatformExtractor;

#[async_trait]
impl Extractor for MyPlatformExtractor {
    async fn extract(&self, url: &str) -> Result<VideoInfo, Error> {
        // Your extraction logic here
        Ok(VideoInfo {
            id: "video_id".to_string(),
            title: "Video Title".to_string(),
            formats: vec![VideoFormat {
                id: "best".to_string(),
                url: "https://cdn.com/video.mp4".to_string(),
                quality: 1080,
                ..Default::default()
            }],
        })
    }
    
    fn supports(&self, url: &str) -> bool {
        url.contains("myplatform.com")
    }
}

Register in extractor.rs:

pub fn register_extractors() -> Vec<Box<dyn Extractor>> {
    vec![
        Box::new(YouTubeExtractor),
        Box::new(MyPlatformExtractor),
        // Add more...
    ]
}

📖 CLI Usage

# Basic download (auto-detects platform)
vdl "https://youtube.com/watch?v=..."
vdl "https://instagram.com/p/..."
vdl "https://twitter.com/.../status/..."
vdl "https://vimeo.com/..."
vdl "https://facebook.com/..."

# Specify output file
vdl "https://youtube.com/watch?v=..." -o my_video.mp4

# Quality selection
vdl "https://vimeo.com/..." -q 1080
vdl "https://instagram.com/p/..." -q 720

# List available formats
vdl "https://youtube.com/watch?v=..." --list-formats

# Silent mode (no output)
vdl "https://facebook.com/video" -q

🎯 Platform-Specific Examples

# YouTube
./vdl "https://youtube.com/watch?v=dQw4w9WgXcQ"

# Instagram Post
./vdl "https://instagram.com/p/C5qK8vJvFPH/"

# Instagram Story
./vdl "https://instagram.com/stories/username/"

# Twitter Video
./vdl "https://twitter.com/user/status/123456789"

# Vimeo
./vdl "https://vimeo.com/123456789"

# Facebook Video
./vdl "https://facebook.com/video/posts/123456789"

🌐 Browser Extension Support

Pre-built Binaries

Download pre-built browser binaries from GitHub Releases:

• vdl.wasm - WebAssembly for browsers
• vdl.js - JavaScript wrapper
• vdl.node - Node.js native module

Browser Integration

// Download video in browser
import { VDL } from './vdl.js';
await VDL.download('https://youtube.com/watch?v=XXX');

🧬 Architecture

VDL can be deployed as a web service for browser-based video downloading:

API Server

cd api
cargo build
cargo run

Endpoints:

GET /download/:url    # Download video by URL

Web Integration

// Frontend JavaScript
async function downloadVideo(url) {
    const response = await fetch(`http://localhost:8080/download/${encodeURIComponent(url)}`);
    const result = await response.json();
    console.log(result);
}

🧬 Architecture

┌─────────────────────────────────────────┐
│                 CLI/Application         │
└──────────────────┬──────────────────────┘
                   │
┌──────────────────▼──────────────────────┐
│           Downloader Interface          │
│  - Extract video info                   │
│  - Select optimal format                │
│  - Download with progress               │
└──────────────────┬──────────────────────┘
                   │
┌──────────────────▼──────────────────────┐
│            Extractor Router             │
│  - URL → Platform detection             │
│  - Route to appropriate extractor       │
└──────────────────┬──────────────────────┘
                   │
     ┌─────────────┴─────────────┐
     │                           │
┌────▼────┐                 ┌────▼────┐
│YouTube  │                 │Generic  │
│Extractor│                 │Extractor│
└─────────┘                 └─────────┘

🎯 Roadmap

• Plugin system for external extractors
• Concurrent download support
• Post-processing hooks (thumbnail, subtitles)
• Metadata embedding (ID3, YUV)
• Queue management

📜 License

MIT - See LICENSE file

🤝 Contributing

1. Fork the repository
2. Create feature branch
3. Add tests
4. Submit pull request