summaryrefslogtreecommitdiffstats
path: root/arts/knotify/README
blob: 676dcc25ec04949b3a73ce218ce908ae980d7598 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
About KNotify 

Historic overview. From KDE-1 to KDE-2:
---------------------------------------
KDE-1 ships with a notification system for window manager events - a sound
could be played for example on startup or when a window closes. This was a
very limited notification system.

KNotify in contrast is a very flexible notification system. It can easily be
accessed by any application, and notifications can have several
presentations: Sound is still supported, but you can as well display a
message box, write a text to a log file or log window.

The notification presentation will be user configurable. Some people don't
like message boxes popping up at unexpected times, so they prefer sounds
instead. Deaf people on the otehr hand will not be happy about desktop
sounds.



Usage:
------
1. Compile
2. Start knotify
3. Test it with knotifyclient.

Ideas:
------
It might be useful to modify message presentation from time to time. For
example, while the screen is locked, it is very likely that the user is not
present. Thus, he will not be able to hear a "You have mail" sound (or to
see a talk request). Re-routing this to a log window sounds like a very good
idea.

Notes:
------

KNotify can be accessed directly using one of the available methods.
 - void notify(TQString event, TQString fromApp, TQString text, TQString sound,
               TQString file, int present, int level)
 - void notify(TQString event, TQString fromApp, TQString text, TQString sound,
               TQString file, int present, int level, int winId)
 - void notify(TQString event, TQString fromApp, TQString text, TQString sound,
               TQString file, int present, int level, int winId, int eventId)

For example:
  dcop knotify Notify notify event "Msg from MyApp" "Hello World!" "" "" 16 0