tom42/tom42tv

locast2plex

locast2plex是一个Python脚本和Docker镜像，用于将Locast服务集成到Plex的直播电视/DVR功能中。它依赖ffmpeg、Python及相关模块实现核心功能，灵感部分来自https://github.com/tellytv/telly%E9%A1%B9%E7%9B%AE%E3%80%82

核心功能

• 连接Locast服务与Plex直播电视/DVR模块
• 模拟HDHomeRun设备，支持Plex识别
• 支持Docker容器或命令行两种运行方式
• 可配置端口、外部地址等参数

使用场景

适用于拥有Locast账户（非账户流会在5-10分钟后中断）的用户，希望在Plex平台统一管理直播电视内容，需确保运行服务器与Locast服务所在地区一致。

配置说明

前提条件

1. 持续运行的服务器（需与Plex服务器网络可达或同机），具备视频处理能力
2. Docker环境（若使用容器方式）或Python 2.7.x、ffmpeg（若使用命令行方式）
3. Locast***账户

安装步骤

Docker方式

Docker Compose

1. 修改docker-compose.env文件，填写正确的用户名、密码及服务器外部IP地址
2. 执行命令：docker-compose up

Docker命令

基础运行命令：

bash
docker run -e username=你的Locast用户名 -e password=你的Locast密码 -e external_addy=服务器外部IP -p 6077:6077 -p 1900:1900/udp tgorg/locast2plex

修改端口示例（将外部端口改为1234）：

bash
docker run -e username=你的Locast用户名 -e password=你的Locast密码 -e external_addy=服务器外部IP -e external_port=1234 -p 1234:6077 -p 1900:1900/udp tgorg/locast2plex

命令行方式

基础运行命令：

bash
python main.py -u:你的Locast用户名 -p:你的Locast密码 --debug --addy:服务器外部IP

修改端口示例：

bash
python main.py -u:你的Locast用户名 -p:你的Locast密码 --debug --addy:服务器外部IP --port:1234

Plex配置

1. 进入Plex设置→直播电视/DVR，添加HDHomeRun设备
2. 手动输入地址（格式：外部IP:端口，如127.0.0.1:6077）
3. 选择对应地区的EPG指南，完成频道配置

故障排除

频道号错误

未识别的频道会从1000开始顺序分配，可通过搜索呼号（Google/***）获取正确频道号，后续版本将优化识别逻辑。

端口1900处理

SSDP自动发现功能存在 bug，可移除Docker命令中的-p 1900:1900/udp参数（或删除docker-compose.yml中的对应行），不影响核心功能使用。

bash
docker run -e username=你的Locast用户名 -e password=你的Locast密码 -e external_addy=服务器外部IP -p6077:6077 tgorg/locast2plex

===FULL_DESC===