live/DOCUMENTATION/README.md

HLS Stream Proxy Server

A Node.js server that resolves and proxies HLS streams from streamed.pk / embed.st (and golf embeds) so they can be played in any browser or media player without referer or CORS issues.

Features

• Resolves admin/echo streams using the embed.st handshake.
• Resolves golf streams via a third‑party embed chain.
• Proxies HLS playlists and segments with correct Referer/Origin headers.
• Rewrites M3U8 playlists so all segments and keys go through the proxy.
• Strips PNG wrappers from segments (tiktokcdn).
• Works with hls.js, VLC, MPV, and any HLS‑compatible player.

Quick Start

git clone https://github.com/vyla-entertainment/live-api
npm install
npm start

Then open http://localhost:5000 (or your deployed URL).

Documentation

• API Reference
• Architecture Overview
• Setup & Configuration
• Deployment (incl. Hugging Face Spaces)
• Debugging

License

For study and research only. See the original streamed-pk-hls-stream-resolver disclaimer.