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

• Dependencies
• Installation
  • Common Method
  • For Ubuntu and its derivatives
  • For Arch Linux and its derivatives
  • For Beta Testers
  • For Developers
• Uninstall Daily Build
• User Manual
  • Auto Start
  • Settings
• Issue Tracking
• Screenshots
  • Initial State
  • Charging State
  • Discharging State
  • Not Charging State
  • Critically Low Battery State
• Roadmap
• Changelog
• Contributors

$ sudo systemctl stop battery-monitor
$ sudo systemctl disable battery-monitor
$ sudo rm -f /usr/local/bin/battery-monitor
$ sudo rm -rf /etc/battery-monitor
$ sudo rm -f /etc/systemd/system/battery-monitor.service
$ sudo systemctl daemon-reload

• acpi
• python3
• python3-gi
• python3-setuptools
• libnotify4
• libappindicator3-1
• gir1.2-appindicator3-0.1

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

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.

Let's install from PPA (currently supported: 14.04, 17.10 & 18.04; we're struggling with Ubuntu 16.04 right now):

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.

The stable version, git version and the beta version are available in the Arch User Repository:

Stable: battery-monitor Git: battery-monitor-git Beta: battery-monitor-devel-git

If you're not sure how to use the AUR, please see the Manjaro and Arch wiki entries about it. You will need an AUR helper to install packages.

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.

Now you can automatically test Battery Monitor from Terminal:

python3 run.py --test

Or, if you've already installed:

battery-monitor --test

Every time Battery Monitor starts automatically after PC boots up. It pops up notifications and you see its Icon in the system tray. To reveal the other beauties, you can click on the icon. Currently, there are three menus: Settings, About and Quit.

You can also start battery monitor from the menu entries. Please, search for Battery Monitor launcher in the menu entries and simply click on it. In case, if Battery Monitor doesn't start automatically, please open an issue. We would like to debug the issue and help you.

In Settings menu, you can configure and adjust settings for Battery Monitor.

Here, you can set the battery percentage levels at which you want to get notifications. The warning levels are listed in ascending order. Critical Battery Warning refers to the lowest level while First Custom Warning refers to the highest level. Custom warning levels are optional.

If you change any configuration, it will be in action only after next reboot.

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

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

• Restructured and reformatted the whole project.
• Added system tray icon (Issue #46)
• Fixed issue #51
• Added some new icons (Issue #53)
• Added Ubuntu 18.04 LTS support (Issue #55)
• Fixed issue #61

• Fixed issue #48

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

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

• Fixed issue #35
• Fixed issue #39

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

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

• 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.

• Added trusty support.

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

• Initial release.

He has reformatted 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.

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.

He is our official package maintainer in AUR. He has put Arch users' life at ease. Please take a minute to thank him.

He has improved the build process and added modern Python setuptools packaging. Please take a minute to thank him.