| 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 |