INSTALL

INSTALL file for the VLC media player
=====================================

More extensive information for *nix, Windows and Mac OS X users can be
found here: http://wiki.videolan.org/Compile_VLC

People installing VLC for Windows from source MUST read:
http://wiki.videolan.org/Win32Compile

Bootstrapping VLC
=================

If you retrieved VLC from the git server and do not have yet a "configure"
script, please run:

    ./bootstrap

Configuring VLC
===============

A typical way to configure VLC is:

   ./configure

See `./configure --help' for more information.

If you intend to debug stuff, you may want to compile with debugging
symbols:

   make distclean ; ./configure --enable-debug

We recommend using either GCC or Clang/LLVM to build VLC. Specifically,
GCC version 5 or higher, or Clang/LLVM version 3.4 or higher are required.
Other compilers with compatible feature sets should also work.


Building VLC
============

Once configured, run `make' to build VLC.


Installing and running VLC
==========================

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
from the current directory as well:

   ./vlc


Building packages
=================

To build a Debian package, you need to get the packaging info
   git clone git://git.debian.org/pkg-multimedia/vlc.git debian
and then
   git-buildpackage