LDP/LDP/ref/docbook/VideoLAN-Quickstart/install-vlc.sgml

263 lines
7.7 KiB
Plaintext

<para>There are VLC binaries available for the many OSes, but not for
all supported OSes. If there are no binaries for your OS or if you want
to change the default settings, you can compile VLC from sources.</para>
<sect2><title>Under Windows</title>
<para>VLC works under Windows 95/98/ME/2000/XP.
Download the self-extracting file from the <ulink
url="http://www.videolan.org/vlc/download-windows.html">VLC Windows
download page</ulink>. Launch the <filename>.exe</filename> to install
VLC.</para>
</sect2>
<sect2><title>Under BeOS</title>
<para>
Download the Zip file from the <ulink
url="http://www.videolan.org/vlc/download-beos.html">VLC BeOS download
page</ulink>. Unzip the file in a directory to install VLC.
</para>
</sect2>
<sect2><title>Under Mac OS X</title>
<para>
Download the Mac OS X package from the <ulink
url="http://www.videolan.org/vlc/download-macosx.html">VLC
MacOS X download page</ulink> . Double-click on the icon of the
package : an icon will appear on your Desktop, right beside your
drive(s). Open it and drag the VLC application from the resulting
window to the place where you want to install it (it should be
<filename>/Applications</filename>).
</para>
</sect2>
<sect2><title>Under Linux Debian</title>
<para>Edit as root <filename>/etc/apt/sources.list</filename> and add
the following lines :</para>
<programlisting>
deb http://www.videolan.org/pub/videolan/debian $(ARCH)/
deb-src http://www.videolan.org/pub/videolan/debian sources/
</programlisting>
<para>Then install the packages :</para>
<screen>
<prompt># </prompt><userinput>apt-get update</userinput>
<prompt># </prompt><userinput>apt-get install gnome-vlc libdvdcss2</userinput>
</screen>
</sect2>
<sect2><title>Under Linux Mandrake</title>
<para> First, VLC is included in the <ulink
url="http://www.mandrakelinux.com/">Mandrake Linux</ulink> distribution,
thus if your are running <emphasis>cooker</emphasis>, just get it from
you preferred cooker mirror. </para>
<para> As it is not possible to update softwares in a previous
distributions, you have to install the RPMs "by hand" if
you don't use <emphasis>cooker</emphasis>. The simplest way
is to use <emphasis>urpmi</emphasis> (command line interface)
or <emphasis>rpmdrake</emphasis> (you will find in the Mandrake Control
Center). General instrctutions about <emphasis>urpmi</emphasis> can be found
on <ulink url="http://www.urpmi.org">http://www.urpmi.org</ulink>
(both in french and english). <emphasis>urpmi-setup</emphasis> will make
it easier to setup <emphasis>urpmi</emphasis> to your needs: see <ulink
url="http://plf.zarb.org/~nanardon/">http://plf.zarb.org/~nanardon/</ulink>
. You need at least to add main, contrib and plf sources. </para>
<itemizedlist>
<listitem><para> get libdvdplay, vlc, vlc-plugin-mad, vlc-plugin-a52,
gnome-vlc (or vlc-gtk) RPMs from this page and all the plugins you want.
</para></listitem>
<listitem><para> install them with: </para>
<screen>
<prompt># </prompt><userinput>urpmi libdvdplay*rpm *vlc*rpm</userinput>
</screen>
<para>(urpmi will complete all the dependencies)</para></listitem>
</itemizedlist>
<sect2><title>Under Linux Redhat</title>
<para>Download the RPM package <emphasis>vlc</emphasis> and the packages
listed in the <emphasis>required librairies and codecs</emphasis>
section (the other packages are just optional) from the <ulink
url="http://www.videolan.org/vlc/download-redhat.html">VLC Red Hat
download page</ulink> and put them all into the same directory.
<para>Then install the RPM packages you have downloaded:</para>
<screen>
<prompt># </prompt><userinput>rpm -U *.rpm</userinput>
</screen>
<para>If you have not installed all the RPM packages included with your
distribution, you may be asked to install a few of them first.</para>
</sect2>
<sect2><title>Compile the sources by yourself (for every other OS)</title>
<para>The method below is for any Unix system supported by VLC, for
which there is no packages available. It explains how to compile and
install VLC and the needed librairies from their source code.</para>
<para>You can also compile the VLC under Linux this way if you want to
modify the default supported modules</para>
<sect3><title>Install the libraries</title>
<para>Many libraries are needed for particular uses :</para>
<itemizedlist>
<listitem><para><emphasis>libdvdcss</emphasis> if you want to be able to
read encrypted DVDs,</para></listitem>
<listitem><para><emphasis>libdvdplay</emphasis> if you want to have DVD
menu navigation,</para></listitem>
<listitem><para><emphasis>libdvbpsi</emphasis> if you want to be able to
read from the network,</para></listitem>
<listitem><para><emphasis>a52dec</emphasis> if you want to be
able to decode the AC3 (i.e. A52) sound format often used in
DVDs,</para></listitem>
<listitem><para><emphasis>ffmpeg</emphasis>, <emphasis>libmad</emphasis>
and <emphasis>faad2</emphasis> if you want to read MPEG 4 / DivX
files,</para></listitem>
<listitem><para><emphasis>libogg</emphasis> and
<emphasis>libvorbis</emphasis> if you want to read Ogg Vorbis
files.</para>
</itemizedlist>
<para>Download the libraries from the <ulink
url="http://www.videolan.org/vlc/download-sources.html">VLC sources
download page</ulink>.</para>
<para>For each library :</para>
<itemizedlist>
<listitem><para>uncompress :</para>
<screen>
<prompt>% </prompt><userinput>tar xvzf library.tar.gz</userinput>
</screen>
<para>or</para>
<screen>
<prompt>% </prompt><userinput>tar xvjf library.tar.bz2</userinput>
</screen>
<listitem><para>configure :</para>
<screen>
<prompt>% </prompt><userinput>cd library</userinput>
<prompt>% </prompt><userinput>./configure --enable-shared</userinput>
</screen>
<listitem><para>compile and install :</para>
<screen>
<prompt>% </prompt><userinput>make</userinput>
<prompt># </prompt><userinput>make install</userinput>
</screen>
</itemizedlist>
<para>
Check that the configuration file <filename>/etc/ld.so.conf</filename>
contains the following line :
</para>
<programlisting>
/usr/local/lib
</programlisting>
<para>If the line is not present, add-it and then run (as root):</para>
<screen>
<prompt># </prompt><userinput>ldconfig</userinput>
</screen>
</sect3>
<sect3><title>Install VLC</title>
<para>Download the sources of the lastest release : get the
file <filename>vlc-version.tar.gz</filename> from the <ulink
url="http://www.videolan.org/vlc/download-sources.html">VLC sources
download page</ulink>. Uncompress-it :</para>
<screen>
<prompt>% </prompt><userinput>tar xvzf vlc-version.tar.gz</userinput>
<prompt>% </prompt><userinput>cd vlc-version</userinput>
</screen>
<!-- bootstrap is already done is the tarballs -->
<para>To get the list of configuration options, do :</para>
<screen>
<prompt>% </prompt><userinput>./configure --help</userinput>
</screen>
<para>Please note that all the modules are described in
the <emphasis>Modules</emphasis> section of the <ulink
url="http://www.videolan.org/doc/vlc-user-guide/">VLC User
Guide</ulink>.</para>
<para>Examples of very simple configurations:</para>
<itemizedlist>
<listitem><para>if you want a basic VLC, do : </para>
<screen>
<prompt>% </prompt><userinput>./configure</userinput>
</screen>
</listitem>
<listitem><para>if you want the Gnome interface instead of the GTK
interface (you will need the developement packages of Gnome) :</para>
<screen>
<prompt>% </prompt><userinput>./configure --enable-gnome</userinput>
</screen>
</listitem>
</itemizedlist>
<para>
Then, compile and install :
</para>
<screen>
<prompt>% </prompt><userinput>make</userinput>
<prompt>% </prompt><userinput>su</userinput>
<prompt>Password: </prompt><userinput> [Root Password]</userinput>
<prompt># </prompt><userinput>make install</userinput>
</screen>
<para>Please note that the installation (<command>make install</command>
command) is not mandatory. You can execute VLC from where you compiled
it.</para>
</sect3>
</sect2>