This is the installation documentation for the Fluendo Codec pack.

Included in this package you will find a directory called
'codecs' containing codecs in 2 different subdirectories as .so files.
Each subdirectory corresponds to a different version of GStreamer. Indeed 
starting from Fedora 18 (beginning of 2013), some distributions are now shipping
both GStreamer 0.10 and GStreamer 1.0. During that transition you will have to
install Fluendo codecs for both versions.

Those files are plug-ins for the GStreamer framework and will provide the codec
features to any application using the GStreamer framework.

They can be installed in 2 different scenarios :

1) For one user only :
======================

For GStreamer 0.10 :

Please copy all the files contained in the codecs/gstreamer-0.10 directory in
the following directory ~/.gstreamer-0.10/plugins/

As a commodity you can run the following command line from a terminal :

user@host$ mkdir -p ~/.gstreamer-0.10/plugins; cp ./codecs/gstreamer-0.10/* ~/.gstreamer-0.10/plugins/

Once this is done a simple :

user@host$ ls ~/.gstreamer-0.10/plugins/

Should show a list of files named libgstflu*.so.

For GStreamer 1.0 :

User plugins are now located in a different directory. Please copy all the files
contained in the codecs/gstreamer-1.0 directory in

~/.local/share/gstreamer-1.0/plugins/

or in $XDG_DATA_HOME/gstreamer-1.0/plugins/ if the XDG_DATA_HOME environment
variable is set.

2) For the whole system (all users) :
=====================================

To do this you need to have root access on the machine. This can be achieved 
either by running commands with sudo or getting a root shell with the su 
command.

Once you are root you can copy all the files contained in the
codecs/gstreamer-0.10/ directory in the following directory:

/usr/lib/gstreamer-0.10/

and then all the files contained in the codecs/gstreamer-1.0/ directory in the
following directory:

/usr/lib/gstreamer-1.0/

If that directory does not exist that can mean that GStreamer 0.10 / 1.0 is not 
installed or is installed in a different location. If it is installed in a
different location you can figure out where that is with the following command :

root@host# gst-inspect-0.10 oggdemux | grep Filename

which should return something like :

Filename:             /usr/lib/gstreamer-0.10/libgstogg.so

Meaning that plugins are installed in /usr/lib/gstreamer-0.10/

The same applies to GStreamer 1.0 with gst-inspect-1.0 oggdemux |grep File

To copy all the codecs in the GStreamer plugins directory run the following
command (assuming your current working directory is inside the unpacked codec 
archive where this documentation is):

root@host# cp ./codecs/gstreamer-0.10/* /usr/lib/gstreamer-0.10/
root@host# cp ./codecs/gstreamer-1.0/* /usr/lib/gstreamer-1.0/

Checking your codec installation :
==================================

In order to test codecs you can run the following command in a terminal :

For GStreamer 0.10:

user@host$ gst-inspect-0.10 | grep flu

which should show the following result (The following list can vary depending
on what codec pack you bought):

fluh264dec:  fluh264dec: Fluendo H264 Decoder
fluaacdec:  fluaacdec: Fluendo AAC Decoder (HE enabled, stereo downmix)
flump3dec:  flump3dec: Fluendo MP3 Decoder (IPP build)
fluilbc:  fluilbcdec: Fluendo iLBC Encoder
fluilbc:  fluilbcenc: Fluendo iLBC Encoder
fluwmvdec:  fluwmvdec: Fluendo WMV Decoder
fluac3dec:  fluac3dec: Fluendo AC3 Decoder (IPP build with Player protection)
flumpeg2vdec:  flumpeg2vdec: Fluendo MPEG-2 Video Decoder
fluadpcm:  fluadpcmimaqtdec: Fluendo ADPCM IMA QT Decoder
fluadpcm:  fluadpcmimadvidec: Fluendo ADPCM IMA DVI Decoder
fluadpcm:  fluadpcmmsdec: Fluendo Microsoft ADPCM Decoder
flumsb: video/x-ms-nsc: nsc
flumsb:  flumsbparser: Fluendo MSB Parser
flumsb:  flunscparser: Fluendo NSC Parser
flumsb:  flumsbbin: Fluendo MSB Bin
flurtp:  flurtpasfdepay: RTP packet parser
flurtp:  flurtspwms: Fluendo WMS RTSP Extension
fluwma:  fluwmadec: Fluendo WMA Decoder (STD + PRO + LSL + WMS)
fluwma:  fluwmsdec: Fluendo WMS Decoder
fluasf:  fluasfdemux: Fluendo ASF Demuxer
fluasf:  fluasfcmdparse: Fluendo ASF Command Parser
flumms:  flummssrc: Fluendo MMS source
flumpeg4vdec:  flumpeg4vdec: Fluendo MPEG-4 ASP Video Decoder
fludivx3dec:  fludivx3dec: Fluendo DivX 3.11 Video Decoder
flumpegdemux:  flupsdemux: The Fluendo MPEG Program Stream Demuxer
flumpegdemux:  flutsdemux: MPEG Transport stream demuxer
flulpcm:  flulpcmdec: Fluendo LPCM decoder
fluva:  fluvadec: Fluendo Hardware Accelerated Video Decoder
fluva:  fluvasink: Fluendo VA Video sink
fluva:  fluvaautosink: Fluendo Video Acceleration auto video sink
fluva:  fluvaclutsink: Fluendo VA Clutter sink
fluva:  fluvaconvert: Fluendo Hardware Accelerated Video Converter

For GStreamer 1.0

user@host$ gst-inspect-1.0 | grep flu

which should show the following result (The following list can vary depending
on what codec pack you bought):

fluh264dec:  fluh264dec: Fluendo H264 Decoder
fluaacdec:  fluaacdec: Fluendo AAC Decoder (HE enabled, stereo downmix)
flump3dec:  flump3dec: Fluendo MP3 Decoder (IPP build)
fluilbc:  fluilbcenc: Fluendo iLBC Encoder
fluilbc:  fluilbcdec: Fluendo iLBC Encoder
fluwmvdec:  fluwmvdec: Fluendo WMV Decoder
fluac3dec:  fluac3dec: Fluendo AC3 Decoder (IPP build with Player protection)
flumpeg2vdec:  flumpeg2vdec: Fluendo MPEG-2 Video Decoder
fluadpcm:  fluadpcmmsdec: Fluendo Microsoft ADPCM Decoder
fluadpcm:  fluadpcmimadvidec: Fluendo ADPCM IMA DVI Decoder
fluadpcm:  fluadpcmimaqtdec: Fluendo ADPCM IMA QT Decoder
fluwmadec:  fluwmsdec: Fluendo WMS Decoder
fluwmadec:  fluwmadec: Fluendo WMA Decoder (STD + PRO + LSL + WMS)
fluasf:  fluasfcmdparse: Fluendo ASF Command Parser
fluasf:  fluasfdemux: Fluendo ASF Demuxer
flumms:  flummssrc: Fluendo MMS source
flumpeg4videodec:  flumpeg4vdec: Fluendo MPEG-4 ASP Video Decoder
fludivx3dec:  fludivx3dec: Fluendo DivX 3.11 Video Decoder
flulpcmdec:  flulpcmdec: Fluendo LPCM decoder

Once the codecs are sucessfully installed, you should have access
to playing back supported media files like Windows Media Video, MPEG videos,
DivX movies using GStreamer applications such as Totem Movie Player,
Rhythmbox Music Player, Banshee Music player, Amarok, Kaffeine or the
Elisa Media center. Please make sure that those applications are using the
GStreamer backend before reporting issues to the support.

The licensing terms of each codec can be found in the LICENSE.txt
file that is shipped together with this file. Usage of Fluendo codecs means
that you accept the terms and conditions of these licenses.

Support :
=========

Together with your product comes a 1 year support contract. This support 
contract includes 1 year of free access to bug fixes and product upgrades.
You can access those updates from the Fluendo WebStore

https://www.fluendo.com

Should you have any problem with the codecs, please contact us :

or send an e-mail to support@fluendo.com

Enjoy,
The Fluendo Team

--

FLUENDO S.A.
Avenida Diagonal 579 7pl.
08014 BARCELONA - SPAIN
+34 933 175 153

