LGTV Companion：智能电视与PC联动终极解决方案，一键解决OLED显示器管理难题

【免费下载链接】LGTVCompanionPower On and Off WebOS LG TVs together with your PC项目地址: https://gitcode.com/gh_mirrors/lg/LGTVCompanion

你是否正在使用LG OLED电视作为PC显示器，却为繁琐的手动开关操作而烦恼？是否担心OLED屏幕因长时间显示静态内容而面临烧屏风险？LGTV Companion正是为解决这些痛点而生的智能解决方案。这款开源工具能够实现Windows PC与LG WebOS电视的完美同步控制，提供自动化电源管理、智能闲置检测和强大的命令行控制功能，让你的OLED电视真正成为PC的最佳伴侣。

🎯 项目核心价值：为什么你需要LGTV Companion？

三大核心优势

自动化电源管理：告别手动开关电视的繁琐操作，实现真正的"设置即忘"体验。当你的PC开机、关机、休眠或唤醒时，电视会自动同步电源状态。

OLED屏幕保护：智能闲置检测功能会在你离开电脑时自动关闭电视，有效防止OLED屏幕烧屏，延长电视使用寿命。

统一控制平台：通过强大的命令行接口和API，你可以批量控制多台电视，调整画面设置、音量、输入源等所有参数，实现真正的智能家居集成。

技术架构概览

LGTV Companion采用模块化设计，确保系统稳定可靠：

LGTVCompanion/ ├── LGTV Companion Service/ # 后台服务核心 │ ├── companion.cpp/h # 主服务逻辑 │ ├── web_os_client.cpp/h # WebOS通信模块 │ └── button_client.cpp/h # 按钮事件处理 ├── LGTV Companion UI/ # 用户界面 ├── LGTV Companion Console/ # 命令行工具 └── LGTV Companion User/ # 用户模式守护进程

🚀 三步快速部署方案

第一步：环境准备（5分钟）

在开始配置前，确保满足以下条件：

1. 网络环境：电视和PC必须在同一局域网内（有线或无线均可）
2. 电视设置：启用"通过Wi-Fi开机"功能
   • CX系列：设置→所有设置→连接→移动连接管理→TV On with Mobile→启用
   • C1/C2/C3/C4系列：设置→所有设置→通用→设备→外部设备→TV On With Mobile→启用
3. 路由器配置：为电视设置静态IP地址，确保地址固定不变

专业建议：将电视的自动关机时间设置为8小时以上，避免与LGTV Companion功能冲突。

第二步：安装配置（3分钟）

安装LGTV Companion非常简单：

# 使用Winget安装（推荐） winget install LGTVCompanion # 或手动下载安装包 # 从项目仓库下载最新版本

安装完成后按以下步骤配置：

1. 从开始菜单启动"LGTV Companion"
2. 点击"扫描"按钮自动发现网络中的LG电视
3. 勾选"自动管理此设备"启用智能控制
4. 点击"应用"保存配置

LGTV Companion安装界面采用复古与现代结合的设计风格，体现了传统电视与现代智能控制的完美融合

第三步：测试验证（2分钟）

配置完成后进行简单测试：

1. 电视端会显示配对对话框，点击确认
2. 在LGTV Companion界面选择"测试"功能
3. 验证电视能否正常开关机
4. 关闭主界面，服务将在后台自动运行

恭喜！你的LG电视现在已经成为PC的智能扩展显示器了！

🔧 核心功能深度解析

智能电源管理

LGTV Companion的智能电源管理是其核心价值所在：

自动响应Windows事件：

• 系统关机/重启时自动关闭电视
• 系统休眠/唤醒时同步电视状态
• 用户闲置时自动关闭电视（可自定义时间）
• 多显示器拓扑变化时智能管理

技术实现原理： 通过监控Windows事件日志和系统电源状态，结合ARP协议检测设备在线状态，实现精准的电源同步控制。源码位于 LGTV Companion Service/ 目录。

强大的命令行控制

LGTV Companion提供了丰富的命令行接口，支持数百种控制命令：

