#/bin/bash

# battery-monitor.sh

# This program lets the user know when the battery needs to be charged, and
# suspends the computer once a user defined minimum is reached. It has been
# tested to work on a Debian 12 GNU/Linux x86_64 default console
# installation. The installation of bc is required.

# 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
# a group that is the same as their login name, which works well if you only
# want your user to be informed in the console.

group="scm"

# Change the battery variable to your batteries identification.

battery="BAT0"

# If the battery is fully charged.

if (( minutes == 0 )); then
    exit 0
fi

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
# is estimated to have left before the group is informed to recharge it. 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, so the system is clearly making
# an estimate. Keep the minus 10 minutes in mind when setting the minimum
# value.

# Change this variable to you liking, but less than 40.00 is likely a bad
# idea. YOU'VE BEEN WARNED!

minimum=40.00

If the minutes of charge are less that the minimum.

if (( $(echo "$minutes < $minimum" | bc -l) )); then
    echo "Suspending the computer! Battery charge is needed!" | wall -g $group
    sleep 3
    systemctl suspend
fi

exit 0