Xnotify is a notification utility for Xorg, fine-tuned for tiling window managers, such as dwm. It is similar to tools like xmessage and libnotify. However, I tried to make it as simple and minimal possible - with no daemons, no sockets, no dbus.
Here are two examples, in English and Armenian:
Xnotify is inspired by the suckless philosophy and it tries to do only one thing: show a notification message. At the same time, I tried to make it fully customizeable. Here are the main highlights:
- Size of the pop-up window, its position, colors and fonts are customizeable in
config.h - Any Xft-compatible font is OK, you can run
fc-listto see what's available on your system - Optionally, Xnotify can log all notifications to a file, see details below
Building xnotify requires:
pkg-config(pkgconfon Manjaro)libX11(libx11)libXft(libxft)freetype2(freetype-2)
Additionally, fontconfig, allows you to navigate and select Xft-compatible fonts (e.g. fc-list).
- Run
make config.hto create a copy of the default config file - Edit
config.hand customize if you wish - Run
maketo build the program
(I hate sudo make install, therefore I did not add that rule.)
Each notification consists of subject and message, the former is optional. An example invocation with subject:
$ xnotify alert "battery level low"Example with no subject:
$ xnotify "battery level low"Xnotify will fork and close stdout and stderr, if you wan't to prevent that, use the -d flag. Example:
$ xnotify -d alert "battery level low"Xnotify will log all notifications to a log file, if LOGFN and LOGMAXS are defined in config.h. This is disabled by default. Each line is one notification in the following format:
DATETIME[PPID:PNAME] (SUBJECT)MESSAGE
where PPID and PNAME are PID and name of the process that invoked Xnotify. If Xnotify can't figure out PNAME, its value will be -. Similarly, subject will be - if notification had no subject.
Xnotify can be muted and unmuted with the flags -m and -u respectively. When muted, xnotify will not display notification, but will log them if enabled.
You can query if it's muted with xnotify -s.
-
Xft will not complain, if an invalid font name is used, instead it will load something else that's unavailable on your system. If the text is not properly drawn or you see squares instead of letters, make sure font names in
config.hare correct or try some other font. -
If message size exceeds window size, it is trimmed. Same needs to be done with subject. -
With multiple notifications, sometimes they overlap (know why this happens, just need to fix it).
If you used this utiltiy, I would appreciate any feedback, and you are more than welcome to open an issue or merge request.