Update README.md
authorSamuel Dudík <redacted>
Thu, 30 Jul 2020 16:51:34 +0000 (18:51 +0200)
committerGitHub <redacted>
Thu, 30 Jul 2020 16:51:34 +0000 (18:51 +0200)
README.md

index b94a9e64aca1a6188333360987c091bb40efdbcf..818cc449dfb3f113d0ec253a85fc522fe4caadbe 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,2 +1,36 @@
-# herbe
-> Daemon-less notifications wihout D-Bus
+# 🌱 herbe
+**Daemon-less notifications without D-Bus**
+
+## Usage
+```shell
+herbe "This is a notification"
+```
+will display a notification for the duration set in `config.h` that says `This is a notification`
+
+## Installation
+### Dependencies
+* X11 (Xlib)
+* Xft
+* freetype2
+
+The names of packages are different depending on which distribution you use.
+For example, if you use [Void Linux](https://voidlinux.org/) you will have to install these dependencies:
+```shell
+sudo xbps-install base-devel libX11-devel libXft-devel
+```
+
+### Build
+```shell
+git clone https://github.com/dudik/herbe
+cd herbe
+sudo make install
+```
+`make install` requires root privileges because it copies the resulting binary to `/usr/local/bin`. This makes `herbe` accessible globally.
+
+You can also use `make clean` to remove the binary from the build folder, `sudo make uninstall` to remove the binary from `/usr/local/bin` or just `make` to build the binary locally.
+
+## Configuration
+herbe is configured at compile-time by editing `config.h`. Every option should be self-explanatory. There is no `height` option because height is determined by font size and text padding.
+
+## Contribute
+If you want to report a bug or you have a feature request, feel free to [open an issue](https://github.com/dudik/herbe/issues).