Archived

This repository has been archived on 2025-03-19. You can view files and clone it, but cannot push or open issues or pull requests.

Felix Ortmann 24aa158ac2 Format readme

2020-12-26 17:07:55 +01:00

1.2 KiB

Raw Blame History

batalert

Send D-Bus notifications when the (Linux) host's battery runs low.

Prerequisites

Install libnotify
Install a Notification Server to render desktop notifications
- Use mako on Wayland/Sway setups

Usage

You can run batalert with default setting to send the first notification when the battery falls below 15% and repeat the notification every 3%. batalert resets when you plug-in your charger.

Customization

Check the help text:
```
batalert -h
```
Show a notification when the battery falls below 20%, repeat notification every 4% on 16%, 12%, 8% ... :
```
batalert --threshold 20 --notification-step 4
```

Use a custom icon:

batalert --icon /usr/share/icons/<your-icon>.png

Monitor a certain battery, e.g., BAT2:

batalert --uevent /sys/class/power_supply/BAT2/uevent

Building

Build the app via Cargo:

cargo build --release

1.2 KiB Raw Blame History