4 wall-notify is a simple program which receives all messages written by wall
5 and passes them to a notification program via stdin. It's designed for
6 simplistic desktop environments (like tiling window managers) or GNU
7 Screen/Tmux sessions to notify the user about important messages like reboots.
8 It was inspired by KDE's knotify.
10 wall messages are either directly created by root with the `wall` command or
11 sent by other programs like `reboot`, `shutdown` or other processes like NFS
12 to warn users when the NFS server terminates.
14 wall-notify is licensed under GPL 3 (or later).
21 - libutempter or utmpx.h (utmpx.x requires a setgid utmp binary)
27 ./configure && make && make check
33 To dump all wall messages to stdout use:
37 All arguments passed to `wall-notify` are used when execing the process, e.g.
38 to replace all spaces with underlines use:
40 ./src/wall-notify sed 's/ /_/g'
42 To display the messages with `xmessage` use:
44 ./src/wall-notify xmessage -file -
46 However this will display '^M' (carriage-return) and other control characters
47 in the message. For a simple wrapper script which removes those, see
48 `contrib/message-helper`:
50 ./src/wall-notify contrib/message.sh xmessage -file -
52 The shell is not used when running the program.
58 Doesn't work on OpenBSD which has no support for utmpx.h.
60 If you find any bugs not mentioned in this document please report them to
61 <simon@ruderich.org> with wall-notify in the subject.
67 Written by Simon Ruderich <simon@ruderich.org>.
73 wall-notify is licensed under GPL version 3 or later.
75 Copyright (C) 2014 Simon Ruderich
77 This program is free software: you can redistribute it and/or modify
78 it under the terms of the GNU General Public License as published by
79 the Free Software Foundation, either version 3 of the License, or
80 (at your option) any later version.
82 This program is distributed in the hope that it will be useful,
83 but WITHOUT ANY WARRANTY; without even the implied warranty of
84 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
85 GNU General Public License for more details.
87 You should have received a copy of the GNU General Public License
88 along with this program. If not, see <http://www.gnu.org/licenses/>.