aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJozanLeClerc <bousset.rudy@gmail.com>2019-11-19 09:14:12 +0100
committerJozanLeClerc <bousset.rudy@gmail.com>2019-11-19 09:14:12 +0100
commit8e4448b27712dfcbb3ac5b23fdabd64c6e9842fb (patch)
tree58810d2c4857acb3cb459a05afc243f617061b6d
parentDeleted README (diff)
downloadlowbat-gnu-8e4448b27712dfcbb3ac5b23fdabd64c6e9842fb.tar.gz
lowbat-gnu-8e4448b27712dfcbb3ac5b23fdabd64c6e9842fb.tar.bz2
lowbat-gnu-8e4448b27712dfcbb3ac5b23fdabd64c6e9842fb.tar.xz
lowbat-gnu-8e4448b27712dfcbb3ac5b23fdabd64c6e9842fb.tar.zst
lowbat-gnu-8e4448b27712dfcbb3ac5b23fdabd64c6e9842fb.zip
Now it's README.org
-rw-r--r--README.org57
1 files changed, 57 insertions, 0 deletions
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
+```