HLS Proxy Server

Server Operational

🛠️
Advanced Features

QUERY &ck1=...&ck2=...

Integrated ClearKey support for DASH (MPD) streams.

  • • Dynamic injection of PSSH and ContentProtection
  • • Automatic resolution of license proxying

🔄
Main Endpoints

GET /proxy/manifest.m3u8?url=<STREAM_URL>

Universal proxy for multimedia streaming with full support for various formats and protocols.

  • • VixSrc: VOD Streaming
  • • Sportzonline: Sports Streaming
  • • HLS (.m3u8): Live & VOD
  • • M3U Playlist: IPTV lists
  • • MPD (DASH): Adaptive Streaming
  • • DLHD: Dynamic Streams
/proxy/manifest.m3u8?url=https://vixsrc.to/movie/...
GET /proxy/manifest.m3u8?url=<URL_VAVOO>

Automatic Vavoo content extraction with direct stream resolution.

  • • vavoo.to links into direct streams
  • • Automatic API authentication
  • • Optimized headers for streaming
GET /proxy/manifest.m3u8?url=<URL_DADDYLIVE>

Advanced resolution for DaddyLive HD content with automatic restriction bypass.

  • • DaddyLive HD link resolution
  • • Automatic geo/bot restriction bypass
  • • Stream quality optimization
GET /proxy/manifest.m3u8?url=<URL_SPORTSONLINE>

Automatic resolution of streams from Sportsonline/Sportzonline.

  • • Automatic extraction of iframes and M3U8 URLs
  • • Support for P.A.C.K.E.R. unpacking
  • • Optimized headers for streaming
GET /record?url=<STREAM_URL>

Start recording and redirect to live stream (DVR).

  • • Record while you watch
  • • Optional title and duration support
  • • Full management via /recordings
/record?url=https://stream.m3u8&name=LiveTV&duration=3600
GET /proxy/hls/manifest.m3u8?d=<URL>

Endpoint for generic HLS streams.

  • • d parameter for target URL
  • • Drop-in compatibility for external clients
GET /proxy/mpd/manifest.m3u8?d=<URL_MPD>

Proxy for DASH (.mpd) manifests with on-the-fly conversion.

  • • HLS Conversion: Automatically transforms MPD into M3U8 for incompatible players
  • • Native: Use format=mpd to maintain original format
  • • Integrated ClearKey DRM support
GET /extractor/video?url=<URL>

Advanced Extraction API.

  • • Parameters: url (or d), host (optional)
  • • Base64 Support: URL can be Base64 encoded
  • • redirect_stream=true (default): Immediate 302 redirect to stream
  • • redirect_stream=false: Returns JSON with metadata and headers
  • • Help: Open without parameters to see usage guide and available hosts
GET /key?key_url=<URL>

Secure proxy for AES-128 decryption keys.

  • • Authentication header management for keys
  • • Support for static and dynamic keys
GET/POST /license?url=<URL>

Proxy for DRM license requests (ClearKey, Widevine).

  • • Static ClearKey support: ?clearkey=KID:KEY
  • • Transparent proxying for remote license servers

📚
Detailed API Endpoints Guide

GET /extractor/video

Advanced Extraction API - Extracts direct URLs and headers from various streaming services.

ℹ️ Info and Help

Open /extractor or /extractor/video without parameters to receive a JSON response with usage instructions and a list of supported hosts.

📝 Parameters

  • • url or d (Required) - Video URL. Supports plain text, URL encoded or Base64
  • • host (Optional) - Force a specific extractor: vavoo, dlhd, doodstream, f16px, fastream, filelions, filemoon, freeshot, livetv, lulustream, maxstream, mixdrop, okru, orion, sportsonline, streamtape, streamwish, supervideo, turbovidplay, uqload, vidmoly, vidoza, vixsrc, voe
  • • redirect_stream - true: immediate 302 redirect | false (default): JSON response
  • • api_password (Optional) - API Password if configured

💡 Practical Examples

1. JSON Response (default):
/extractor/video?url=https://vavoo.to/channel/123
2. Immediate redirect:
/extractor/video?url=https://daddylive.mp/stream.php&redirect_stream=true
3. With manual host:
/extractor/video?host=vavoo&url=https://custom-link.com/123
4. URL Base64:
/extractor/video?url=aHR0cHM6Ly9leGFtcGxlLmNvbS92aWRlbw==

🎯 Supported Services

Vavoo DaddyLiveHD Doodstream F16px Fastream Filelions Filemoon Freeshot LiveTV Lulustream Maxstream Mixdrop OKru Orion Sportsonline Streamtape Streamwish Supervideo Turbovidplay Uqload Vidmoly Vidoza VixSrc Voe Generic
GET /proxy/manifest.m3u8

Universal HLS Proxy - Main entry point for streaming. Handles HLS, MPD (with automatic conversion), and direct streams.

📝 Common Parameters

  • • url or d - Original stream URL
  • • h_<header> - Custom headers (e.g., h_User-Agent=VLC)
  • • clearkey - DRM keys in KID:KEY format (for protected MPDs)

