vlc-compilation.txt

udp-lite for upd lite linux kernel

                               Compiling VLC

0) Prerequisites:
=================
   It is necessary that both libtool and autoconf are available on the system.
                       apt-get install autoconf libtool

1) Package dependencies
=======================
  a) Install from rpm [NOTE: for each package X, the package "X-devel" is also required]:
  --imlib2:          a replacement X library with improved features (ffmpeg depends on this)
  --gettext:         support for multi-lingual messages in programs
  --freetype:        true-type font rendering engine
  --zlib:            lossless data compression library
  --libxml2:         read, write, modify, and parse XML and HTML files
  --libvorbis:       runtime support for Ogg Vorbis
  --libraw1394:      direct access to the IEEE-1394 bus (this package is optional)
  --libpostproc:     mplayer's post-processing library (for transcoding, e.g.)

                            Under Debian:
                            *************
  apt-get install libimlib2 libimlib2-dev gettext libfreetype6 libfreetype6-dev \
                  zlib1g zlib1g-dev libxml2 libxml2-dev libvorbis0a libvorbis-dev \
                  libraw1394-5 libraw1394-dev


  1b) wx Windows:
  ---------------
     (a) Fedora needs the following RPMs:
             wxGTK-2.4.2-12.i386.rpm wxGTK-common-2.4.2-12.i386.rpm
             wxGTK-stc-2.4.2-12.i386.rpm wxGTK-xrc-2.4.2-12.i386.rpm
             wxGTK-devel-2.4.2-12.i386.rpm wxGTK-common-devel-2.4.2-12.i386.rpm
     (b) Under Debian:
             apt-get install libwxgtk2.6-0  libwxgtk2.6-dev wx2.6-headers


2) Check that pthreads are available (/usr/lib/libpthread*, in glibc-devel RPM)


3) Compile supporting packages:
===============================
  --fribidi:         support for the arabic/Hebrew alphabets
  --openslp:         open-source implementation of the Service Location Protocol
  --libebml:         (used by libmatroska)
                        cd make/linux; make && make install
  --libmatroska:     extensible open standard Audio/Video container format
                        cd make/linux; make && make install
  --libiconv:        GNU character conversion library


4) Compile all codecs:
======================
  --a52dec:         decoder for ATSC A/52 or AC-3 audio format
  --libogg:         Ogg bitstream format library (RFC 3533)
  --flac:          `Free Lossless Audio Codec' -- Ogg Vorbis in a lossless way
  --faac:           `Freeware Advanced Audio Coder' based on ISO MPEG-4 reference code
                    for MPEG-4 ISO AAC files
  --faad2:          a HE, LC, MAIN and LTP profile, MPEG2 and MPEG-4 AAC decoder.
  --lame:           MP3 encoder, includes libmp3lame
  --libid3tag:      reading/writing ID3 tags in MP3 files (requires zlib)
  --libmad:         MP3 audio decoder
  --toolame:        optimized MPEG 1/2  layer-2 audio encoder
                       make
                       mv toolame stoolame /usr/local/bin
                       mv libtoolame/libtoolame.a /usr/local/lib
  --libspeex:       open source voice codec (e.g. for VoIP)
  --pa (portaudio): audio I/O library
  --x264:           H.264 video codec
                    get the latest from http://developers.videolan.org/x264.html
  --mpeg2dec:       libmpeg2 is a free library for decoding mpeg-2 and mpeg-1 video streams.
  --libtheora:      theora video codec, intended to be used with the Ogg multimedia stream.
  --xvidcore:       ISO MPEG-4 compliant open-source codec
                       cd ${xvidcore}/build/generic
                       ./configure
                       in the file `platform.inc', remove the option
                       "-freduce-all-givs" from the CFLAGS options (does not work with gcc)
                       make && make install

  --libdts:         audio decoder for audio frames encoded using DTS Coherent Acoustics
  --libpostproc:    (if not already installed via rpm) This is part of the mplayer package.
                       mkdir -p  /usr/local/lib/codecs
                         ==> extract all windows codecs to this directory
                         ==> then build the mplayer
                    After building mplayer: cd libavcodec/libpostproc; make && make install


5) Build ffmpeg
===============
  After performing the above steps, do a `ldconfig' first.
  Use the `run-ffmpeg' script provided in this directory for a number
  of options that worked in my case.


6) Compile additional packages
==============================
  --goom2k4:        xmmms visualisation plugin
  --libmodlug:      ModPlug plugin for xmms
  --libcddb:        CDDB database access
                     --> in case of compilation trouble, exclude `examples'
                     from the SUBDIRS variable in the Makefile


7) Compile packages to access DVB and DVD
=========================================
  --libdvbpsi:      support for demultiplexing a satellite DVB stream
  --libdvdread:     foundation for reading DVD-Video images
  --libdvdcss:      portable abstraction library for DVD decryption
  --libdvdnav:      support for DVD navigation features


8) Compile VLC
==============
  Use the `run-vlc' script to generate vlc. The directory locations used in
  that script may have to be adapted to the location of source files.
  NOTE:
  At the very end of the compilation, during linking, the compiler complains
  about unresolved symbols in
     .... ffmpeg/libavformat/libavformat.a
  These symbols are contained in
     .... ffmpeg/libavutil/libavutil.a
  To resolve the problem,
    1) copy and past the last compilation command, i.e. g++ -W ....,
       into a file.
    2) after -L <...>/ffmpeg/libavformat , add the following two lines:
          <...>/ffmpeg/libavutil/libavutil.a  \
        -L<...>/ffmpeg/libavutil   -lavutil  \

  Finally, in order to enable the use of dynamically loadable codecs,
  copy the codecs used by mplayer located in /usr/local/lib/codecs
  to /usr/local/lib/win32 (or install a symlink); vlc depends on this
  directory.
  
  OTHER VLC PROBLEMS
  ------------------
  * In case of any trouble, try `vlc -vv -l' to see diagnostic output. 
  * It is also good to do a `rm -fr $HOME/.vlc', since stale configuration
    information may be stored in that directory.
  * using pthreads (--enable-pth) on dual-processor machines proved not a good idea,
    video screen stopped working.
  * With vlc-0.8.4a I had the problem that libcdio caused problems with the wx widgets 
    plugin which could therefore not be loaded. The fix was to `make uninstall' the 
    libcdio package in /usr/local/lib and /usr/local/include, and recompile.
  * The build process stops with cc1plus complaining about the invalid flag `-mtune=pentium2'
    in the file vlc-config. Commenting out the respective line resolves this hang-up.