Home
Softono

PCTools

Open source MIT Python
150
Stars
14
Forks
6
Issues
2
Watchers
4 months
Last Commit

 About PCTools

一个简单的python脚本,支持Ha远程启动Windows自定义程序,调节音量等等。同时同步Aida64数据到Ha

Platforms

Web Self-hosted Windows

Languages

Python

Links

Need Help Installing PCTools?

We provide expert installation service for this software. Our team will install, configure, and secure PCTools on your server. plans start at just $30.

🖥️ PCTools

简单的 Python 程序,让 Windows 与 Home Assistant 无缝集成,实现硬件监控、远程控制等功能。

GitHub Release GitHub Downloads GitHub Stars License


✨ 功能特性

功能 描述
📊 Aida64 监控 定时更新选定传感器数据
🎮 远程命令 自动同步 commands 文件夹内的 .bat .lnk 文件到 HA
📸 Web 监控 屏幕截图 / 摄像头 / 实时画面串流
💬 消息通知 监听 HA 文本输入,以 Toast 消息显示
🌐 侧边栏网页 快捷键呼出 HA 网页侧边栏
⌨️ 快捷键联动 快捷键触发 HA 二元传感器
📱 前台应用反馈 自动上报当前应用名称,支持 Runtime Tracker
🖥️ 显示器控制 多显示器亮度 / 开关 / DDC-CI 命令
🔊 音量控制 控制 Windows 系统音量
🌙 深色模式 切换系统/应用深色模式
📶 蓝牙控制 开关系统蓝牙
命令行 执行自定义 CMD/PowerShell
🎨 壁纸引擎 控制 Wallpaper Engine
⌨️ 按键模拟 模拟键盘输入(含媒体键)
🔗 URL 启动器 打开自定义 URL

Web 监控端点:

  • 屏幕截图:http://127.0.0.1:5000/screenshot.jpg
  • 摄像头:http://127.0.0.1:5000/video_feed
  • 实时画面:http://127.0.0.1:5000/screen

📷 截图展示

🖼️ 软件界面 GUI
📱 HA 界面

另类副屏 (推荐配合 HA_Helper)

副屏

主页面

主页面

🚀 快速开始

1️⃣ 安装环境

方式一:下载 Releases 内的压缩包(内置运行环境)

方式二:手动配置

# Python 3.12
pip install -r requirements.txt

2️⃣ 安装第三方依赖软件(可选)

依赖 用途
MQTT 服务器 接入 Home Assistant
Aida64 硬件信息监控
Twinkle Tray 显示器亮度调节

3️⃣ 配置依赖

  1. Aida64:开启内存共享并勾选需要的传感器数据
  2. Twinkle Tray:确保能正常读取显示器信息
  3. 壁纸引擎:启动以支持相关操作

💡 新增/修改传感器后,如有冲突,请删除 HA/MQTT 内的设备并重启软件

4️⃣ 运行程序

  1. 运行 打开GUI.bat 启动界面
  2. 进入设置配置参数(按回车保存
  3. 启用所需插件(建议重启程序
  4. 点击启动,在 HA 的 MQTT 集成中查看新设备

5️⃣ 开机自启(可选)

设置中点击 自启动,程序将后台运行,在系统托盘查看图标


📋 开发计划

  • 键盘快捷键联动
  • 代码优化
  • 插件逻辑优化
  • 电脑风扇控制
  • Toast 多按钮回调
  • 插件市场
  • 媒体控制
  • 网易云歌词同步

💡 推荐搭配

软件 描述
OpenRGB RGB 灯光控制,支持 HA 接入
HASS.Agent 更稳定的同类工具

致谢


📝 其他

  • 支持无头模式:python core.py
  • 部分页面需切换后才会刷新