搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

krisgfx9/Wireless-Device-Battery-Monitor

系统工具

在 Windows 任务栏直接显示无线鼠标、耳机、键盘和手柄的电量,无需厂商软件。

3,643
312
C++
GPL-3.0
创建于 1 天前

项目介绍

Wireless Battery 是一个面向 Windows 10/11 的小型 C++/Win32 托盘程序,用来在任务栏显示无线鼠标、键盘、耳机和手柄的剩余电量。它通过 HID 直接向设备发送只读电量查询,不需要安装 Logitech G HUB、Razer Synapse、Corsair iCUE 等厂商软件。对于蓝牙设备、标准 HID 电量上报、XInput 设备以及 HeadsetControl 支持的耳机,程序还提供通用回退方案。

默认显示方式是通知区域旁的小部件,每台设备显示图标和百分比:电量低于或等于 15% 时数字变红,充电时显示蓝色闪电,设备休眠时显示变暗的最近读数。任务栏为垂直方向或无法放置小部件时,程序会自动切换到托盘图标模式。

快速使用

  1. 从最新发布页下载 WirelessBattery-Setup-<version>.exe。
  2. 运行安装程序并一路点击即可。它不需要管理员权限,也不需要额外运行时、驱动或厂商软件,会创建开始菜单项和卸载入口。
  3. 查看通知区域旁的电量显示。点击可打开菜单,逐台隐藏或显示设备、切换显示模式、立即刷新,或设置开机启动。

不想安装时,可以下载便携 zip,解压后直接运行 WirelessBattery.exe。可执行文件没有代码签名,SmartScreen 可能提示风险,README 给出的处理方式是选择“更多信息 → 仍要运行”,或者自行从源码构建。Windows 11 上新的托盘图标通常会进入 ^ 溢出区,需要手动拖到任务栏。

需要脚本化查询时,程序支持 --list 输出设备与电量,--dump 输出 HID 集合,--quit 关闭正在运行的实例。

从源码构建

准备 MinGW-w64(例如通过 MSYS2 安装 mingw-w64-x86_64-gcc make)后运行 make;在已把 g++ 和 windres 加入 PATH 的普通 cmd 中也可以使用 build.bat。构建安装包和便携 zip 还需要 Inno Setup,然后运行 powershell -File installer\build-installer.ps1 -Version 1.0.0。脚本会下载固定版本的 HeadsetControl 并校验其校验和;如果程序旁边没有 headsetcontrol.exe,只会失去它支持的额外耳机型号。

设备支持与使用约束

支持面较广但并不均衡:Logitech、Razer、SteelSeries、Corsair、HyperX、Glorious、ASUS ROG、ZOWIE、若干国产品牌外设、DualShock 4/DualSense、GameSir 和 Xbox 手柄都有专用驱动。README 列出了实际测试过的型号,并说明大部分型号是依据协议文档和其他项目实现的、尚未在真机上验证,因此欢迎用户通过问题跟踪页反馈。

会影响使用的限制包括:任务栏小部件只出现在主显示器;Windows 11 居中的任务栏按钮很多时可能与小部件重叠;休眠设备可能不应答,程序保留变暗的最后读数;Keychron 键盘只能通过蓝牙报告电量,2.4 GHz 接收器不提供;MSI 外设、Razer Kraken/Barracuda 耳机、HyperX Pulsefire 鼠标和通过 Xbox 适配器连接的 Xbox 无线耳机暂不支持。使用 ATK 耳机支持时需要关闭 ATK 桌面应用。项目采用 GPL-3.0-or-later,分发修改版时必须同样开源并保留该许可证。

HotRepo 点评

在 2026 年 11 月 17 日的首条记录中,该项目进入 HotRepo 新项目榜,约七小时的统计窗口内新增 103 个 Star 和 15 个 Fork。对一个细分工具来说这是不错的开局,而且仓库不是下载包装:有 C++ 源码、按厂商划分的驱动、明确的构建流程,以及清楚标注的已测试和未测试设备。对读者而言,主要判断点是设备是否在支持列表内以及是否只用 Windows;在单主屏、设备来自已列出厂商的情况下,这个项目的用途最直接。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

Hacker News 讨论

Wireless Device Battery Monitor
▲ 1 · 0 条评论 · 2026年11月18日

相关推荐

  1. Binaryify/MonitorBar不依赖 DDC/CI,通过澎湃 OS 局域网接口在菜单栏/托盘切换显示器输入源和音量,并附带调光与分辨率切换。Go162
  2. SpriteOvO/AirPodsDesktop让 Windows 和 Linux 桌面拥有 AirPods 电量显示、入耳检测和连接弹窗,面向在电脑上用苹果耳机的用户。C++3,777
  3. AprilNEA/OpenLogi不登录账号的本地罗技 Options+ 替代品,用于重映射按键、DPI 与 SmartShift。Rust24,428
  4. typecraft-dev/oma-cast给 Omarchy 用户的键盘启动器,按使用习惯给应用和 Omarchy 命令排序。JavaScript418
  5. umarz317/WatchPointer用 Apple Watch 通过蓝牙控制 Mac 光标,支持点击、拖拽和滚动。Swift128