debian-scripts/battery-monitor.sh
2024-10-23 20:56:09 -04:00

58 lines
2.2 KiB
Bash
Executable File

#/bin/bash
# battery-monitor.sh
# This program lets the user know when the battery needs to be charged.
# Copyright (c) 2024, Scott C. MacCallum (scott@scm-guru.live).
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Affero General Public License for more details.
# You should have received a copy of the GNU Affero General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
# To do. Add code to verify that the user is root, or has run the script with
# sudo. Add code to verify that the bc program is installed.
# Change this variable to the group that should be informed of a need to
# charge the battery. On GNU/Linux distributions users are often part of
# their own group e.g. scm.
group=""
# Change the battery variable to your batteries identification e.g. BAT0.
battery=""
charge=$(cat /sys/class/power_supply/$battery/charge_now)
discharge=$(cat /sys/class/power_supply/$battery/current_now)
hours=$(echo "scale=2; $charge / $discharge" | bc -l)
minutes=$(echo "scale=2; $hours * 60" | bc -l)
# Change the minimum variable to the minimum amount of minutes that a battery
# has left before the group is informed to recharge it e.g. 50.00. When I
# tested this and the battery-suspend.sh script, I was surprised to discover
# that the computer turned off despite having reported that there was 10
# minutes left! I created the battery-status.sh script to aid in my
# understanding of what was going on, and I discovered a variance of about 10
# minutes plus/minus each time that I ran it. Keep the minus 10 minutes in
# mind when setting the minimum value.
# YOU'VE BEEN WARNED!
minimum=
if (( $(echo "$minutes < $minimum" | bc -l) )); then
echo "Suspending the computer! Battery charge is needed!" | wall
sleep 3
systemctl suspend
fi
exit 0