NOTIFY(1) Messages notification program NOTIFY(1)
NAME
notify - notify for messages
SYNOPSIS
notify [-h] [-v]
notify [-q] [ -b filename ] [ -n number ] [ -f filename |
-m message | -s number ]
notify [ -a title filename ]
notify [-l]
notify [ -d message ]
alert TIME -f filename | -m message | Message
DESCRIPTION
notify is a small program that displays messages in a win-
dow. You can use it to display messages at logon or by
using at or cron to display alarm or notification mes-
sages. It plays sounds when launched.
OPTIONS
-h Help / usage.
-v Display version number.
-q Quiet. Do not play sounds.
-b filename
Use the specified file as sound file.
-n number
Play the sound file 'number' times.
-f filename
Specify the message file to load for display.
-m message
Specify the message from the list to display. "mes-
sage" can either be the message number or the mes-
sage title.
-s number
Display all the messages in the list. The number is
either 1, 2, 3 or 4. Specifying 1 makes notify
display all the messages in one window. If 2, the
messages are displayed one after another. The
parameter 3 will act as 1 but messages will be ser-
aparated by horizontal lines and will have their
title displayed. At last, the parameter 4 will act
as 2 but messages will have their titles displayed
and serapated by an horizontal line. notify will
quit after the last message.
-a title filename
Add a file in the list with title title.
-l Show the messages list.
-d message
Delete message message. message can either be the
message number or the message title.
NOTES
Without any option notify displays a default message
stored in ~/.notify/message. This can be usefull when used
with the provided script alert that uses at to display
notification or alarm messages. When used with at or
cron, notify MUST have access to the DISPLAY environment
variable in order to be displayed correctly.
The alert script takes the -m or -f arguments or just a
message enclosed in doublequotes. The indicated parameters
have the same meaning as for notify, but the TIME parame-
ter is directly transmitted to the at command in order to
specify the time when the notification happens. It's a
parameter like "HH:MM" or even with the date, but between
doublequotes. The Message parameter is the text to be dis-
played if the other options are not specified. This text
must be enclosed between doublequotes.
FILES
~/.notify/config
~/.notify/message
~/.notify/alarm.wav
~/.notify/notify.wav
~/.notify/msglist
~/.notify/messages/*
CONFIGURATION
There are some options that can be put in the configura-
tion file, even if this file is not necessary.
All line begining with # is processed as a comment, blank
lines are not processed.
Sound files must be by default in the ~/.notify/ direc-
tory, but you can specify an absolute path by having a /
ou a ~ at the begining of the file path (any other charac-
ter will cause the string to be taken as a relative path
to ~/.notify/). Default values are shown between brakets [
].
mp3player = [mpg123]
MP3 player.
wavplayer = [play]
Wav player.
alarmsound = [alarm.wav]
Alarm sound file.
notifysound = [notify.wav]
Notification sound file
messageslist = [msglist]
Messages list file
nbsoundplay = [3]
Number of times to play the sound file.
VERSION
notify version 0.5
LICENCE
This program is released under the GPL. If you do anything
interesting, please let me know, I would like to have a
look.
AUTHOR
Thomas Nemeth
http://tnemeth.free.fr/projets/notify.html
SEE ALSO
at(1), cron(8), crontab(1), crontab(5)
