https://github.com/basemax/battery-monitor
Battery Monitor is a Python script that displays battery information on your system in a user-friendly format. It shows the battery percentage, charging status, time left, and battery health, with colored output to improve readability. The script works across multiple platforms including Windows, macOS, and Linux.
https://github.com/basemax/battery-monitor
battery-charger battery-info battery-laptop battery-level battery-life battery-management-system battery-monitor battery-percentage battery-status battery-tracker laptop-battery py python python-battery-tracker
Last synced: 3 months ago
JSON representation
Battery Monitor is a Python script that displays battery information on your system in a user-friendly format. It shows the battery percentage, charging status, time left, and battery health, with colored output to improve readability. The script works across multiple platforms including Windows, macOS, and Linux.
- Host: GitHub
- URL: https://github.com/basemax/battery-monitor
- Owner: BaseMax
- License: mit
- Created: 2025-01-10T22:45:45.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-01-11T02:29:47.000Z (4 months ago)
- Last Synced: 2025-02-26T05:55:47.620Z (3 months ago)
- Topics: battery-charger, battery-info, battery-laptop, battery-level, battery-life, battery-management-system, battery-monitor, battery-percentage, battery-status, battery-tracker, laptop-battery, py, python, python-battery-tracker
- Language: Python
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Battery Monitor
**Battery Monitor** is a Python script that displays battery information on your system in a user-friendly format. It shows the battery percentage, charging status, time left, and battery health, with colored output to improve readability. The script works across multiple platforms including Windows, macOS, and Linux.
### Features
- Cross-platform support (Windows, macOS, Linux)
- Displays battery percentage, charging status, and time left
- Provides battery health status with color-coded outputs
- Clear and visually appealing terminal output similar to `screenfetch`
### Output Example
```bash
==============================
Battery Monitor
==============================
System: Windows 11
Machine: AMD64
Processor: Intel64 Family 6 Model 142 Stepping 10, GenuineIntel
==============================
Battery Percentage: 100%
Plugged In: Yes
Charging: Yes
Time Left: Charging
Battery Health: Healthy
==============================
Powered by Battery Monitor (github.com/basemax)
```
### Installation
1. Clone the repository:
```bash
git clone https://github.com/BaseMax/battery-monitor.git
cd battery-monitor
```
2. Install the required Python dependencies:
```bash
pip install -r requirements.txt
```
### Requirements
- Python 3.x
- `psutil` library for fetching battery status
- `termcolor` library for colored output
You can install the required libraries by running:
```bash
pip install psutil termcolor
```
### Usage
To run the script, simply execute:
```bash
python battery-monitor.py
```
This will display your battery information in a clean, user-friendly format.
### File Structure
```
battery-monitor/
├── LICENSE
├── README.md
├── battery-monitor.py
├── requirements.txt
└── .git/
```
### License
MIT [License](license).
Copyright 2025, Max Base