A lightweight battery monitoring utility that displays persistent popup warnings when battery levels fall below critical thresholds. Built with raylib and designed for Linux systems running X11 or Wayland.
- gcc compiler
- make
- Linux only: Uses Linux-specific battery information from
/sys/class/power_supply/BAT0/
- Optimal: i3 or Sway window managers with automatic configuration
- Other WMs: May work but window behavior (floating, always-on-top, sticky) must be configured manually
- Desktop Environments: May function but could conflict with built-in battery notification systems
If your OS / Distro / Window Manager isn't implemented yet, you can make a PR on this repo.
Be sure I'll take the time to review and merge it if it's good.
You can download and set up blw automatically using this command :
curl https://raw.githubusercontent.com/viastolfi/blw/refs/heads/main/install.sh | bash
If you want to manually download and set this up you can follows the different steps of the setup.sh file
You may have to change some variables in the setup.sh so the software works
- (crontab -l 2>/dev/null; echo "* * * * * ~/.local/lib/blw.sh ~/.local/bin ~/.local/state/blw >> /tmp/blw.log") | crontab -
+ (crontab -l 2>/dev/null; echo "* * * * * your_path/blw.sh relative_path_to_exectuable path_to_state_file >> /tmp/blw.log") | crontab -If there is any platform dependant error while building the project, you can refer to the Makefile and add raylib downloading for it.
Do not hesitate to make a PR of it, I will review it with pleasure.
This project uses raylib which is licensed under the zlib/libpng license. See raylib-5.5_linux_amd64/LICENSE for details.
This project is itself licensed under GPL-3.0 License. See LICENSE.md for more details
This project is entirely made by me (ASTOLFI Vincent). I suggest you to check on my github profile if you want to see the other project I've done for my studies or the ones I do in my free time.