blob: cc73f18c183a819d65634382343f7e767e5575a6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
.TH LOWBAT 1 lowbat\-1.2
.SH NAME
lowbat - A minimal battery level monitor daemon, written in C
.SH DESCRIPTION
lowbat is configured by default to check the system battery level every 3
seconds. It is able to detect each of the system's batteries, and calculate the
remaining sum capacity of all installed batteries. Additional batteries
installed during runtime will also be detected and summed.
.P
The daemon will send a warning notification the user when the sum battery level
drops below 20% while any battery is discharging, and another critical
warning at 5%.
.SH BATTERY STATUS LOG
The current charging status and sum capacity will be logged in stdout whenever
a change is detected.
.P
Each possible battery status value is assigned a single character symbol which
will prefix the current battery level. E.g. `-50%` if any attached battery is
currently discharging and the current sum capacity equals 50%. The symbols are
defined as follows in order of highest to lowest priority:
.TP
.B -
Discharging
.TP
.B +
Charging
.TP
.B =
Full / Not charging
.TP
.B ?
Unknown
.SH USAGE
Call the lowbat executable in your
.B
xinitrc
or
.B
xprofile.
.SH CUSTOMIZATION
There are no runtime flags or configuration files. Simply modify the source
code to suit your needs.
.SH COPYRIGHT
Copyright 2024 Tim Keller <tjk@tjkeller.xyz>.
.P
MIT License.
.P
.P
<https://TJKeller.xyz>
.SH SEE ALSO
.BR notify-send(1)
.P
.BR <https://www.kernel.org/doc/Documentation/ABI/testing/sysfs-class-power>
|
