i3-battery-popup

A script that shows messages to the user when the battery is almost empty. I wrote this because I use i3wm, was frustrated by the lack of a nice battery notification, and as a nice exercise in shell scripting.

What it does

This script regularly checks your battery charge and shows you a nice warning in a popup if you are about to completely drain your battery. It improves on other battery warning scripts like this one by:

• Using a Tk-based popup (if you want) which you can configure to show on all workspaces. i3's nagbar doesn't do that.
• Or using a nice notify-send desktop notification
• Using the nagbar if you prefer that - or if you don't have Tk.
• Optionally playing a sound to warn you when the battery gets low.
• Doing what you want: you can tell it at which battery percentages you want to be warned. Currently it will try to show you 2 messages before the lower limit is reached.
• Supporting multiple batteries. My laptop has 2 batteries, for example.

How to use it

• Download the script and make sure it's on your PATH
• Call the script in your i3 config file: exec --no-startup-id i3-battery-popup

Installing on Arch Linux

There's now a package on Arch Linux's AUR: https://aur.archlinux.org/packages/i3-battery-popup-git

Showing the message everywhere

If you have wish installed this script will show you a popup window. To get wish, you probably need to install tk on your Linux distribution.

The nice thing is that we can make the popup window sticky; that doesn't work with i3-nagbar. To make the popup sticky so it shows everywhere, add this to your i3 config:

for_window [title="Battery Warning"] sticky enable

Desktop notification

Specify -n to use those nice pretty desktop notifications in the top right corner of your screen. I guess it depends on something like libnotify but I'm not really sure. Please correct me if I'm wrong.

Options

• -L : Sets the percentage at which the first popup shows. Default is 10%

• -l : The percentage at which the second popup shows. Default: half of the percentage given by -L, not compatible with -I

• -I : Specify on how many battery % change to re-send message,
  Note: the check is run every -t (default 5m) so at minimum we will wait 5m before sending any new message, set -t lower for more precise interval notifications.
  Disables the -l parameter
  Example: -I 2% will send notfication every 2% battery change after -L was hit. Default: disabled

• -m : The message to show to the user
  Default: Warning: Battery is getting low

• -t : The time interval the script waits before checking the battery again. Give this a value in seconds: 10s, or in minutes: 5m. Default: 5m

• -n : Use notify-send for desktop notification

• -i : Specify the icon to use with -n

• -N : Don't use Tcl/Tk dialog. Use i3-nagbar.

• -f : Font to use for i3-nagbar Fonts are specified same as in i3 (https://i3wm.org/docs/userguide.html#fonts)
  For example: pango:DejaVu Sans Mono 10

• -s : Play a sound with paplay when notifying. Takes a path to a sound as argument. The file must exist. Default: no sound.

• -v : Specifies the percentage of the volume of the sound played with -s option. This value must be an integer greater than 0 and smaller than 100. Default: 100

• -D : Enable debug output

• -F : Specifies the logfile to write to