# 基本电源控制 LGTVcli.exe -poweron Device1 # 打开电视 LGTVcli.exe -poweroff Device1 # 关闭电视 # 画面设置调整 LGTVcli.exe -set_picture_mode Device1 "Game" # 切换到游戏模式 LGTVcli.exe -get_system_settings Device1 picture ["backlight"] # 获取背光设置 # 批量操作多个设备 LGTVcli.exe -poweron Device1 Device2 Device3 # 同时打开多台电视

命令行工具对比： | 工具名称 | 特点 | 适用场景 | |---------|------|---------| | LGTVcli.exe | 单线程，返回完整响应 | 需要获取操作结果的脚本 | | LGTV Companion.exe | 多线程，快速执行 | 简单的开关机操作 |

自动化API集成

通过命名管道（Named Pipe）API，你可以将LGTV Companion集成到各种自动化工作流中：

支持的语言：

• PowerShell
• AutoHotKey
• Python
• C++/C#
• 任何支持命名管道的语言

应用场景示例：

# 游戏启动时自动切换到游戏模式 $gameProcess = "game.exe" Start-Process $gameProcess Start-Sleep -Seconds 5 LGTVcli.exe -set_picture_mode Device1 "Game"

示例脚本位于 Docs/Example scripts/ 目录，包含多种语言的实现。

🎮 实用应用场景

场景一：游戏玩家的完美伴侣

问题：每次玩游戏都要手动切换电视模式，影响游戏体验解决方案：游戏启动时自动切换到游戏模式

; AutoHotKey脚本示例 #IfWinActive, GameWindow F1:: ; 按F1键时执行 Run, LGTVcli.exe -set_picture_mode Device1 "Game" Run, LGTVcli.exe -set_system_settings Device1 picture '{"backlight": 100}' return

场景二：办公室的节能助手

问题：长时间离开电脑，电视持续显示静态内容解决方案：用户闲置检测自动关闭电视

配置路径：汉堡菜单图标→全局设置→用户闲置模式 推荐设置：闲置30分钟后关闭电视

节能效果对比： | 使用场景 | 传统方式耗电 | LGTV Companion方案 | 年节省电量 | |---------|-------------|-------------------|-----------| | 每日工作8小时 | 约0.5度/天 | 约0.3度/天 | 73度/年 | | 周末游戏6小时 | 约0.4度/天 | 约0.2度/天 | 52度/年 |

场景三：家庭影院的智能控制

问题：看电影时需要手动调整画面模式解决方案：根据内容类型自动优化设置

# PowerShell脚本示例 $mediaPlayer = Get-Process | Where-Object {$_.ProcessName -like "*media*"} if ($mediaPlayer) { LGTVcli.exe -set_picture_mode Device1 "Cinema" LGTVcli.exe -set_system_settings Device1 picture '{"backlight": 60, "contrast": 85}' }

🔍 常见问题排查指南

电视无法开机？试试这些排查步骤

1. 检查基础设置：

   • ✅ 确认"通过Wi-Fi开机"功能已启用
   • ✅ 检查路由器静态DHCP配置
   • ✅ 验证IP和MAC地址配置正确

2. 网络问题排查：

   • 尝试使用"发送到IP地址"的WOL选项
   • 确保网络不阻止WOL广播包
   • 检查电视是否启用"Quickstart+"或"Always ready"

3. 特殊型号注意事项：

   • 2021及之前型号：启用"Quickstart+"
   • 2022及之后型号：启用"Always ready"
   • 禁用"HDD Eco mode"避免网卡休眠

电视无法关机？可能的原因和解决方案

常见原因：

• IP配置错误
• 路由器DHCP设置问题
• 配对密钥未正确接收

解决方法：

1. 在UI中移除设备
2. 点击"应用"保存配置
3. 重新添加设备强制重新配对
4. 启用内置日志记录器查看详细输出

多显示器环境优化技巧

最佳实践配置：

1. 启用电视的"Always ready"功能
2. 在LGTV Companion中启用"响应显示拓扑变化"
3. 调整电视内置自动关机时间，避免冲突
4. 为每个显示器设置独立的电源管理策略

🏗️ 技术架构与通信协议

