pcruz1905

pcruz1905 / hls-restream-proxy

Public

Lightweight HLS restream proxy for Jellyfin/Emby/Plex — injects headers, rewrites playlists, auto-refreshes tokens

emby hls homelab iptv jellyfin
206
11
69% credibility
Found Apr 18, 2026 at 206 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

Lightweight proxy toolkit that enables free HLS live streams to work with self-hosted media servers by adding required access headers and rewriting playlists.

How It Works

1
📺 Discover free live streams

You want to watch more live TV channels on your home media player, but many free online streams block access without special browser tricks.

2
⬇️ Get the stream fixer

Download this simple helper that sits between your player and the streams, adding the needed access details automatically.

3
📝 List your favorite channels

Create a quick note with the names, logos, and web pages of the channels you enjoy watching.

4
🚀 Launch the stream helper

Start it up easily, and it begins working quietly in the background to handle everything.

5
📋 Make your TV playlist

Run a quick refresh to build a personalized guide file with all your channels ready to go.

6
🔗 Link to your media player

Point your home media app to the new guide, and it recognizes the channels right away.

✅ Enjoy seamless live TV

Watch your channels play perfectly every time, with links refreshing automatically so nothing ever breaks.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 206 to 206 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is hls-restream-proxy?

This lightweight HLS restream proxy, built in Shell and Python stdlib, sits between Jellyfin/Emby/Plex and finicky IPTV sources, injecting required headers like User-Agent and Referer while rewriting playlists so all segments route through it. It auto-refreshes expiring tokens by scraping fresh m3u8 URLs on demand, generating stable M3U playlists your media server can tune into directly. Docker one-liners or manual runs make setup dead simple—no extra dependencies.

Why is it gaining traction?

Unlike heavier proxies, it's zero-dep and passthrough-only, adding near-zero latency while auto-learning headers via a detector script—no manual curl tests needed. The /channel/ endpoints and refresh timer keep streams alive without expired tokens, standing out for Jellyfin users tired of 403s on free HLS feeds. Solid Docker images and systemd units hook devs who want a lightweight GitHub alternative to full restreamers.

Who should use this?

Self-hosters running Jellyfin who scrape public IPTV pages with iframes and tokens, or Plex/Emby folks pairing it with Threadfin for Live TV tuners. Ideal for homelab tinkerers testing lightweight VK or Betfair streams that demand specific referers, or anyone proxying HLS to VLC/mpv without header hassles.

Verdict

Grab it if you need a no-fuss HLS header injector—206 stars and thorough docs show niche reliability, though the 0.7% credibility score flags modest maintenance. MIT-licensed and battle-tested for Jellyfin, but pair with Threadfin for Plex; skip if you want enterprise polish.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.