lets try this

2026-02-10 23:44:22 +01:00
parent 763c802acf
commit db39c420c0
4 changed files with 325 additions and 0 deletions
@@ -0,0 +1,41 @@
+# Self-hosted IPTV
+
+Serves M3U playlists that randomly schedule video files from `/movies` and `/series`, with the same show never appearing twice in a row.
+
+## Setup
+
+1. Create `/data/channels.json` (see `data/channels.json.example`).
+
+**channels.json format:**
+
+- `channels`: array of channel objects
+- Each channel:
+  - `id`: unique id (used in URLs)
+  - `name`: display name
+  - `paths`: list of path keys to include:
+    - `"movies"` — all videos under `/movies`
+    - `"series/Show Name"` — all videos under `/series/Show Name`
+
+2. Run the container with volumes:
+
+```bash
+docker build -t self-hosted-iptv .
+docker run -d --name iptv -p 8080:8080 \
+  -v /path/to/movies:/movies:ro \
+  -v /path/to/series:/series:ro \
+  -v /path/to/data:/data:ro \
+  self-hosted-iptv
+```
+
+3. In your IPTV client, add playlist URL: `http://<host>:8080/playlist.m3u`
+
+## Endpoints
+
+- `GET /` — simple web index with playlist link
+- `GET /playlist.m3u` — master M3U (all channels)
+- `GET /channel/<id>/playlist.m3u` — single channel M3U (randomized, no adjacent same show)
+- `GET /stream?path=movies/...` or `path=series/...` — stream a video file
+
+## Shuffle behaviour
+
+Videos are grouped by path (e.g. one group per show or the whole movies folder). Each group is shuffled, then items are interleaved round-robin so the same show never plays back-to-back.