-INSTALL file for vlc, the VideoLAN Client
+INSTALL file for the VLC media player
+More extensive information for *nix, Windows, Mac OS X and BeOS users can be found here:
+http://developers.videolan.org/vlc/
-Configuring VideoLAN
-====================
-
-A typical way to configure vlc is:
+Bootstrapping VLC
+=================
- ./configure --prefix=/usr --enable-gnome --with-sdl
+If you retrieved VLC from the SVN server and do not have a "configure"
+script, please refer to the HACKING file.
-See `./configure --help' for more information.
+Configuring VLC
+===============
-Here is a shortcut to copy-paste for a complete build:
+A typical way to configure VLC is:
- make distclean && ./configure --prefix=/usr --enable-gnome \
- --enable-fb --with-glide --with-ggi --with-sdl --enable-esd \
- --enable-mga --enable-gtk --enable-qt --enable-xvideo --enable-alsa
+ ./configure --prefix=/usr
-If you intend to debug stuff, you may want to disable optimizations:
+See `./configure --help' for more information.
- make distclean && ./configure --prefix=/usr --enable-gnome \
- --enable-fb --with-glide --with-ggi --with-sdl --enable-esd \
- --enable-mga --enable-gtk --enable-qt --enable-xvideo --enable-alsa \
- --enable-debug
+If you intend to debug stuff, you may want to compile with debugging
+symbols:
-It is also possible to cross-compile for the Win32 platform using mingw32:
+ make distclean ; ./configure --prefix=/usr --enable-debug
- make distclean && CC=i586-mingw32msvc-gcc CFLAGS=-I/usr/i586-mingw32msvc \
- RANLIB=i586-mingw32msvc-ranlib ./configure --host=i386-mingw32msvc \
- --target=i386-mingw32msvc --build=i386-linux --disable-dsp \
- --disable-gtk --disable-x11 --disable-xvideo
+We recommend using GCC to build VLC, though some people reported success
+with the Intel C compiler (version 8) as well. GCC version 3.3 or higher is
+required. On older systems (e.g. FreeBSD 4.x, BeOS), please select a more
+recent version manually by setting the CC and CXX environment variables
+appropriately while running the ./configure shell script.
-Building VideoLAN
-=================
+Building VLC
+============
-Have a look at the generated Makefile.opts file, you may want to choose
-which modules will be compiled as plugins, and which ones will remain in
-the core application. The configure script tries to guess for you.
+Once configured, run `make' to build VLC.
-Once configured, run `make' to build vlc.
+Installing and running VLC
+==========================
-Installing and running VideoLAN
-===============================
-
-You can install the vlc and its plugins by typing:
+You can install the VLC and its plugins by typing:
make install
-But you don't need to install it if you don't want to; vlc can be launched
+But you don't need to install it if you don't want to; VLC can be launched
from the current directory as well:
./vlc
Building packages
=================
-To build a Debian package, you may use:
-
+To build a Debian package, you need to get the packaging info
+ svn co svn://svn.debian.org/pkg-multimedia/videolan/vlc/debian debian
+and then
dpkg-buildpackage -rfakeroot -us -uc
rpm -ba vlc.spec
+To build an ipkg package (iPAQ familiar Linux), use:
+
+ ipkg-buildpackage
+