案例
LGwebOS-menubar:LG webOS 电视的原生 macOS 遥控器
一款原生 macOS 菜单栏应用,通过 LG webOS 电视在局域网内的加密 WebSocket 接口完成配对,可启动应用、切换输入源、调节音量和画面设置、发送指针输入并投放所选媒体。项目称 webOS 协议行为参考了公开的 Connect SDK,并沿用 PyWebOSTV 的注册清单。测试仅覆盖一台 webOS 5.0 电视。
- 目标
- 应用
- 类别
- 独立重建案例
- 关联
- 独立重建项目
- 来源复核于
使用条件与局限
- 前提条件:审阅版本为 2026-10-13 的最新提交,当时仓库只包含这一款应用。截至 2026-10-20,GitHub 已将仓库更名为 TVmenubar-MacOS,最新 README 将其拆分为 LG webOS 5.0 和 Roku OS 15.3.4 两款独立应用。需要 macOS 14 及以上、带 Swift 5.9 及以上的 Xcode Command Line Tools,以及位于同一网络的 LG webOS 电视;唯一测试过的机型是 webOS 5.0 的 LG 50UN7310PSC,其他型号和版本未经验证。配对须在电视上确认,需使用 IPv4 地址,网络唤醒还需要电视的 MAC 地址。
- 前提条件:scripts/build.sh 生成本地签名、未经公证的应用包。配对使用 3001 端口上的加密 WebSocket;应用在用户明确同意后固定电视证书,并把配对密钥保存在钥匙串中。仓库不含任何设备地址或配对密钥,另有隐私检查脚本在发布前扫描文件。
- 测试证据:离线 --self-check 无需电视即可运行偏好设置、证书、指针、主页、使用统计、资源和本地回环媒体测试。
- 局限:README 收窄了作者帖子中的说法:屏幕使用时间只在应用连接期间于本地统计,AirPlay 仅提供 macOS 屏幕镜像的操作指引,画面设置能否修改取决于电视权限,投放媒体则取决于电视支持的编码和 DLNA 服务。
- 许可:MIT 许可覆盖项目代码;PyWebOSTV 清单保留其 MIT 声明,LG、各应用及游戏主机图标归其所有者。提交记录将 Claude 列为共同作者,同一账号的 X 帖子称使用了 REA。这是非官方客户端。
关于此条目
说明已依据一手来源复核。
一手来源
- README.md GitHub · gabrielgreco1/TVmenubar-MacOS · 修订 8482f36
- THIRD_PARTY_NOTICES.md GitHub · gabrielgreco1/TVmenubar-MacOS · 修订 8482f36
- Sources/LGwebOSMenubar/WebOS.swift GitHub · gabrielgreco1/TVmenubar-MacOS · 修订 8482f36
- Sources/LGwebOSMenubar/FeatureChecks.swift GitHub · gabrielgreco1/TVmenubar-MacOS · 修订 8482f36
- Package.swift GitHub · gabrielgreco1/TVmenubar-MacOS · 修订 8482f36
- scripts/build.sh GitHub · gabrielgreco1/TVmenubar-MacOS · 修订 8482f36
- LICENSE GitHub · gabrielgreco1/TVmenubar-MacOS · 修订 8482f36
- README.md GitHub · gabrielgreco1/TVmenubar-MacOS · 修订 8641101
- https://x.com/greco_dev/status/2109842197654692349