Battery Monitor

Battery Monitor is a utility tool developed on Python3 and PyGtk3. It will notify user about charging, discharging, not charging and critically low battery state of the battery on Linux (Surely if battery is present).

• Dependencies
• Installation
  • Common Method
  • For Ubuntu and its derivatives
  • For Beta Testers
  • For Developers
• Configuration
• Issue Tracking
• Screenshots
  • Initial State
  • Charging State
  • Discharging State
  • Not Charging State
  • Critically Low Battery State
• Roadmap
• Changelog
• Contributors

Dependencies

• python3
• python3-gi
• libnotify-dev
• acpi

To use Battery Monitor you need these dependencies installed on your PC.

Installation

Common Method

wget https://github.com/maateen/battery-monitor/archive/master.zip

unzip master.zip

cd battery-monitor-master

sudo make install

That’s all. Battery Monitor Stable is installed on your system.

For Ubuntu and its derivatives

Let’s install from PPA (currently supported: 14.04, 16.04, 16.10, 17.04 & 17.10):

sudo add-apt-repository ppa:maateen/battery-monitor -y

sudo apt-get update

sudo apt-get install battery-monitor -y

That’s all. Battery Monitor Stable is installed on your system.

For Beta Testers

wget https://github.com/maateen/battery-monitor/archive/devel.zip

unzip devel.zip

cd battery-monitor-devel

sudo make install

That’s all. Battery Monitor Beta is installed on your system.

For Developers

Now you can automatically test Battery Monitor from Terminal:

python3 battery-monitor.py --test

Or, if you’ve already installed:

battery-monitor --test

Configuration

Every time, you will start/restart your PC, it will run automatically in background. But as it’s your first time, let’s start it by yourself. Please, search for Battery Monitor launcher in your menu entries. Then simply click on it. You will get notified that Battery Monitor has started.

If you want to adjust settings for Battery Monitor, then simply search for Battery Monitor GUI in your menu entries. Then click on it and you will see a new window. Now adjust your settings and save it. Your adjustment will be in action after next reboot.

Issue Tracking

If you find a bug, please open a new issue with details: https://github.com/maateen/battery-monitor/issues

Screenshots

Initial State

Charging State

Discharging State

Not Charging State

Critically Low Battery State

Roadmap

Please take a look at our milestones to get clear idea about our roadmap. They are dynamic and they can change frequently on user requests.

Changelog

v0.5.3

• Fixed issue #45
• Support for Ubuntu 17.10 has been added.

v0.5.2

• Fixed issue #41
• Fixed issue #42
• Introduced a Test feature for developers.

v0.5.1

• Fixed issue #35
• Fixed issue #39

v0.5

• Developed a GUI to manage the custom warning easily.
• Minimized CPU consumption.
• Added Makefile for easy installation and upgradation.
• Re-structured the project.
• Support for Ubuntu 14.04, 16.04, 16.10 and 17.04 has been added.

v0.4

• Reformatted the code in a new style.
• Optimized the code in a way so that Battery Monitor consumes a little resource of your PC.

v0.3

• Fixed issue #7, decreased CPU consuming from 40% to below 0.7%
• Fixed issue #4, Added warning at 30% battery life (temporary solution, will be replaced by a GUI in near future).
• Fixed issue #6, Added an entry in dash.

v0.2.1

• Added trusty support.

v0.2

• Added Critically Low Battery warning when battery is below 10%.
• Added ctrl+C pressing support to stop the battery-monitor command on terminal.

v0.1

• Initial release.

Contributors

Safwan Rahman

One of the biggest contributor of Battery Monitor. He has reformated the code in a new style. The style represents the code easier to understand. Also he has optimized the code in a way that Battery Monitor consumes a little resource of your PC. Please take a minute to thank him.

Abdelhak Bougouffa

Another biggest contributor of Battery Monitor. He has fixed some bugs and optimized Battery Monitor in a way so that it consumes lower CPU and RAM than before. Please take a minute to thank him.