🔄 Endpoint Variants

  • • /proxy/hls/manifest.m3u8 - Specific alias for HLS
  • • /proxy/mpd/manifest.m3u8 - Force DASH (MPD) processing
  • • /proxy/stream - Proxy for static files (MP4, MKV, AVI)
HLS Example:
/proxy/manifest.m3u8?url=https://example.com/stream.m3u8
MPD Example with ClearKey:
/proxy/manifest.m3u8?url=https://cdn.com/stream.mpd&clearkey=KID:KEY
GET Utilities

Utility Endpoints - Additional services for playlist management, server info, and debugging.

  • 🏗️ /builder - Web Interface for Playlist Builder
  • 📋 /playlist - Processes remote M3U playlists
  • ℹ️ /info - Server status HTML page (this page)
  • 📊 /api/info - Server status JSON API
  • 🌐 /proxy/ip - Server's public IP (VPN/Proxy debug)
  • 🔧 /generate_urls (POST) - Batch generate proxy URLs
  • 🔐 /license (GET/POST) - DRM License management

⚡
Advanced Features

  • 🔐 Automatic AES-128 cryptographic key management
  • 📋 Full #EXTVLCOPT and #EXTHTTP support
  • 🔄 Automatic retry with exponential backoff
  • ⚡ Connection pooling for optimal performance
  • 🌐 Custom headers with h_ prefix
  • 📺 Transparent proxying for .ts segments
  • 🎯 Universal compatibility with IPTV players
  • 🛡️ Anti-bot persistent sessions
    • VixSrc HLS M3U8 MPD Vavoo Sportzonline AES-128

    🔧
    Custom Headers

    Add custom headers with the h_ prefix:

    ?url=STREAM_URL&h_user-agent=CustomUA&h_referer=https://site.com&h_authorization=Bearer token123

    Supported Headers:

    • • h_user-agent - Custom User Agent
    • • h_referer - Referrer site
    • • h_authorization - Authorization token
    • • h_origin - Origin domain
    • • h_* - Any custom header

    📚
    Complete API Reference

    Full list of all available endpoints in the server.

    🏠 System & Public

    Method Endpoint Description
    GET / Main page with server status.
    GET /info Detailed information page.
    GET /builder Playlist Builder Web Interface.
    GET /api/info Server status JSON API.
    GET /proxy/ip Returns the server's public IP.

    📺 Proxy & Streaming

    Method Endpoint Description
    GET /proxy/manifest.m3u8 Main Entry point. Auto-detect HLS/DASH.
    GET /proxy/hls/manifest.m3u8 Specific alias for HLS.
    GET /proxy/mpd/manifest.m3u8 Force DASH (MPD) input with HLS conversion.
    GET /proxy/stream Generic proxy for static or progressive files.
    GET /playlist Dynamic M3U playlist generator.

    🔍 Extractors

    Method Endpoint Description
    GET /extractor/video Extracts links and headers. Returns JSON or Redirect.

    🔐 Keys & DRM

    Method Endpoint Description
    GET /license Proxy for DRM licenses (ClearKey/Widevine).
    POST /license Proxy for DRM licenses (payload).
    GET /key Proxy for AES-128 keys.

    📼 DVR (Recordings)

    Method Endpoint Description
    GET /recordings Web Interface for recordings management.
    GET /record Starts recording and redirects to stream (Smart Mode).
    GET /api/recordings Lists all recordings (JSON).
    GET /api/recordings/active List active recordings.
    GET /api/recordings/{id} Recording details.
    POST /api/recordings/start Start background recording.
    POST /api/recordings/{id}/stop Stop active recording.
    GET /api/recordings/{id}/stream Watch recording (live/vod).
    GET /api/recordings/{id}/download Download video file.
    DEL /api/recordings/{id} Delete recording.

    🏗️
    Playlist Builder

    Combine multiple playlists into a single M3U stream:

    GET /builder

    Complete interface for:

    • ✅ Combine multiple playlists
    • ✅ Automatic Vavoo and DLHD management
    • ✅ Automatic proxy for all streams
    • ✅ VLC, Kodi, IPTV players compatibility
    Output format: M3U8 with integrated proxy

    📱
    Player Compatibility

    🎬
    VLC Media Player
    All versions supported
    🎯
    Kodi
    With IPTV plugin
    📺
    IPTV Smarters Pro
    Native support
    ⚡
    TiviMate
    Advanced IPTV Player
    🎮
    Perfect Player
    Full IPTV suite
    🌐
    Browser Web
    Modern HTML5

    ⚙️
    System Architecture

    🏗️ Technology Stack:

    • • Python 3.11+ (FastAPI/aiohttp)
    • • Asynchronous ASGI server (Uvicorn)
    • • Connection pooling HTTP/2
    • • Persistent session management
    • • Anti-bot detection bypass

    ⚡ Performance:

    < 50ms
    Overhead Latency
    1000+
    Simultaneous Connections
    50-200MB
    Typical Memory
    ∞
    Throughput
    • • Integrated DNS caching