waastudios / ysptp-docker

# ysp-live v9.5
> **Acknowledgments**
> 1. Thanks to IPTV Official Group for sharing the algorithm source code
> 2. Thanks to ll from the Gary's Club group for providing live_ids for many channels
> 3. Thanks to the APTV group owner for technical help
**中文文档**: README-CN.md
CCTV live streaming via Docker — **CCTV channels only** (30 channels): CCTV-1~17, 5+, 6, 3 theater channels, 4K/8K, CGTN. Local satellite channels have been completely removed.
## What's inside
- **30 CCTV channels** with groups (`group-title`): 央视FHD / 央视UHD / CGTN
- **Dual-engine 4-layer fallback**: device 4K/8K → 1080p JCE → bkliveinfo → Node.js WASM fallback
- **7-day catchup & timeshift**: 19 channels support 7-day program replay (`catchup="append"`)
- Python + Node.js, single port (8767)
- Auto keep-alive: heartbeat every 30s, silent session renewal, 24/7 background worker
- Persistent device identity: `./data` volume survives container rebuilds
- APTV player optimized: no preview/latency probing to avoid triggering rate limits
## One-command VPS deploy
 [code] 
Wait ~30s, then check logs for `设备协议就绪` (device protocol ready):
 [code] 
## Usage
Get your VPS public IP:
 [code] 
- CCTV subscription (30 channels, with groups):
 [code] 
- Aggregated EPG (30 channels, refreshes every 6h):
 [code] 
- Homepage: `http:// :8767/`
- Diagnostics: `http:// :8767/diag`
> Note: `localhost` only works on the machine itself. On a VPS, always replace it with the public IP; on a LAN use the private IP (e.g. `http://192.168.1.10:8767/cctv.m3u`).
Channel groups:
- 央视FHD: CCTV-1~17, 5+, 6, 3 theater channels, etc.
- 央视UHD: CCTV-4K, 8K, 16-4K
- CGTN: CGTN main + French / Russian / Arabic / Spanish / Documentary
## Ports & firewall
| Port | Purpose |
| --- | --- |
| 8767 | Single port: homepage, subscriptions, 30 channels, TS relay, aggregated EPG |
 [code] 
## EPG Guide Subscription
This project ships a built-in aggregated EPG endpoint (see Usage above for the URL) — no need to configure third-party EPG sources manually:
- Content: programme guide for only the 30 channels in this project (CCTV FHD / CCTV UHD / CGTN); irrelevant channels are filtered out
- Upstream sources (merged automatically; the two complement each other, one going down won't break the other):
 - `https://epg.pw/xmltv/epg_CN.xml.gz`
 - `https://epg.zsdc.eu.org/t.xml.gz`
- Refresh: auto-updates every 6 hours; fetched in the background on first access, just retry after a moment
The `/cctv.m3u` playlist already points to this address, so players load the guide automatically.
## Notes
- **Bandwidth**: 4K channels relay video through the VPS (~15GB/hour at 35Mbps). A VPS far from CCTV's CDN (e.g. US) may stutter on 4K; an Asia VPS is recommended for smooth 4K.
- **Device registration**: first boot takes ~5-10s for device registration; rebuilding the container requires re-registration (normal).
- Subscriptions include logos, `tvg-id`, `group-title`, and aggregated EPG — no manual EPG setup needed.
## Common commands
 [code] 
## C