mediaflow-proxy  by mhdzumair

Media proxy for streaming media

Created 1 year ago
382 stars

Top 74.7% on SourcePulse

GitHubView on GitHub
Project Summary

MediaFlow Proxy is a high-performance server designed to proxy and transform various media streams, including HTTP(S), HLS, and MPEG-DASH. It offers advanced features like real-time DRM decryption for MPEG-DASH to HLS conversion, flexible routing rules, API security, and integration with Debrid services, targeting users who need to manage and manipulate media delivery pipelines.

How It Works

The proxy leverages a robust routing system to handle diverse stream types and configurations. It can convert MPEG-DASH streams, including DRM-protected ones using Clear Key, into HLS format in real-time. For HLS streams, it supports real-time manifest manipulation and proxying. The system allows for granular control over transport configurations, including per-route proxy settings and SSL verification, enhancing flexibility for complex network environments.

Quick Start & Requirements

  • Docker: docker run -p 8888:8888 -e API_PASSWORD=your_password mhdzumair/mediaflow-proxy
  • pip: pip install mediaflow-proxy followed by mediaflow-proxy
  • Python: 3.10 or higher required for pip installation.
  • Documentation: http://localhost:8888/docs (when running)

Highlighted Details

  • Real-time decryption of MPEG-DASH Clear Key DRM streams to HLS.
  • Advanced routing system supporting domain, protocol, subdomain, and port-specific rules.
  • API password protection, URL expiration, and IP-based access control for enhanced security.
  • Built-in speed test for RealDebrid and AllDebrid services.
  • Supports custom header injection and manipulation for HLS manifests and general HTTP streams.

Maintenance & Community

  • Contributions are welcome via Pull Requests.
  • The project acknowledges inspiration from Stremio Server, Comet Debrid proxy, and various media tools.

Licensing & Compatibility

  • MIT License. Permissive for commercial use and closed-source linking.

Limitations & Caveats

The project currently supports Clear Key DRM; Widevine and PlayReady decryption are listed as future development goals. The Hugging Face deployment guide requires forking the repository to avoid potential bans.

Health Check
Last Commit

2 days ago

Responsiveness

1 week

Pull Requests (30d)
11
Issues (30d)
7
Star History
44 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.