From 8e4448b27712dfcbb3ac5b23fdabd64c6e9842fb Mon Sep 17 00:00:00 2001 From: JozanLeClerc Date: Tue, 19 Nov 2019 09:14:12 +0100 Subject: Now it's README.org --- README.org | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 README.org diff --git a/README.org b/README.org new file mode 100644 index 0000000..a1c517c --- /dev/null +++ b/README.org @@ -0,0 +1,57 @@ +# lowbat + +Very small script that runs in the background and warns you when your battery is low until you plug your laptop in. +It also is POSIX-compliant, which is nice. + +## Dependencies + ++ `make` ++ `libnotify` ++ `espeak` + +## Installation + +Open a terminal and run these commands: + +```shell +git clone https://github.com/JozanLeClerc/lowbat.git +cd lowbat +sudo make install +``` + +Next you must find a way to get the script running right after loging in. Add this to your startup programs manager/rc file of choice: + +```shell +lowbat > /dev/null 2>&1 & +``` + +## Options + +Two options are available: + ++ `--say [MESSAGE]` allows you to set your own warning message lowbat is active. ++ `--silent` disables audio warnings. + +#### Examples of use: + +```shell +lowbat --say "your custom message" > /dev/null 2>&1 +``` + +```shell +lowbat --silent > /dev/null 2>&1 +``` + +## Uninstallation + +```shell +sudo make uninstall +``` + +## See also + +For more informations, see: + +```shell +man 1 lowbat +``` -- cgit v1.2.3