Install the acpi package. Now put this in return0whencharging.sh and make it executable:
#!/bin/sh
acpi -V
if cat /proc/acpi/battery/BAT1/state | grep "charging state" | grep -vE ":[\t ]*charging$"; then
exit 1
else
exit 0
fi
If echo -e "\a" makes a sound, start this when you want to watch the battery status:
watch --beep return0whencharging.sh
If it doesn't make any sound or you want a notification and a better alarm than whatever watch can provide, install libnotify-bin and mplayer and use this instead:
watch --errexit return0whencharging.sh; notify-send "Finished charging" && mplayer -msglevel all=0 -loop 0 /usr/share/sounds/freedesktop/stereo/alarm-clock-elapsed.oga
Explanation:
If you look at the man page for grep you can see that -v reverses the matching, and therefore the return/status code. -E means it's a regular expression. the [\t ] in the regex (regular expression) means "tab or space". The following star makes it mean "tab or space 0 or more times". The trailing "$" means that it should match the end of the line. The final grep means that lines NOT ending in a ":", any number of tabs or spaces and then "charging" and the end of the line should make grep exit with status code 0. This means that grep will return 1 as long as the computer is charging. The if will execute it's first branch when the status code is 0, which means we are effectively negating the result of grep, since we exit 1 when grep exits 0 and exit 0 when grep exists non-zero.