Skip to content

A simple Linux battery notifier that provides desktop notifications and voice alerts when battery is low or fully charged.

License

Notifications You must be signed in to change notification settings

amateur-hacker/battery-notifier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”‹ Battery Notifier

A minimal battery monitoring script for Linux with voice + desktop notifications.

βœ… Features

  • Alerts when battery is <15% (low) or >90% (charged)
  • Voice alerts using mpv
  • Desktop notifications via notify-send
  • Background-safe: avoids duplicate instances

πŸ“¦ Installation

git clone https://github.com/amateur-hacker/battery-notifier.git
cd battery-notifier
chmod +x install.sh
./install.sh

The installer will:

  • Prompt for confirmation
  • Detect your package manager and install: acpi, mpv, libnotify
  • Copy audio files to ~/.local/share/battery-notifier/
  • Install script to ~/.local/bin/battery-notifier

πŸš€ Auto Start on Boot

A .desktop file is already included.

For Desktop Environments

mkdir -p ~/.config/autostart
cp battery-notifier.desktop ~/.config/autostart

For Window Managers

Add this to your WM autostart (e.g., i3, bspwmrc):

setsid -f $HOME/.local/bin/battery-notifier >/dev/null 2>&1 &

About

A simple Linux battery notifier that provides desktop notifications and voice alerts when battery is low or fully charged.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages