Server Documentation

EasyProxy

Universal streaming proxy & media extraction server

v2.8.08
Latest: 2.8.08
WARP: Connected

📊
Server Status

EasyProxy is a high-performance universal streaming proxy server. It provides transparent proxying for HLS, DASH (MPD), and direct media streams, with built-in support for content extraction from dozens of streaming services, DRM license proxying, and DVR recording capabilities.

< 50ms
Overhead Latency
1000+
Simultaneous Connections
50-200MB
Typical Memory
Throughput

📡
API Endpoints

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

Universal HLS Proxy — Main entry point for all streaming. Auto-detects HLS, MPD (with conversion), and direct streams. Supports custom headers via h_ prefix and ClearKey DRM for protected MPDs.

  • 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://example.com/stream.m3u8
GET /proxy/manifest.m3u8?url=<URL_VAVOO>

Vavoo Content Extraction — Resolves vavoo.to links into direct playable streams with automatic API authentication and optimized streaming headers.

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

DaddyLive HD Resolution — Advanced resolution for DaddyLive HD content with automatic geo/bot restriction bypass and stream quality optimization.

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

Sportsonline Resolution — Automatic extraction of iframes and M3U8 URLs from Sportsonline/Sportzonline with P.A.C.K.E.R. unpacking support.

  • Automatic extraction of iframes and M3U8 URLs
  • Support for P.A.C.K.E.R. unpacking
  • Optimized headers for streaming
GET /proxy/hls/manifest.m3u8?d=<URL>

Generic HLS Proxy — Dedicated endpoint for pure HLS streams. Uses d parameter for the target URL. Drop-in compatibility for external clients.

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

DASH / MPD Proxy — Proxy for DASH (.mpd) manifests with on-the-fly HLS conversion. Use format=mpd to maintain the original DASH format. Integrated ClearKey DRM support.

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

Generic Static File Proxy — Proxy for progressive download files such as MP4, MKV, AVI. Ideal for direct media file delivery.

  • Static file proxying
  • Range request support
GET /extractor/video?d=<URL>

Advanced Extraction API — Extracts direct stream URLs and headers from dozens of streaming services. Returns JSON metadata or performs immediate 302 redirect.

  • Parameters: url or d (required), host (optional, force extractor)
  • Base64 encoded URLs supported
  • redirect_stream=true: Immediate 302 redirect
  • redirect_stream=false: Returns JSON with metadata and headers
  • Open without parameters for usage guide and supported hosts list
Vavoo DaddyLiveHD EmbedSports Doodstream Fastream Filelions Filemoon LiveTV Lulustream Mixdrop OKru Sportsonline Streamtape Streamwish Supervideo Uqload VixSrc Voe Generic
GET /key?key_url=<URL>

AES-128 Key Proxy — Secure proxy for AES-128 decryption keys. Manages authentication headers and supports both static and dynamic key retrieval.

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

DRM License Proxy — Proxy for DRM license requests supporting ClearKey and Widevine. Handles transparent proxying for remote license servers.

  • Static ClearKey: ?clearkey=KID:KEY
  • Transparent proxying for remote license servers
GET /playlist?url=<M3U_URL>

Dynamic M3U Playlist Generator — Processes remote M3U playlists and rewrites all stream URLs through the proxy, enabling unified access.

  • Rewrites all stream URLs through proxy
  • Retains original EPG and metadata
GET /record?url=<STREAM_URL>&name=<TITLE>&duration=<SECONDS>

DVR Recording — Start recording a live stream while watching. Optional title and duration parameters. Full recording management via the web interface.

  • Record while you watch (Smart Mode)
  • Optional title and duration support
  • Full management at /recordings
/record?url=https://stream.m3u8&name=LiveTV&duration=3600

📚
Complete API Reference

Full list of all available endpoints organized by category.

