KNotify Client

Korshak asked how to do emerge -uND --world && knotify "Done!". I thougt it would be a piece of cake, but apparently not.
The short answer, zypper in libnotify; notify-send Done, has a disadvantage of requiring a fair amount of GNOME software. But it does use a proposed freedesktop.org standard.
Then I find the method org.kde.KNotify.event, but its nice signature (ssavsayasx) means dbus-send (dbus-1-1.2.1-12) cannot invoke it (it cannot pass empty arrays, and it cannot wrap variants in arrays). No problem, let's use Python. But then we are blocked by knotify4 (kdebase4-runtime-4.0.4-19) reporting a wrong signature via the introspection interface.

# killall knotify4; cp /usr/bin/knotify4{,.bak}
# sed 's/type="a(ss)"/ type = "av"/g' /usr/bin/knotify4.bak > /usr/bin/knotify4

Now which event should we use so that the user actually sees the message? There are many of them, with user configurable actions. warning/kde seems to work out of the box.

#! /usr/bin/python
import sys
import dbus
m = sys.argv[1]
kn = dbus.SessionBus().get_object("org.kde.knotify", "/Notify")
i = kn.event("warning", "kde", [], m, [0,0,0,0], [], 0,
    dbus_interface="org.kde.KNotify")


That did it. But I still hope that there is a simple solution for KDE4 that I have missed.

D-Bus Sightseeing

I figured it was time to learn more about D-Bus. Today, let me share some useful calls that I found so far. Hopefully they will inspire you to experimenting too and together we will have a chance of learning more.

$ dbus-send --print-reply \
    --dest=org.kde.klipper \
    /klipper \
    org.kde.klipper.klipper.getClipboardContents
method return sender=:1.37 -> dest=:1.73 reply_serial=2
string "Hello D-Bus"

Your result will be probably different. In fact, I spent several minutes wondering why the method does not return anything and just repeats its name ;-)
The meaning of the parameters: --dest is the destination connection; apparently D-Bus cannot find it out from the following parameter: /klipper: the destination object. org.kde.klipper.klipper is the interface. Most objects have their own interface plus the introspection interface org.freedesktop.DBus.Introspectable. getClipboardContents is of course the method name.

For further exploration, the GUI tool qdbusviewer is very useful. Try it for calling getClipboardContents now.

$ dbus-send --type=method_call --dest=org.kde.kwin \
 /KWin org.kde.KWin.nextDesktop
$ dbus-send --type=method_call --dest=org.kde.kwin \
 /KWin org.kde.KWin.previousDesktop
$ dbus-send --type=method_call --dest=org.kde.plasma \
 /App org.kde.plasma.App.toggleDashboard

The type option is necessary because dbus-call defaults to type=signal which would not work. (BTW does anyone have a nice example for demonstrating a signal?) With print-reply in the first example, type=method_call is implied.

Let's pass some arguments:

$ dbus-send --type=method_call --dest=org.kde.klipper \
 /klipper org.kde.klipper.klipper.setClipboardContents \
 string:'Test Beta2!'
$ dbus-send --type=method_call --dest=org.kde.krunner \
 /Interface org.kde.krunner.Interface.display \
 string:'system'

So far we have been using the session bus. The system-wide bus offers even more fun:

$ dbus-send --system --print-reply \
 --dest=org.freedesktop.NetworkManagerSystemSettings \
 /org/freedesktop/NetworkManagerSettings \
 org.freedesktop.NetworkManagerSettings.ListConnections

array [
   object path "/org/freedesktop/NetworkManagerSettings/0"
   object path "/org/freedesktop/NetworkManagerSettings/1"
   object path "/org/freedesktop/NetworkManagerSettings/2"
]

$ dbus-send --system --print-reply \
 --dest=org.freedesktop.NetworkManagerSystemSettings \
 /org/freedesktop/NetworkManagerSettings/1 \
 org.freedesktop.NetworkManagerSettings.Connection.GetSettings

 array [
    dict entry(
       string "802-11-wireless"
       array [
          dict entry(
             string "ssid"
             variant                   array [
                   byte 102
                   byte 114
                   byte 111
                   byte 103
                   byte 115
                ]
          )
          dict entry(
             string "security"
             variant                   string "802-11-wireless-security"
          )
       ]
    )
 /* more data. BTW you can't see any of this in qdbusviewer. */
 ]

(Interesting, every even call to NMS fails with a timeout)

Finally, a long list to scroll up while the music plays:

$ dbus-send --system --print-reply \
 --dest=org.freedesktop.Hal \
 /org/freedesktop/Hal/Manager \
 org.freedesktop.Hal.Manager.GetAllDevices