merge from release branch
[platform/upstream/gst-plugins-good.git] / README
1 gst-plugins : plug-ins for GStreamer
2
3 * to develop against uninstalled GStreamer core :
4   add path to gstreamer-uninstalled.pc to PKG_CONFIG_PATH
5   or run configure --with-pkg-config-path=(path to gstreamer uninstalled)
6
7 * to register plug-ins in source tree
8   run gst-register --gst-plugin-path=.
9
10 * if a certain plug-in doesn't build, then redo configure with
11   --disable-(plug-in)
12   to disable it from the build
13
14 * Additional documentation :
15
16 GStreamer is developed under the terms of the LGPL (see LICENSE file for 
17 details). Some of our plug-ins however rely on libraries which are available 
18 under other licenses. This means that if you are using an application which 
19 has a non-GPL compatible license (for instance a closed-source application) 
20 with GStreamer, you have to make sure not to use GPL-linked plug-ins.
21 When using GPL-linked plug-ins, GStreamer is for all practical reasons 
22 under the GPL itself. 
23
24 The plug-ins which use a GPL library are as follows:
25 cdparanoia      libcdparanoia   (http://www.xiph.org/paranoia/)
26 aasink          aalib           (http://aa-project.sourceforge.net/aalib/)
27 xmms            libxmms         (http://www.xmms.org)
28 decdvd          ac3dec,mpeg2dec (http://linuxvideo.org/mpeg2dec/,http://linuxvideo.org/ac3dec/)a
29
30 Plug-ins which use an LGPL library are as follows:
31 colorspace      Hermes          (http://www.clanlib.org/hermes/)
32 httpsrc         libghttp        (ftp.gnome.org/pub/GNOME/stable/sources/libghttp/)
33 alsasink        alsa            (http://alsa-project.org)
34 arts            aRts            (http://arts-project.org)
35 sdlsink         libsdl          (http://www.libsdl.org)
36 gnomevfssource  gnome-vfs       (ftp.gnome.org//pub/GNOME/stable/sources/gnome-vfs)
37 gnomevfssink    gnome-vfs
38 esdsink         libesd          (ftp.gnome.org/pub/GNOME/stable/sources/esound)
39 icastsend       libshout        (http://www.icecast.org)
40 lame            libmp3lame      (http://www.mp3dev.org/mp3/)
41 gst1394         libraw1394      (http://linux1394.sourceforge.net)
42 flac            libFLAC         (http://flac.sourceforge.net)
43 RTP             ortp            (http://www.linphone.org/ortp/)
44
45 Plug-ins which use a BSD covered library are as follows:
46 vorbisenc       libogg/libvorbis        (http://www.xiph.org/ogg/vorbis)
47 vorbisdec       libogg/libvorbis
48
49 Plug-ins based on libraries with other free licenses:
50 xvideosink      libXv           (MIT X11 / X Consortium license)
51 gsm             libgsm          (MIT license http://kbs.cs.tu-berlin.de/~jutta/toast.html)
52
53 Plug-ins using non-free libraries:
54 wincodec        win32ddl        (http://divx.euro.ru/)
55