Debian Codegraph @

contrib/gstreamer-plugin/README

raw
1 README:
2
3 PackageKit installs missing GStreamer plugins as it requested: this is how
4 the whole system is designed to work.
5
6 Introduction:
7
8 1. Package installs pk-gstreamer-install into /usr/libexec
9 2. _If_ the distro wants PackageKit to handle the codec install, and
10 not an application like codeina then you need to symlink
11 pk-gstreamer-install to gst-install-plugins-helper
12 4. Distribution patches /etc/PackageKit/Vendor.conf with URLs to wiki pages.
13 3. Done. It's really that simple.
14
15 Detecting the calling application:
16
17 When an application calls the D-Bus interface to install plugins or codecs
18 then the XID and timestamp along with the codec string is passed on the
19 interface.
20
21 The caller (the exe from ConsoleKit) is then sent to SearchFile and the result
22 used in the GUI. This ensures that all applications can use the interface,
23 but they cannot pretend to be other applications by changing application
24 window properties.
25
26 This of course, causes a problem as all installs will be resolved to the
27 PackageKit-gstreamer-plugin as this owns the /usr/libexec/pk-gstreamer-install
28 file.
29
30 This file, /usr/libexec/pk-gstreamer-install is treated specially (as it is
31 compiled, and cannot be modified without root access). In this special case
32 we use the XID of the calling window (provided by GStreamer) and lookup the
33 program name and icon from the window properties.
34
35 Notes:
36
37 * You will need to restart any applications using GStreamer before they will
38 request plugings using PackageKit.
39 * Although PackageKit 0.3.4 supports codec installing, 0.3.6 is the first
40 release that returns the correct return values to GStreamer.
41 * Totem versions less than 2.24.1 have a bug where it sends the wrong XID,
42 you need to upgrade for focus stealing prevention to work and for the title
43 and icon to be set correctly.
44