View On GitHub Download Source (.zip) Download Source (.tar.gz) Download Binary (.deb)
## Features and Screenshots Battery Monitor notifies the user: 1. Whether [battery is present](#initial-state), 2. When charger is [plugged in](#charging-state), 3. When charger is [unplugged](#discharging-state), 4. When battery is [full and charger is not unplugged](#not-charging-state), 5. When battery is [critically low](#critically-low-battery-state). Additionally, it can show notifications: 1. At three user-defined battery percentage during discharging, 2. At one user-defined battery percentage during charging, 3. Along with playing a sound (Mute option is not available yet). #### Initial State#### Charging State
#### Discharging State
#### Not Charging State
#### Critically Low Battery State
### Settings Window 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. **N.B.** If you change any configuration, it will be in action only after next reboot. ## Dependencies ### Build Dependencies The following dependencies are required to build **Battery Monitor**. ```$ gettext python3 python3-setuptools python3-sphinx python3-sphinx-argparse ``` ### Runtime Dependencies The following dependencies are required to run **Battery Monitor**. ```$ acpi gir1.2-appindicator3-0.1 gir1.2-gtk-3.0 gir1.2-notify-0.7 python3 python3-configobj python3-gi python3-setproctitle python3-tldextract ``` ### Debian/Ubuntu based distro To install runtime dependencies on Debian/Ubuntu based systems, run: ``` sudo apt install acpi gir1.2-appindicator3-0.1 gir1.2-gtk-3.0 \ gir1.2-notify-0.7 python3 python3-configobj python3-gi \ python3-setproctitle python3-tldextract ``` **Note**: If you are using `gdebi` to install **Battery Monitor** from a `.deb` file, it will auto matically install the dependencies and you can skip this step. ### Other Linux-based distro Remove `apt install` in the command given in [Debian/Ubuntu based distros](#debianubuntu-based-distro) and use the command for the package manager of the target system(eg. `yum install`, `dnf install`, `pacman -S` etc.) **Note**: There might be cases where one or more dependencies might not be available for your system. But that is highly unlikely. In such situations, please [create an issue](#issue-tracking-and-contributing). ## Build and Install the Latest Version ### Debian/Ubuntu based systems There are two methods, this app can be installed/used on a Debian/Ubuntu based system. First, download and unzip the source package using: ``` wget https://github.com/mamolinux/battery-monitor/archive/refs/heads/master.zip unzip master.zip cd battery-monitor-master ``` 1. **Option 1:** Manually copying necessary files to root (`/`). For that, follow the steps below: 1. Install python package using `pip3`: ``` sudo pip3 install . ``` It will install all files under `/usr/local/` 2. Compile `schemas` using: ``` sudo glib-compile-schemas /usr/local/share/glib-2.0/schemas ``` 2. **Option 2:** Build a debian package and install it. To build a debian package on your own: 1. After using `cd battery-monitor-master`, run: ``` dpkg-buildpackage --no-sign ``` This will create a `battery-monitor_*.deb` package at `../battery-monitor-master`. 2. Install the debian package using ``` sudo dpkg -i ../battery-monitor_*.deb sudo apt install -f ``` After it is installed, run `battery-monitor` from terminal or use the `battery-monitor.desktop`. #### Other Linux-based systems 1. Install the [dependencies](#other-linux-based-distro). 2. From instructions for [Debian/Ubuntu based systems](#debianubuntu-based-systems), follow **Option 1**. ## 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](#issue-tracking-and-contributing). We would like to debug the issue and help you. ## Issue Tracking and Contributing If you are interested to contribute and enrich the code, you are most welcome. You can do it by: 1. If you find a bug, to open a new issue with details: [Click Here](https://github.com/mamolinux/battery-monitor/issues) 2. If you know how to fix a bug or want to add new feature/documentation to the existing package, please create a [Pull Request](https://github.com/mamolinux/battery-monitor/compare). **NB:** Using the issue template or PR template is **not** mandatory. ### For Developers If you want to test **Battery Monitor**, 1. Get the source package and unzip it using: ``` wget https://github.com/mamolinux/battery-monitor/archive/refs/heads/master.zip unzip master.zip cd battery-monitor-master ``` 2. Make desired modifications. 3. Manually install using [option 2](#2-build-and-install-from-source). 4. Test it by running in debug mode from terminal: ``` battery-monitor --verbose ``` ### Translation All translations are done using using [Launchpad Translations](https://translations.launchpad.net/mamolinux). To help translate **Battery Monitor** in your favourite language follow these steps: 1. Go to [translations page](https://translations.launchpad.net/mamolinux/trunk/+pots/battery-monitor) on Launchpad. 2. Click on the language, you want to translate. 3. Translate strings. 4. Finally, click on **Save & Continue**. ## Contributors ### [Himadri Sekhar Basu](https://mamolinux.github.io) Current Maintainer. ### [Maksudur Rahman Maateen](https://github.com/maateen) He is the original creator of now archived [Battery Monitor](https://github.com/maateen/battery-monitor). We are highly grateful to him for offering this useful app and providing the base for the current [Battery Monitor](https://github.com/mamolinux/battery-monitor). Please take a minute to thank him. ### [Safwan Rahman](https://github.com/safwanrahman) 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](https://abougouffa.github.io/) 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](https://github.com/yochananmarqos) 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](https://github.com/benley) He has improved the build process and added modern Python setuptools packaging. Please take a minute to thank him. ## Donations I am a freelance programmer. So, If you like this app and would like to offer me a coffee ( ☕ ) to motivate me further, you can do so via: