feat: add a readme

This commit is contained in:
2025-09-23 23:02:46 -04:00
parent 80dde85a2e
commit 1670d0788f

27
README.md Normal file
View File

@@ -0,0 +1,27 @@
# Event Handler
My custom event handler for battery related things. Here's a brief rundown of
all the features:
When the percentage gets below a specified percentage it will blink the
specified led at any rate defined by the config file.
If the system is plugged in and a wayland session is running then the event
handler will place an idle inhibitor on the session to keep the computer from
going to sleep. The inhibitor is removed when the system is unplugged.
## Default Config
```toml
[battery]
status_path = "/sys/class/power_supply/BAT1"
power_source = "/sys/class/power_supply/ACAD/online"
[led]
brightness_path = "/sys/class/leds/input0::capslock/brightness"
[led.blink]
trigger_level = 15
timing_formula = "1.7 + 18.5 * exp(-0.29 * p)" # p is the percentage of the battery
[acpi_daemon]
socket_path = "/run/acpid.socket"
```