# LGwebOS-menubar：LG webOS 电视的原生 macOS 遥控器

> 一款原生 macOS 菜单栏应用，通过 LG webOS 电视在局域网内的加密 WebSocket 接口完成配对，可启动应用、切换输入源、调节音量和画面设置、发送指针输入并投放所选媒体。项目称 webOS 协议行为参考了公开的 Connect SDK，并沿用 PyWebOSTV 的注册清单。测试仅覆盖一台 webOS 5.0 电视。

- 类型：案例
- 目标：应用
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-20
- 收录于：2026-10-19
- 原始资源：<https://github.com/gabrielgreco1/TVmenubar-MacOS>
- 一手来源：<https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8482f36aaeb2e6577cf58bba12306ba3701c0fd2/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/lgwebos-menubar-remote-case/>
- 记录 JSON：<https://awesomerea.org/resources/lgwebos-menubar-remote-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/lgwebos-menubar-remote-case/index.md)

## 使用条件与局限

- **前提条件：**审阅版本为 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。这是非官方客户端。

## 一手来源

1. <https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8482f36aaeb2e6577cf58bba12306ba3701c0fd2/README.md>
2. <https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8482f36aaeb2e6577cf58bba12306ba3701c0fd2/THIRD_PARTY_NOTICES.md>
3. <https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8482f36aaeb2e6577cf58bba12306ba3701c0fd2/Sources/LGwebOSMenubar/WebOS.swift>
4. <https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8482f36aaeb2e6577cf58bba12306ba3701c0fd2/Sources/LGwebOSMenubar/FeatureChecks.swift>
5. <https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8482f36aaeb2e6577cf58bba12306ba3701c0fd2/Package.swift>
6. <https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8482f36aaeb2e6577cf58bba12306ba3701c0fd2/scripts/build.sh>
7. <https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8482f36aaeb2e6577cf58bba12306ba3701c0fd2/LICENSE>
8. <https://github.com/gabrielgreco1/TVmenubar-MacOS/blob/8641101827b8a847e3c4091df4e7a336c68ba431/README.md>
9. <https://x.com/greco_dev/status/2109842197654692349>

## 同分区更多条目：应用

- [Galaxy Buds Client：基于三星耳机协议的非官方管理器](https://awesomerea.org/zh/resources/galaxy-buds-client-protocol-case/index.md) · 案例
- [Wino Mail：重建 Windows 邮件与日历体验](https://awesomerea.org/zh/resources/wino-mail-case/index.md) · 案例
- [ScooterLink：重建 Honda RoadSync 车把按键协议](https://awesomerea.org/zh/resources/scooterlink-honda-roadsync-case/index.md) · 案例
- [iX500 Scan：基于逆向 ScanSnap Wi-Fi 协议的 macOS 客户端](https://awesomerea.org/zh/resources/ix500-scan-scansnap-wifi-case/index.md) · 案例
- [WristBeam：为 Mac 配套应用重建佳明手表协议](https://awesomerea.org/zh/resources/wristbeam-garmin-watch-protocol-case/index.md) · 案例
- [usque：Cloudflare WARP MASQUE 模式的开源再实现](https://awesomerea.org/zh/resources/usque-warp-masque-client-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。