🏠 System & Public
MethodEndpointDescription
GET/Main page with server status
GET/infoDetailed information page (this page)
GET/builderPlaylist Builder web interface
GET/api/infoServer status JSON API
GET/proxy/ipReturns the server's public IP address
POST/generate_urlsBatch generate proxy URLs
📺 Proxy & Streaming
MethodEndpointDescription
GET/proxy/manifest.m3u8Main entry point — auto-detect HLS/DASH
GET/proxy/hls/manifest.m3u8Specific alias for HLS streams
GET/proxy/mpd/manifest.m3u8Force DASH (MPD) input with HLS conversion
GET/proxy/streamGeneric proxy for static/progressive files
GET/playlistDynamic M3U playlist generator
🔍 Extractors
MethodEndpointDescription
GET/extractor/videoExtract direct links and headers. Returns JSON or redirect
🔐 Keys & DRM
MethodEndpointDescription
GET/POST/licenseProxy for DRM licenses (ClearKey / Widevine)
GET/keyProxy for AES-128 decryption keys
💼 DVR & Recordings
MethodEndpointDescription
GET/recordingsWeb interface for recordings management
GET/recordStart recording and redirect to stream (Smart Mode)
GET/api/recordingsList all recordings (JSON)
GET/api/recordings/activeList active recordings
GET/api/recordings/{id}Recording details
POST/api/recordings/startStart background recording
POST/api/recordings/{id}/stopStop active recording
GET/api/recordings/{id}/streamWatch recording (live or VOD)
GET/api/recordings/{id}/downloadDownload recorded video file
DEL/api/recordings/{id}Delete recording

⚙️
System Architecture

EasyProxy is built on a modern async Python stack designed for high-throughput media streaming with minimal overhead.

🐍
Python 3.11+
FastAPI / aiohttp async runtime
ASGI Server
Uvicorn with HTTP/2 support
🔀
Connection Pooling
Persistent sessions with keep-alive
🛡️
Anti-Bot Bypass
Persistent sessions & fingerprinting
📦
DNS Caching
Integrated resolver with TTL management
🔄
Retry Logic
Exponential backoff for resilience

Technology Stack

Python 3.11+ FastAPI aiohttp Uvicorn HTTP/2 Connection Pooling AES-128 ClearKey Widevine

Features

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

Integrated ClearKey DRM — Dynamic injection of PSSH boxes and ContentProtection elements for DASH (MPD) streams. Automatic resolution of license proxying.

  • Dynamic injection of PSSH and ContentProtection
  • Automatic resolution of license proxying
🔐Automatic AES-128 cryptographic key management
📋Full #EXTVLCOPT and #EXTHTTP support in playlists
🔄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
📦Integrated DNS caching
VixSrc HLS M3U8 MPD Vavoo Sportzonline AES-128 ClearKey Widevine

🔧
Custom Headers

Add custom HTTP headers to any proxied request using the h_ prefix:

?url=STREAM_URL&h_user-agent=CustomUA&h_referer=https://site.com&h_authorization=Bearer%20token123
  • h_user-agent — Custom User Agent
  • h_referer — Referrer site
  • h_authorization — Authorization token
  • h_origin — Origin domain
  • h_* — Any custom header

💻
Code Examples

GET /extractor/video

Extractor API Examples

1. JSON Response (default):
/extractor/video?d=https://vavoo.to/channel/123
2. Immediate redirect:
/extractor/video?d=https://daddylive.mp/stream.php&redirect_stream=true
3. With manual host:
/extractor/video.m3u8?host=vavoo&d=https://custom-link.com/123
4. Direct MP4 host:
/extractor/video.mp4?host=mixdrop&d=https://mixdrop.co/e/ABC123XYZ
5. URL Base64 encoded:
/extractor/video?d=aHR0cHM6Ly9leGFtcGxlLmNvbS92aWRlbw==
GET /proxy/manifest.m3u8

Proxy Examples

HLS Stream:
/proxy/manifest.m3u8?url=https://example.com/stream.m3u8
MPD with ClearKey:
/proxy/manifest.m3u8?url=https://cdn.com/stream.mpd&clearkey=KID:KEY
With custom headers:
/proxy/manifest.m3u8?url=https://example.com/stream.m3u8&h_user-agent=VLC&h_referer=https://example.com
GET /playlist

Playlist Builder

The /builder web interface lets you combine multiple M3U playlists into a single stream with automatic proxy rewriting. All streams are transparently proxied through EasyProxy, ensuring compatibility with VLC, Kodi, TiviMate, IPTV Smarters Pro, and other players.

Web Interface:
/builder

📱
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 players