2.5 KiB
🪫 EyeOnPower — Battery Monitor
A real-time Windows battery level monitor that displays battery percentage, charging status, remaining time, and current date/time in a always-on-top corner widget.
EyeOnPower is a lightweight desktop widget that sits in the bottom-right corner of your screen, showing your battery level at a glance. It supports expanding/collapsing detailed battery info, and toggling window always-on-top.
✨ Features
| Feature | Description |
|---|---|
| 🔋 Real-time Battery % | Live battery percentage display with large font & progress bar |
| 🔌 Charging Status | AC power / charging / fully charged / low battery indicators |
| ⏱️ Remaining Time | Estimated remaining battery life (hours & minutes) |
| 📅 Date & Time | Current date, weekday, and time always visible |
| 🔍 Detailed Info | Expandable battery details (manufacturer, capacity, health, voltage, serial...) |
| 📌 Always-on-Top | Toggleable window pinning |
| 🔗 Dual Data Source | Win32 API (GetSystemPowerStatus) + WMI (Win32_Battery) |
Detailed Battery Info (expandable)
- Manufacturer / Battery name
- Chemistry type (Li-ion, Li-polymer, etc.)
- Design capacity & full charge capacity (mWh / Wh)
- Battery health % (full/design capacity ratio, color-coded)
- Design voltage (mV / V)
- Estimated charge remaining
- Serial & Device ID
🚀 Quick Start
Prerequisites
- Windows (laptop / notebook with battery)
- Python 3.7+
Install & Run from Source
# Install dependencies
pip install PyQt5 wmi
# Run
python EyeOnPower.py
Run the Compiled EXE
Just double-click EyeOnPower.exe — no Python required.
🎮 Usage
- Title bar button (
👁️ 电量守望者): expand / collapse detailed battery info - Pin button (
📌 置顶): toggle always-on-top - Widget automatically stays in the bottom-right corner
📦 Project Structure
EyeOnPower/
├── EyeOnPower.py # Main program (PyQt5 battery monitor)
├── EyeOnPower.exe # Compiled executable (no Python needed)
└── README.md # This document
📄 License
This project is licensed under the MIT License. See LICENSE for details.
🙏 Note
✓ The widget is always-on-top by default, so it stays visible above other windows. ✓ Low battery warning: progress bar turns red at ≤20%, orange at ≤50%, green otherwise. ✓ Battery health is color-coded: green ≥80%, orange ≥60%, red below.