INSTALL

   1 INSTALL file for vlc, the VideoLAN Client
   2
   3
   4 Configuring VideoLAN
   5 ====================
   6
   7 A typical way to configure vlc is:
   8
   9    ./configure --prefix=/usr --enable-gnome
  10
  11 See `./configure --help' for more information.
  12
  13 Here is a shortcut to copy-paste for a complete build:
  14
  15    make distclean ; ./configure --prefix=/usr --enable-gnome \
  16       --enable-fb --with-glide --with-ggi --enable-esd --enable-qt
  17
  18 If you intend to debug stuff, you may want to compile with debugging
  19 symbols:
  20
  21    make distclean ; ./configure --prefix=/usr --enable-gnome \
  22       --enable-fb --with-glide --with-ggi --enable-esd --enable-qt \
  23           --enable-debug
  24
  25 It is also possible to cross-compile for the Win32 platform using mingw32:
  26
  27    make distclean ; CC=i586-mingw32msvc-gcc CFLAGS=-I/usr/i586-mingw32msvc \
  28    RANLIB=i586-mingw32msvc-ranlib WINDRES=i586-mingw32msvc-windres \
  29    ./configure --host=i386-mingw32msvc --with-directx-path=<path> \
  30    --with-sdl-config-path=<path> --with-gtk-config-path=<path>
  31
  32
  33 Building VideoLAN
  34 =================
  35
  36 Have a look at the generated Makefile.opts file, you may want to choose
  37 which modules will be compiled as plugins, and which ones will remain in
  38 the core application. The configure script tries to guess for you.
  39
  40 Once configured, run `make' to build vlc.
  41
  42
  43 Installing and running VideoLAN
  44 ===============================
  45
  46 You can install the vlc and its plugins by typing:
  47
  48    make install
  49
  50 But you don't need to install it if you don't want to; vlc can be launched
  51 from the current directory as well:
  52
  53    ./vlc
  54
  55
  56 Building packages
  57 =================
  58
  59 To build a Debian package, you may use:
  60
  61    dpkg-buildpackage -rfakeroot -us -uc
  62
  63
  64 To build RedHat packages, use:
  65
  66    rpm -ba vlc.spec
  67
  68 To build an ipkg package (iPAQ familiar Linux), use:
  69
  70    ipkg-buildpackage
  71