Skip to content
This repository has been archived by the owner. It is now read-only.
Branch: master
Go to file

Latest commit


Failed to load latest commit information.

Battery Monitor [Deprecated]

⚠️ We took some initiatives to revamp the project but we couldn't gather enough contributor to move the project forward. So, we are backing off finally. As it is licensed under GPL-3.0, please feel free to fork it and start on you own. To uninstall the daily build, please follow this.

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

Uninstall Daily Build

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


Common Method

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

For Arch Linux and its derivatives

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.

For Beta Testers

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 --test

Or, if you've already installed:

battery-monitor --test

User Manual

Auto Start

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.

Battery Monitor GUI

Issue Tracking

If you find a bug, please open a new issue with details:


Initial State

Initial State

Charging State

Charging State

Discharging State

Discharging State

Not Charging State

Not Charging State

Critically Low Battery State

Critically Low Battery State


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.





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




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


Safwan Rahman

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.

Abdelhak Bougouffa

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.

Yochanan Marqos

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

Benjamin Staffin

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


An X-platform utility tool developed on Golang, notifies about charging, discharging, and critically low battery state of the battery.




You can’t perform that action at this time.