PowerPulse is a lightweight, cross-platform battery monitoring tool designed to track, store, and visualize your device's battery information. Keep tabs on your battery's charge cycles, analyze usage patterns, and receive timely notifications to optimize battery life.
- Real-time Battery Monitoring: Track charge level, charging status, and estimated time remaining
- Historical Data: Store and visualize your battery's history over time
- Statistical Analysis: Gain insights from discharge rates, cycle counts, and usage patterns
- Customizable Notifications: Get alerts for low battery, full charge, or custom thresholds
- Dual Interface: Use either the intuitive GUI or efficient CLI
- Cross-Platform: Works on Windows, macOS, and Linux
- Lightweight: Minimal resource usage while running in the background
Download the latest executable for your platform from the releases page.
# Clone the repository
git clone https://github.com/kuroonai/powerpulse.git
cd powerpulse
# Install with pip
pip install .
# Or for development
pip install -e ".[dev]"# Launch the graphical interface
powerpulse --gui# Show current battery information
powerpulse info
# Start monitoring with 30-second intervals
powerpulse monitor --interval 30
# Display statistics for the last 7 days
powerpulse stats --days 7
# Show battery history graph
powerpulse plot --days 14
# Configure notifications
powerpulse notification --list
powerpulse notification --type low_battery --level 15 --enable- Python 3.8+
- Dependencies listed in
requirements.txt
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install development dependencies
pip install -r requirements-dev.txtpytestContributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
- Naveen Vasudevan - kuroonai
- Thanks to all contributors who have helped shape PowerPulse
- Inspired by the need for better battery management across platforms