模块化架构设计

LGTV Companion采用清晰的模块化设计，确保系统稳定可靠：

核心模块功能：

• WebOS客户端模块：处理与LG电视的WebSocket通信
• 按钮客户端模块：处理用户界面交互事件
• IPC通信模块：实现进程间通信
• 事件监控模块：监控Windows系统事件

通信协议解析

WebOS API通信：

• 使用WebSocket协议与电视通信
• JSON格式数据交换
• 支持双向通信和事件订阅

Windows事件监控：

• 监控Windows事件日志
• 使用WMI接口获取系统信息
• 支持用户闲置检测

网络唤醒机制：

1. 构建Magic Packet（魔术包）
2. 通过UDP广播发送到目标MAC地址
3. 电视网卡接收魔术包后唤醒系统
4. 建立WebSocket连接进行后续控制

🔌 生态集成与扩展方案

与智能家居系统集成

Home Assistant集成示例：

# Home Assistant配置示例 automation: - alias: "Turn on TV when PC starts" trigger: platform: state entity_id: binary_sensor.pc_power to: "on" action: service: shell_command.lgtv_poweron shell_command: lgtv_poweron: "LGTVcli.exe -poweron Device1"

自定义脚本开发

利用LGTV Companion的API，你可以开发各种自定义脚本：

# Python脚本示例：根据时间自动调整设置 import datetime import subprocess def adjust_tv_settings(): hour = datetime.datetime.now().hour if 8 <= hour < 20: # 白天 subprocess.run(['LGTVcli.exe', '-set_system_settings', 'Device1', 'picture', '{"backlight": 80, "color": 50}']) else: # 夜间 subprocess.run(['LGTVcli.exe', '-set_system_settings', 'Device1', 'picture', '{"backlight": 40, "color": 45}']) # 定时执行 adjust_tv_settings()

📋 系统要求与兼容性

最低系统要求

兼容性说明

支持的电视功能：

• ✅ 电源开关控制
• ✅ 画面模式切换
• ✅ 音量调节
• ✅ HDMI输入选择
• ✅ 系统信息获取
• ✅ 背光亮度调整
• ✅ 色彩设置调整

已知限制与注意事项：

1. 网络要求：电视和PC必须在同一子网/VLAN内
2. 像素刷新期间：部分旧型号可能无法唤醒
3. 固件版本：建议保持电视固件最新
4. 路由器配置：需要支持WOL广播

性能优化建议

推荐配置参数：

{ "user_idle_timeout": 1800, // 30分钟闲置时间 "wol_timeout": 5000, // WOL超时5秒 "retry_count": 3, // 重试次数 "enable_logging": false, // 生产环境关闭日志 "auto_discovery": true // 自动发现设备 }

💡 总结：你的OLED电视智能管家

LGTV Companion不仅仅是一个工具，更是OLED电视用户的智能管家。通过自动化电源管理、强大的命令行控制和灵活的API集成，它彻底解决了PC与电视联动的所有痛点。

为什么选择LGTV Companion？

1. 完全自动化：一次设置，永久生效，真正实现"设置即忘"
2. 烧屏防护：智能闲置检测，有效保护OLED屏幕
3. 高度可定制：支持脚本和API，满足个性化需求
4. 稳定可靠：经过大量用户验证的生产级稳定性
5. 持续更新：活跃的社区支持和持续的功能改进

立即开始使用：

# 克隆仓库获取源码 git clone https://gitcode.com/gh_mirrors/lg/LGTVCompanion # 或直接安装 winget install LGTVCompanion

无论是游戏玩家、办公用户还是家庭影院爱好者，LGTV Companion都能为你带来前所未有的便利体验。告别繁琐的手动操作，拥抱智能化的电视管理新时代！

小贴士：遇到任何问题或需要帮助，可以查看项目文档或加入社区讨论。LGTV Companion拥有活跃的用户社区和开发者支持，确保你获得最佳的使用体验。

【免费下载链接】LGTVCompanionPower On and Off WebOS LG TVs together with your PC项目地址: https://gitcode.com/gh_mirrors/lg/LGTVCompanion