DEBIAN: Debianization
[glsdk/gst-plugins-ugly0-10.git] / debian / README.Debian
1 Gstreamer for Debian
2 ====================
3 This package contains the GStreamer plugin distribution.
5 More information can be found at http://gstreamer.net/
7 As of GStreamer plugins version 0.8.0 all packages are versioned and
8 parallel installable with other releases with other major.minor
9 versions.  For example, 0.8.x series is versioned as 0.8 and parallel
10 installable with both unversioned 0.6.x series and future 0.9.x and
11 beyond.  The version part is represented as VER below.
13 GStreamer plugins are split into a number of packages:
15 plugins without external dependencies:
17    gstreamerVER-plugins-ugly     many independent plugins
19 documentation:
21    gstreamerVER-plugins-ugly-doc                html documentation
24 Notes
25 =====
27 ChangeLog
28 ---------
30 The upstream ChangeLog is not included in all the plugin packages due to its
31 large size.  Please see upstream sources if you are interested in detailed
32 source changes.
34 Unofficial plugin packages
35 --------------------------
37 Various plugins in the upstream source are not yet packaged or not officially
38 supported.  This is most likely due to:
40   * upstream considers them too unstable
41   * libraries they depend on are not are yet in Debian or are poorly supported
43 To build additional unofficial plugin packages:
45   * Get the source and Debian diff (for example, "apt-get source gst-plugins")
46   * Add new package name to the EXTRA_PLUGINS variable in debian/rules
47   * Add appropriate dependency and control info to debian/extra
48   * Add a .install file for the package
49   * Rebuild
51 External tools support
52 ----------------------
54 Your favorite codec isn't wrapped as a plugin?  External programs can be
55 used to process streams.  Take a look at "pipefilter" element or try
56 something like this (untested):
58   $ mkfifo fifo
59   $ gst-launch myaudiosrc ! filesink location=fifo &
60   $ cat fifo | my_encoder > output_file
63 David I. Lehn <dlehn@debian.org>  Tue, 23 Mar 2004 04:38:37 -0500
65 update:
66 Sebastien Bacher <seb128@debian.org>  Wed, 14 Dec 2005 17:00:21 +0100