defendore/pseudotv

pseudotv-plex镜像说明

镜像概述

pseudotv-plex镜像允许用户从Plex服务器的媒体资源创建直播电视频道，通过Web UI进行频道、节目、广告及设置的配置，支持通过Plex的HDHomerun调谐器或M3U链接访问频道，同时生成EPG指南数据存储到指定文件。

核心功能

• 提供Docker镜像及Windows、Linux、Mac平台的预编译二进制文件
• 支持Web UI配置频道、节目、广告及应用设置
• 可跨多个Plex服务器选择媒体资源（节目、广告）
• 支持多种Plex登录方式（用户名、***、Google、***等）
• 自动更新Plex DVR指南数据和频道映射
• 按设定间隔自动更新xmltv.xml文件，支持设置EPG缓存时长
• 持续播放支持
• 广告功能：每个节目含5个广告位（前、1/4处、中间、3/4处、后），每个位置可添加多个广告
• 媒体轨道选择（视频、音频、字幕，默认禁用字幕）
• 字幕支持（内部/外部ASS、SRT、PGS等格式）
• 频道图标叠加到流上的功能
• 自动对未标记为"progressive"的Plex媒体进行去隔行处理

使用场景

• 家庭媒体中心：将个人Plex媒体库转化为定制化直播频道
• 个人娱乐：创建专属电视频道，按喜好排列节目顺序
• 小范围分享：通过M3U链接让亲友访问定制的直播频道

配置说明

Docker部署示例

拉取镜像并运行

bash
docker pull defendore/pseudotv
docker run --name pseudotv -p 8000:8000 -v /path/to/your/.pseudotv:/home/node/app/.pseudotv defendore/pseudotv

（替换/path/to/your/.pseudotv为本地配置目录路径）

从源码构建镜像并运行

bash
git clone https://github.com/DEFENDORe/pseudotv
cd pseudotv
docker build -t pseudotv .
docker run --name pseudotv -p 8000:8000 -v /path/to/your/.pseudotv:/home/node/app/.pseudotv pseudotv

Plex设置步骤

1. 进入Plex设置，添加PseudoTV模拟的HDHomerun调谐器
2. 若调谐器未自动列出，手动输入PseudoTV的网络地址（如192.168.1.100:8000）
3. 提示输入邮政编码时，点击"Have an XMLTV guide on your server? Click here to use that instead."链接
4. 输入本地xmltv.xml文件路径（如/path/to/your/.pseudotv/xmltv.xml） 注意：请勿使用Web UI的XMLTV URL，需使用本地文件路径确保Plex能正常更新EPG。