* Renamed all tags (eg. v0_2_83 -> 0.2.83).
[vlc.git] / INSTALL.libmad
blob49a1af112323bfc38eaceda17f7d57ae9e00f1fa
1 INSTALL file for libmad, an integer based MPEG 1,2,3 audio decoder library
4 The mad plugin/builtin of VideoLan Client (vlc) uses an external library called libmad.
6 Before compiling mad support into vlc the library must be installed first. The following
7 text will explain howto compile and install libmad and mad plugin/builtin.
10 Where to find libmad
11 =====================
13 Libmad can be found at: http://www.mars.org/home/rob/proj/mpeg/
14 and is part of the mad distribution.
17 Configuring libmad
18 =====================
20 Goto to the libmad subdirectory and run configure..
22 A typical way to configure libmad as static library is:
24    ./configure --prefix=/usr --enable-static
26 A typical way to configure libmad as shared library is:
28    ./configure --prefix=/usr --enable-shared
30 See `./configure --help' for more information.
33 Building libmad
34 ==================
36 Once configured, run `make' to build libmad.
39 Installing libmad
40 ====================
42 You can install libmad as root by typing:
44    make install
46 Libmad will be installed into the directory used at the configure stage.
47 In our example this is /usr (libaries will go in /usr/lib/, include files
48 will go in /usr/include).
51 Configuring mad plugin
52 =========================
54 If libmad is installed in /usr (ie. you have /usr/include/mad.h and /usr/lib/libmad.a),
55 then you just need --enable-mad --with-mad=/usr.
57    make distclean; ./configure --prefix=/usr --enable-fb --enable-dsp --disable-sdl \
58         --enable-x11 --disable-xvideo --enable-mad --with-mad=/usr
60 If sdl source code is installed, then --enable-sdl can also be used.    
61         
62    make distclean; ./configure --prefix=/usr --enable-fb --enable-dsp --disable-sdl \
63         --enable-x11 --enable-xvideo --enable-mad --with-mad=/usr
65         
66 Building mad plugin
67 =====================
69 Once configured, run `make' to build vlc with mad support.
72 Installing mad
73 ==================
75 You can install vlc as root by typing:
77    make install