herbe/README.md
2020-08-04 06:19:12 +02:00

46 lines
1.5 KiB
Markdown

# 🌱 herbe
> Daemon-less notifications without D-Bus. Minimal and lightweight.
## Usage
```shell
herbe "This is a notification"
```
will display a notification for the duration set in `config.h` that says `This is a notification`
## TODO
herbe is still a WIP.
* Title support
* Refactor code, it is not very readable
Not really sure about these, are they minimal, will someone use them?
* Line breaks formatting
* Icon/image support
* Command-line options (change settings)
## 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).