bc2ce9b by Aurelien Gateau at 2009-12-15 1
# What is it?
2
3
Colibri provides an alternative to KDE4 Plasma notifications.
4
5
Colibri notifications look lighter and are completely passive: they do not
6
provide any buttons. You may or may not like this.
7
8
Since they are completely passive, they smoothly fade away when you mouse over
9
them, allowing you to interact with any window behind them.
10
ffd4159 by Aurelien Gateau at 2009-12-15 11
They also do not stack each others: if multiple notifications happen, they will
12
be shown one at a time.
13
14
Colibri is licensed under the GNU GPLv2 or later.
bc2ce9b by Aurelien Gateau at 2009-12-15 15
16
# Building it
17
ffd4159 by Aurelien Gateau at 2009-12-15 18
You need kdelibs >= 4.4.
19
bc2ce9b by Aurelien Gateau at 2009-12-15 20
Build it with:
21
22
    mkdir build
23
    cd build
24
    cmake -DCMAKE_INSTALL_PREFIX=/usr <path/to/colibri/sources>
25
    make
26
    sudo make install
27
28
You may need to replace /usr with the path to your KDE installation.
29
30
# Enabling Colibri notifications
31
5092de1 by Aurelien Gateau at 2010-06-27 32
Enabling Colibri notifications can be a bit tricky.
bc2ce9b by Aurelien Gateau at 2009-12-15 33
5092de1 by Aurelien Gateau at 2010-06-27 34
First you need to open Colibri module in "System Settings":
35
- Start "System Settings"
36
- Open the "System and Application Notifications" category
37
- Select "Colibri Notifications"
bc2ce9b by Aurelien Gateau at 2009-12-15 38
5092de1 by Aurelien Gateau at 2010-06-27 39
## Another notification system is running
bc2ce9b by Aurelien Gateau at 2009-12-15 40
5092de1 by Aurelien Gateau at 2010-06-27 41
If there is an error bar telling you to stop an existing notification system,
42
here is how to do it, depending on the current notification system.
bc2ce9b by Aurelien Gateau at 2009-12-15 43
5092de1 by Aurelien Gateau at 2010-06-27 44
If the system is "notify-osd" or "notification-daemon", just stop them with
45
"killall notify-osd" or "killall notification-daemon".
bc2ce9b by Aurelien Gateau at 2009-12-15 46
5092de1 by Aurelien Gateau at 2010-06-27 47
If the system is "Plasma", you must disable notification handling in Plasma.
bc2ce9b by Aurelien Gateau at 2009-12-15 48
5092de1 by Aurelien Gateau at 2010-06-27 49
To do so on KDE 4.4:
50
- Right-click on the systemtray applet
51
- Select "System Tray Settings"
52
- Uncheck the "Application notifications" box
d0d6658 by Aurelien Gateau at 2010-02-16 53
5092de1 by Aurelien Gateau at 2010-06-27 54
To do so on KDE 4.5:
55
- Right-click on the (i) icon in the systemtray applet
56
- Select "Notification Settings"
57
- Unckeck the "Application notifications" box
d0d6658 by Aurelien Gateau at 2010-02-16 58
5092de1 by Aurelien Gateau at 2010-06-27 59
## No notification system is running
bc2ce9b by Aurelien Gateau at 2009-12-15 60
5092de1 by Aurelien Gateau at 2010-06-27 61
Just click the "Start Colibri" button.
bc2ce9b by Aurelien Gateau at 2009-12-15 62
5092de1 by Aurelien Gateau at 2010-06-27 63
## Testing it
bc2ce9b by Aurelien Gateau at 2009-12-15 64
5092de1 by Aurelien Gateau at 2010-06-27 65
Click the "Preview" button, you should see a notification appear in the
66
selected corner.
bc2ce9b by Aurelien Gateau at 2009-12-15 67
ffd4159 by Aurelien Gateau at 2009-12-15 68
# A bit of history
bc2ce9b by Aurelien Gateau at 2009-12-15 69
ffd4159 by Aurelien Gateau at 2009-12-15 70
Passive notifications for Plasma first appeared as "Ayatana notifications", an
71
alternative notification system I implemented in Kubuntu Karmic as part of my
72
work for Canonical.
bc2ce9b by Aurelien Gateau at 2009-12-15 73
74
Ayatana notifications were implemented as a patch against the systemtray
ffd4159 by Aurelien Gateau at 2009-12-15 75
applet. Colibri is based on this work, but does not require patching any
76
applet.
bc2ce9b by Aurelien Gateau at 2009-12-15 77
78
Colibri contains code I wrote for Canonical, but it is not a Canonical product.
79
6cef1dd by Aurelien Gateau at 2010-03-07 80
# Contact
81
Email: Aurélien Gâteau <agateau@kde.org>
82
To report bugs: http://bugs.kde.org