https://github.com/mhdzumair/mediaflow-proxy
A high-performance proxy server for streaming media, supporting HTTP(S), HLS, and MPEG-DASH with real-time DRM decryption, acestream, xtreamcode proxy
https://github.com/mhdzumair/mediaflow-proxy
acestream alldebrid debrid hls mpeg-dash proxy real-debrid stremio xtreamcode
Last synced: 3 months ago
JSON representation
A high-performance proxy server for streaming media, supporting HTTP(S), HLS, and MPEG-DASH with real-time DRM decryption, acestream, xtreamcode proxy
- Host: GitHub
- URL: https://github.com/mhdzumair/mediaflow-proxy
- Owner: mhdzumair
- License: mit
- Created: 2024-08-24T16:43:33.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-17T16:24:19.000Z (3 months ago)
- Last Synced: 2026-05-17T18:39:27.961Z (3 months ago)
- Topics: acestream, alldebrid, debrid, hls, mpeg-dash, proxy, real-debrid, stremio, xtreamcode
- Language: Python
- Homepage: https://mhdzumair.github.io/mediaflow-proxy/
- Size: 2.75 MB
- Stars: 704
- Watchers: 10
- Forks: 445
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-video - MediaFlow Proxy - A high-performance proxy server for streaming media, supporting HTTP(S), HLS, and MPEG-DASH with real-time DRM decryption. It can convert MPEG-DASH DRM-protected streams to decrypted HLS live streams in real-time, making it one of the fastest live decrypter servers available. (Protocols & Transport / Video Analytics & Benchmarking)
- awesome-debrid - MediaFlow Proxy - (709★) High-performance proxy for HTTP(S), HLS, MPEG-DASH streams with DRM decryption. Enables Stremio addons to proxy debrid streams, bypassing IP restrictions. Also supports IPTV, Acestream. (Proxy & Infrastructure / Stremio Utility Addons)
README
# MediaFlow Proxy
MediaFlow Proxy is a streaming proxy for HTTP(S), HLS (M3U8), and MPEG-DASH—including **ClearKey** DRM and real-time DASH-to-HLS conversion. It also supports IPTV (Xtream Codes), Acestream, Telegram media, transcoding, and advanced routing.
**Full documentation:** [mhdzumair.github.io/mediaflow-proxy](https://mhdzumair.github.io/mediaflow-proxy/) (built from the [`docs/`](docs/) folder with [MkDocs](https://www.mkdocs.org/) Material).
## Quick start
```bash
docker run -p 8888:8888 -e API_PASSWORD=your_password mhdzumair/mediaflow-proxy
```
> Prefer not to self-host? A managed MediaFlow Proxy instance is available via [ElfHosted](https://store.elfhosted.com/product/mediaflow-proxy-2x4k-booster/?utm_source=github&utm_medium=readme&utm_campaign=mediaflow-proxy-readme), bundled with debrid and Stremio addons in their streaming personal-stacks (7-day trial).
## Highlights
- DASH (ClearKey) to HLS, HLS manipulation, generic HTTP(S) proxy with custom headers
- Xtream Codes API proxy, Acestream, Telegram (MTProto) streaming
- Optional GPU transcoding (fMP4 H.264/AAC), pre-buffering, segment skip, stream transformers
- Redis-backed rate limiting, encrypted URL generation, reverse-proxy–friendly forwarded headers
## Docs and source
| Resource | Link |
|----------|------|
| User & operator manual | [Documentation site](https://mhdzumair.github.io/mediaflow-proxy/) |
| Markdown sources | [`docs/`](docs/) in this repository |
| Build docs locally | `uv sync --group docs` then `uv run mkdocs serve` |
## High-throughput alternative ⚡
For lower memory usage and higher throughput — especially on constrained hardware (small VPS, NAS, Raspberry Pi) — see **[MediaFlow Proxy Light](https://github.com/mhdzumair/mediaflow-proxy-light)**, a Rust reimplementation that is fully API-compatible with this proxy. Benchmarks show 7–8× less memory, 1.7–3.4× less CPU per request, and up to 4× higher throughput. Existing tokens, encrypted URLs, and client integrations work without changes.
## Contributing
Contributions are welcome! see [Contributing](docs/community/contributing.md) in the docs and open a Pull Request on [GitHub](https://github.com/mhdzumair/mediaflow-proxy).
## License
[MIT License](LICENSE)
## Disclaimer
This project is for educational purposes only. The developers of MediaFlow Proxy are not responsible for any misuse of this software. Please ensure that you have the necessary permissions to access and use the media streams you are proxying.