78 lines
2.7 KiB
Markdown
78 lines
2.7 KiB
Markdown
[](https://github.com/dunst-project/dunst/actions?query=workflow%3Amain) [](https://codecov.io/gh/dunst-project/dunst)
|
|
|
|
## Dunst
|
|
|
|
* [Wiki][wiki]
|
|
* [Description](#description)
|
|
* [Compiling](#compiling)
|
|
* [Copyright](#copyright)
|
|
|
|
## Description
|
|
|
|
Dunst is a highly configurable and lightweight notification daemon.
|
|
|
|
|
|
## Installation
|
|
|
|
### Dependencies
|
|
|
|
Dunst has a number of build dependencies that must be present before attempting configuration. The names are different depending on [distribution](https://github.com/dunst-project/dunst/wiki/Dependencies):
|
|
|
|
- dbus
|
|
- libxinerama
|
|
- libxrandr
|
|
- libxss
|
|
- glib
|
|
- pango/cairo
|
|
- libgtk-3-dev
|
|
- libnotify (for dunstify only)
|
|
- wayland-client (can build without, see [make parameters](#make-parameters))
|
|
- wayland-protocols (optional, for recompiling protocols)
|
|
|
|
### Building
|
|
|
|
```
|
|
git clone https://github.com/dunst-project/dunst.git
|
|
cd dunst
|
|
make
|
|
sudo make install
|
|
```
|
|
|
|
### Make parameters
|
|
|
|
- `DESTDIR=<PATH>`: Set the destination directory of the installation. (Default: `/`)
|
|
- `PREFIX=<PATH>`: Set the prefix of the installation. (Default: `/usr/local`)
|
|
- `BINDIR=<PATH>`: Set the `dunst` executable's path (Default: `${PREFIX}/bin`)
|
|
- `DATADIR=<PATH>`: Set the path for shared files. (Default: `${PREFIX}/share`)
|
|
- `MANDIR=<PATH>`: Set the prefix of the manpage. (Default: `${DATADIR}/man`)
|
|
- `SYSTEMD=(0|1)`: Disable/Enable the systemd unit. (Default: detected via `pkg-config`)
|
|
- `WAYLAND=(0|1)`: Disable/Enable wayland support. (Default: 1 (enabled))
|
|
- `SERVICEDIR_SYSTEMD=<PATH>`: The path to put the systemd user service file. Unused, if `SYSTEMD=0`. (Default: detected via `pkg-config`)
|
|
- `SERVICEDIR_DBUS=<PATH>`: The path to put the dbus service file. (Default: detected via `pkg-config`)
|
|
|
|
**Make sure to run all make calls with the same parameter set. So when building with `make PREFIX=/usr`, you have to install it with `make PREFIX=/usr install`, too.**
|
|
|
|
Checkout the [wiki][wiki] for more information.
|
|
|
|
## Bug reports
|
|
|
|
Please use the [issue tracker][issue-tracker] provided by GitHub to send us bug reports or feature requests. You can also join us on the IRC channel `#dunst` on Freenode.
|
|
|
|
## Maintainers
|
|
|
|
- [Nikos Tsipinakis](https://github.com/tsipinakis) <nikos@tsipinakis.com>
|
|
- [Benedikt Heine](https://github.com/bebehei) <bebe@bebehei.de>
|
|
|
|
## Author
|
|
|
|
written by Sascha Kruse <dunst@knopwob.de>
|
|
|
|
## Copyright
|
|
|
|
copyright 2013 Sascha Kruse and contributors (see [`LICENSE`](./LICENSE) for licensing information)
|
|
|
|
If you feel that copyrights are violated, please send me an email.
|
|
|
|
[issue-tracker]: https://github.com/dunst-project/dunst/issues
|
|
[wiki]: https://github.com/dunst-project/dunst/wiki
|