sxalert - simple X alert

sxalert is a small, daemonless X11 notification utility written in C. It displays customizable text notifications and is designed to integrate naturally with Unix shell scripts.

[download] [source] [usage] [patches] [release article]

Features

Small C99 codebase using Xlib and Xft
No notification daemon required
Runtime text, background and border customization
Multiline text and standard input support
Support for multiple monitors
Distinct exit statuses for mouse buttons and timeout
Automatic serialization of concurrent notifications
Simple configuration through config.h

Download

Latest release: 1.0

Build and install:

tar xf sxalert-1.0.tar.gz
cd sxalert-1.0
make
sudo make install

Requires X11, Xft, XRandR and their development headers.

Usage

Print a low-battery warning:

[ "$(cat /sys/class/power_supply/BAT0/capacity)" -lt 15 ] && sxalert "Battery below 15%"

Tell you if your build failed or not:

make && sxalert -t 55ff55 "Build successful" || sxalert -t ff5555 "Build failed"

Email notification that can launch neomutt in st:

sxalert -d 10000 "You have new mail" "Left click to read"; [ $? -eq 0 ] && st -e neomutt

and so much more:

cowsay you suck | sxalert -s

For more information, consult the manpage.

Patches

Xresources support: diff, README

Notifications!

Development

sxalert is free software, distributed under the GNU General Public License, version 3 or later.

Patches, bug reports and suggestions are welcome by email at hackers@mcdim.xyz.