neTV

neTV 是一个轻量级、自托管的 Web 界面，专为播放 IPTV 流而设计。它不提供任何内容，只负责播放你已有的 IPTV 源——无论是 Xtream Codes API 还是 M3U 播放列表。

我们开发 neTV，是因为市面上的解决方案要么过于臃肿（如 Jellyfin、Plex），要么在多设备上体验不佳。neTV 的目标很明确：只做一件事，并把它做好——用干净、响应式的界面，在桌面、平板、手机甚至 Chromecast 上流畅播放你的直播和点播内容。

此外，neTV 全面支持键盘导航（方向键 + Enter + Esc），非常适合 HTPC 或媒体中心场景。

重要提示：neTV 仅为播放器。你必须拥有合法的 IPTV 订阅，并自行确保内容访问合规。

核心功能

• 直播电视：带 EPG 网格节目指南
• 电影与剧集：支持元数据、季/集结构、续播
• Chromecast 投屏（需 HTTPS）
• 隐藏式字幕：支持样式自定义
• 全局搜索：支持正则表达式
• 收藏夹管理：可拖拽排序
• 响应式 UI：适配桌面、平板、手机
• 10 英尺友好：专为客厅遥控/键盘操作优化

高性能转码引擎

neTV 针对低延迟与低 CPU 占用进行了深度优化：

• 智能直通：h264 + aac 流直接复用，零 CPU 开销
• 全 GPU 流水线：NVDEC 解码 → NVENC/VAAPI 编码，CPU 几乎闲置
• 探测缓存：同一剧集的多集共享流媒体分析结果
• 隔行检测：自动对 OTA/有线信号去隔行，跳过逐行内容
• 智能跳转：向后跳转时复用已转码片段，仅处理间隙
• 会话恢复：VOD 播放进度在服务重启后自动恢复
• HTTPS 穿透：在 HTTPS 环境下自动代理 HTTP 流，确保兼容性

4K AI 超分辨率（NVIDIA GPU 专属）

通过 Real-ESRGAN + TensorRT，neTV 可实现 实时 4 倍超分：

• 输入：480p / 720p / 1080p
• 输出：接近原生 4K 画质
• 性能：RTX 5090 上可达 85fps（720p → 4K）

适用于老剧集、低码率直播流等场景，显著提升观感。

要求：

• 英伟达显卡（建议 RTX 20xx 或更高）
• 驱动 ≥ 535（CUDA 12.x）
• 安装 nvidia-container-toolkit
• 使用专用 AI Upscale Docker 镜像

首次启动会为你的 GPU 构建 TensorRT 引擎（约 2–3 分钟），后续启动秒级加载。

安装方式

✅ 推荐：Docker（预构建镜像）

创建 docker-compose.yml：

services:
  netv:
    image: ghcr.io/jvdillon/netv:latest
    ports:
      - "8000:8000"
    volumes:
      - ./cache:/app/cache
      - /etc/localtime:/etc/localtime:ro
    devices:
      - /dev/dri:/dev/dri  # 有 Intel/AMD GPU 时保留；无 GPU 请删除此行
    restart: unless-stopped

运行：

docker compose up -d

访问 http://localhost:8000，创建管理员账户并添加 IPTV 源。

更新：docker compose pull && docker compose up -d

🚀 启用 AI 超分辨率（英伟达）

git clone https://github.com/jvdillon/netv.git
cd netv
docker build -f Dockerfile.ai_upscale -t netv-ai .
docker run --gpus all \
  -v netv-models:/models \
  -v ./cache:/app/cache \
  -p 8000:8000 \
  netv-ai

TensorRT 引擎将自动缓存至 netv-models 卷。

💻 从源码构建（自定义需求）

git clone https://github.com/jvdillon/netv.git
cd netv
docker compose build   # 默认使用优化版 FFmpeg（含 NVENC/VAAPI/QSV）
docker compose up -d

🐧 Debian/Ubuntu（systemd 服务）

适合长期运行、支持自动启动与 HTTPS：

# 1. 安装依赖
./tools/install-prereqs.sh

# 2. （可选）申请 Let's Encrypt 证书（Chromecast 必需）
./tools/install-letsencrypt.sh yourdomain.com

# 3. （可选）编译高性能 FFmpeg
./tools/install-ffmpeg.sh

# 4. （可选）构建 AI 超分引擎
uv sync --group ai_upscale
./tools/install-ai_upscale.sh

# 5. 安装系统服务
sudo ./tools/install-netv.sh

管理命令：

sudo systemctl status netv
sudo systemctl restart netv
journalctl -u netv -f

实用工具（位于 tools/ 目录）

• zap2xml.py：从 zap2it/gracenote 抓取 EPG 数据（推荐每日 cron 任务）
• alignm3u.py：为 HDHomeRun 的 M3U 添加 tvg-id，实现 EPG 匹配
• xtream2m3u.py：将 Xtream 账号导出为标准 M3U，兼容其他平台

HDHomeRun 设置示例：

wget http://192.168.1.87/lineup.m3u -O tools/lineup.m3u
./tools/zap2xml.py --zip 90210
./tools/alignm3u.py --input tools/lineup.m3u --xmltv tools/xmltv.xml --output tools/ota.m3u

将 ota.m3u 作为 M3U 源导入 neTV 即可。

故障排查

启用调试日志：

• Docker：在 docker-compose.yml 中设 LOG_LEVEL=DEBUG，重启容器
• Systemd：sudo systemctl edit netv，添加 Environment="LOG_LEVEL=DEBUG"
• 开发模式：LOG_LEVEL=DEBUG ./main.py

常见问题

Q：哪里获取免费 IPTV 源？
A：推荐 iptv-org/iptv —— 社区维护的全球公开频道合集。

Q：如何获取可靠的 EPG 数据？
A：

• 免费但不稳定：iptv-org/epg
• 稳定可靠：Schedules Direct（付费，支持开源）
• 本地方案：tools/zap2xml.py（经作者验证，稳定可用）

Q：没有 GPU 或在 VPS 上运行？
A：在 docker-compose.yml 中移除 devices 部分，否则容器无法启动。

Q：键盘快捷键有哪些？