Commit 9bad7ccb authored by Alexis de Lattre's avatar Alexis de Lattre

Première version incomplète du VideoLAN HOWTO.

Petites modifs dans le Quickstart...
parent eaa8b144
......@@ -159,7 +159,7 @@ files.</para>
</itemizedlist>
<para>Download the libraries from <ulink
<para>Download the libraries from the <ulink
url="http://www.videolan.org/vlc/download-sources.html">VLC sources
download page</ulink>.</para>
......
<!--
<sect2><title>Under Windows</title>
<simplesect><title>Install the DVB drivers</title>
<para>
Download the Zip file for Windows from the <ulink
url="http://www.videolan.org/vls/download.html">vls download
page</ulink> and unzip-it in a directory.
</para>
<note><para>
The Windows version of vls can only stream MPEG
files stored on a hard drive. It cannot stream DVDs, satellite channels
or real-time MPEG encoded videos.
</para></note>
<sect2><title>Under Linux Debian</title>
<para>
Edit <filename>/etc/apt/sources.list</filename> and add the following line :
</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 libdvdcss2 vls-dvd</userinput>
</screen>
<para>
If you don't want to stream DVDs, type instead :
</para>
<screen>
<prompt># </prompt><userinput>apt-get update</userinput>
<prompt># </prompt><userinput>apt-get install vls</userinput>
</screen>
</sect2>
<sect2><title>Under Linux RedHat, Mandrake or SuSE</title>
<para>
Download the RPM package of libdvdcss from the <ulink
url="http://www.videolan.org/libdvdcss/download.html">libdvdcss download page</ulink>.
</para>
<para>
Download the RPM package of libdvbpsi from the <ulink url="http://www.videolan.org/libdvbpsi/download.htm">libdvbpsi
download page</ulink>.
</para>
<para>If you want to be able to stream from a DVB card (a satellite
card or a digital terrestial TV card), you need to install the DVB
drivers. Download the latest release of the DVB drivers from the
<ulink url="http://www.linuxtv.org/download/dvb/">DVB drivers download
page</ulink> of the <ulink url="http://www.linuxtv.org/">LinuxTV</ulink>
PROject.</para>
<para>
Download the RPM package of libdvdread from <ulink
url="http://www.dtek.chalmers.se/groups/dvd/redhat.shtm">Ogle's download page</ulink>.
</para>
<para>
Download the RPM packages <filename>vls</filename> and <filename>vls-dvd</filename> from the <ulink url="http://www.videolan.org/vls/download.html">vls download page</ulink>.
</para>
<para>
Then install the RPM packages you have downloaded :
</para>
<screen>
<prompt># </prompt><userinput>rpm -Uhv vls-version.i586.rpm vls-dvd-version.i586.rpm libdvdcss2-version.i586.rpm
libdvbpsi1-version.i586.rpm libdvdread-version.i386.rpm</userinput>
</screen>
</sect2>
-->
<sect2><title>Under Linux or Unix</title>
<para>The method below is for any Unix or Linux supported by the
Videolan Server. It explains how to compile and install vls and the
needed librairies from sources.</para>
<para>Uncompress the tarball and follow the instructions written in
the <filename>INSTALL</filename> file to compile and install the
drivers.</para>
<sect3><title>Install the librairies</title>
<simplesect><title>Install the librairies</title>
<para>
Many librairies are needed for particular uses :
......@@ -96,19 +20,20 @@ Many librairies are needed for particular uses :
<itemizedlist>
<listitem><para><emphasis>libdvbpsi</emphasis> (always needed)</para></listitem>
<listitem><para><emphasis>libdvdcss</emphasis> if you want to be able to access encrypted DVDs,</para></listitem>
<listitem><para><emphasis>libdvdread</emphasis> if you want to be able to stream DVDs.</para></listitem>
<listitem><para><emphasis>libdvdread</emphasis> if you want to be able to stream DVDs,</para></listitem>
<listitem><para><emphasis>libdvb</emphasis> if you want to be able to stream from a DVB card (a satellite card or a digital terrestial TV card).</para></listitem>
</itemizedlist>
<para>
Download the libraries from <ulink
url="http://www.videolan.org/pub/videolan/vls/"></ulink> in the directory
<filename>version/contrib</filename>.
Download the libraries from the <ulink
url="http://www.videolan.org/streaming/download-vls-sources.html">VLS
sources download page</ulink>.
</para>
<para>
For each librairie, uncompress, configure, compile and install :
For each library, uncompress, configure, compile and install :
</para>
<para>
......@@ -138,39 +63,19 @@ contains the following line :
<prompt># </prompt><userinput>ldconfig</userinput>
</screen>
</sect3>
</simplesect>
<sect3><title>Install the VideoLAN Server</title>
<simplesect><title>Install VLS</title>
<!--
<para>
Download the sources of the latest release : get the file
<filename>vls-version.tar.gz</filename> from the <ulink url="http://www.videolan.org/vls/download.html">vls download page</ulink>. Uncompress-it :
</para>
<para> Download the sources of the latest release : get the
file <filename>vls-version.tar.gz</filename> from the <ulink
url="http://www.videolan.org/streaming/download-vls-sources.html">VLS
sources download page</ulink>. Uncompress-it : </para>
<screen>
<prompt>% </prompt><userinput>tar xvzf vls-version.tar.gz</userinput>
<prompt>% </prompt><userinput>cd vls-version</userinput>
</screen>
-->
<para>
Get the most recent version of the VideoLAN Server from the public CVS :
</para>
<screen>
<prompt>% </prompt><userinput>cvs -d:pserver:anonymous@cvs.videolan.org:/cvs/videolan login</userinput>
</screen>
<para>
There is no password. Type enter, then :
</para>
<screen>
<prompt>% </prompt><userinput>cvs -d:pserver:anonymous@cvs.videolan.org:/cvs/videolan checkout -P -r v0_4_5 vls</userinput>
</screen>
<para>
To get the list of configuration options, do :
......@@ -186,7 +91,7 @@ Then configure vls :
<itemizedlist>
<listitem><para>if you want a basic vls without DVD support, do :
<listitem><para>if you want a basic VLS without DVD support, do :
</para>
<screen>
......@@ -195,7 +100,7 @@ Then configure vls :
</listitem>
<listitem><para>if you want a full vls with DVD support, do :
<listitem><para>if you want a VLS with DVD support, do :
</para>
<screen>
......@@ -222,5 +127,4 @@ clean</command> or <command>make distclean</command> as needed.
</para>
</sect3>
</sect2>
</simplesect>
......@@ -52,7 +52,7 @@ Here is an illustration of the complete VideoLAN solution :
<para>
More details about the project can be found on the
<ulink url="http://www.videolan.org">VideoLAN Web site</ulink>.
<ulink url="http://www.videolan.org/">VideoLAN Web site</ulink>.
</para>
......
......@@ -31,4 +31,4 @@ txt:
sgmltools -b txt videolan-howto.sgml
clean:
rm -f *.zip *.html *.pdf *.ps *.txt
rm -f *.zip *.html *.pdf *.ps *.txt *.rtf
<chapter id="overview"><title id="toverview">Overview [de quoi, au fait ?]</title>
</chapter>
......@@ -4,12 +4,13 @@
%magic-entities;
<!ENTITY intro SYSTEM "../common/intro.sgml">
<!ENTITY overview SYSTEM "overview.sgml">
<!ENTITY vlc SYSTEM "vlc.sgml">
<!ENTITY vlc-streamoutput SYSTEM "vlc-streamoutput.sgml">
<!ENTITY vls SYSTEM "vls.sgml">
<!ENTITY vlcs SYSTEM "vlcs.sgml">
<!ENTITY vod SYSTEM "vod.sgml">
<!ENTITY faq SYSTEM "faq.sgml">
<!ENTITY vod SYSTEM "../videolan-quickstart/vod.sgml">
<!ENTITY vlcs SYSTEM "../videolan-quickstart/vlcs.sgml">
<!ENTITY install-vlc SYSTEM "../common/install-vlc.sgml">
<!ENTITY install-vls SYSTEM "../common/install-vls.sgml">
<!ENTITY uninstall-vls SYSTEM "../common/uninstall-vls.sgml">
<!ENTITY fdl SYSTEM "../common/fdl.sgml">
......@@ -92,10 +93,10 @@ solution.</para>
<toc></toc>
&intro;
&overview;
&vlc;
&vlc-streamoutput;
&vls;
&vlcs;
&vod;
&faq;
&vlcs;
&fdl;
</book>
<chapter id="vlc-streamoutput"><title id="tvlc-streamoutput">Stream with VLC's stream output</title>
<sect1><title>Running VLC from the command line</title>
<sect2><title>Unicast an MPEG-1, MPEG-2, or MPEG-4 / DivX file</title>
<screen>
<prompt>% </prompt><userinput>vlc /media/video/video1.avi --sout udp://client.example.org</userinput>
</screen>
<para>where <filename>/media/video/video1.avi</filename> is the file
you want to stream and <emphasis>client.example.org</emphasis> is the
DNS name of the client you want to stream to (you can put an IP address
instead).</para>
<note><para>Under Windows, make sure that you are in the same directory
as the VLC install directory.</para></note>
<sect2><title>Unicast a DVD</title>
<screen>
<prompt>% </prompt><userinput>vlc dvdold:/dev/dvd --sout udp://client.example.org</userinput>
</screen>
<para>where <filename>/dev/dvd</filename> is the device corresponding
to your DVD drive (put <filename>D:</filename> under Windows if
<filename>D</filename> is the letter of your DVD drive) or the directory
where you copied your DVD, and <emphasis>client.example.org</emphasis>
is the DNS name of the client you want to stream to (you can put an IP
address instead).</para>
<note>
<para>
Under Unix/Linux, you must have write access to the device
corresponding to your DVD drive. For that, you should be in the
<emphasis>disk</emphasis> or <emphasis>cdrom</emphasis> group (look
at the permissions in <filename>/dev</filename>). If you're not, add
yourself to the group :
</para>
<screen>
<prompt># </prompt><userinput>adduser your_login disk_or_cdrom</userinput>
</screen>
<para>and then restart your session.</para>
</note>
<sect2><title>Multicast an MPEG file or a DVD</title>
<screen>
<prompt>% </prompt><userinput>vlc /media/video/video1.avi --sout udp://239.255.12.42 --ttl 12</userinput>
</screen>
<para>where <filename>/media/video/video1.avi</filename> is the file you
want to stream (remplace it with <emphasis>dvdold:/dev/dvd</emphasis>
under Unix or <emphasis>dvdold:D:</emphasis> under Windows if you want
to multicast a DVD), <emphasis>239.255.12.42</emphasis> is the multicast
IP address you want to stream on and <emphasis>12</emphasis> is the
value of the TTL (Time To Live) of your IP packets (which means that the
multicast stream will be able to cross 11 routers).</para>
<chapter id="vlc"><title id="tvlc">Receive a stream with VLC</title>
<sect1><title>Installing VLC</title>
&install-vlc;
</sect1>
<sect1><title>Running VLC</title>
<sect2><title>Read an unicast stream</title>
<para>Launch VLC, click on
the <emphasis>Net</emphasis> button, select <emphasis>UDP</emphasis>,
keep the default port and click on <emphasis>OK</emphasis>.</para>
<para>You can also use the following command line :</para>
<screen>
<prompt>% </prompt><userinput>vlc udp:</userinput>
</screen>
</sect2>
<sect2><title>Read a multicast stream</title>
<para>Launch VLC, click on the <emphasis>Net</emphasis>
button, select <emphasis>UDP Multicast</emphasis>, type
the multicast IP address, keep the default port and click on
<emphasis>OK</emphasis>.</para>
<para>You can also use the following command line :</para>
<screen>
<prompt>% </prompt><userinput>vlc udp:@239.255.12.42</userinput>
</screen>
<para>where <emphasis>239.255.12.42</emphasis> is the multicast IP
address you want to join.</para>
</sect2>
</sect1>
</chapter>
<chapter id="vls"><title id="tvls">The VideoLAN Server</title>
<chapter id="vls"><title id="tvls">Stream with VLS</title>
<sect1><title>Installing the VideoLAN Server</title>
<sect1><title>Installing VLS</title>
&install-vls;
</sect1>
<sect1><title>Uninstalling the VideoLAN Server</title>
&uninstall-vls;
</sect1>
<sect1><title>Running VLS from the command line</title>
<sect2><title>Unicast an MPEG-1, MPEG-2 or MPEG-4 file</title>
<screen>
<prompt>% </prompt><userinput>vls -vv -d udp:client.example.org file:/media/video/video1.vob</userinput>
</screen>
<para>where <filename>/media/video/video1.vob</filename> is
the MPEG file you want to stream (it must be in MPEG-1 PS,
MPEG-2 PS, MPEG-2 TS, MPEG-4 PS or MPEG-4 TS format) and
<emphasis>client.example.org</emphasis> is the DNS name of the client
you want to stream to (you can put an IP address instead).</para>
<para>When you want to stop VLS, use the key combination
<keycombo><keycap>Ctrl</keycap><keycap>c</keycap></keycombo>.</para>
<para>If you want to stream the file continuously, use the
<emphasis>--loop</emphasis> option :</para>
<screen>
<prompt>% </prompt><userinput>vls -vv -d udp:client.example.org --loop file:/media/video/video1.vob</userinput>
</screen>
</sect2>
<sect2><title>Unicast a DVD</title>
<screen>
<prompt>% </prompt><userinput>vls -vv -d udp:client.example.org dvd:/dev/dvd</userinput>
</screen>
<para>where <filename>/dev/dvd</filename> is the device corresponding
to your DVD drive or the directory where you copied your DVD, and
<emphasis>client.example.org</emphasis> is the DNS name of the client
you want to stream to (you can put an IP address instead).
<sect1><title>Using the VideoLAN Server</title>
</sect1>
<note>
<para>
You must have write access to the device corresponding to your DVD
drive. For that, you should be in the <emphasis>disk</emphasis>
or <emphasis>cdrom</emphasis> group (look at the permissions in
<filename>/dev</filename>). If you're not, add yourself to the group :
</para>
<screen>
<prompt># </prompt><userinput>adduser your_login disk_or_cdrom</userinput>
</screen>
<para>and then restart your session.</para>
</note>
</sect2>
<sect2><title>Multicast an MPEG file or a DVD</title>
<screen>
<prompt>% </prompt><userinput>vls -vv -d udp:239.255.12.42 --ttl 12 file:/media/video/video1.vob</userinput>
</screen>
<para>where <emphasis>file:/media/video/video1.vob</emphasis> is the
MPEG file you want to stream (use <emphasis>dvd:/dev/dvd</emphasis>
instead if you want to stream a DVD), <emphasis>239.255.12.42</emphasis>
is the multicast IP address you want to stream on and
<emphasis>12</emphasis> is the value of the TTL (Time To Live) of your
IP packets (which means that the multicast stream will be able to cross
11 routers).</para>
</sect2>
</sect1>
</chapter>
......@@ -12,7 +12,6 @@
<!ENTITY install-vlc SYSTEM "../common/install-vlc.sgml">
<!ENTITY install-vlcs SYSTEM "../common/install-vlcs.sgml">
<!ENTITY fdl SYSTEM "../common/fdl.sgml">
......
<chapter id="vlc-streamoutput"><title id="tvlc-streamoutput">Stream with VLC</title>
<chapter id="vlc-streamoutput"><title id="tvlc-streamoutput">Stream and receive with VLC</title>
<sect1><title>Unicast an MPEG-1, MPEG-2, or MPEG-4 / DivX file</title>
......@@ -8,11 +8,11 @@
<para>Open a terminal and type :</para>
<screen>
<prompt>% </prompt><userinput>vlc /media/video/video1.avi --sout udp://client.exemple.org</userinput>
<prompt>% </prompt><userinput>vlc /media/video/video1.avi --sout udp://client.example.org</userinput>
</screen>
<para>where <filename>/media/video/video1.avi</filename> is the file
you want to stream and <emphasis>client.exemple.org</emphasis> is the
you want to stream and <emphasis>client.example.org</emphasis> is the
DNS name of the client you want to stream to (you can put an IP address
instead).</para>
......@@ -32,14 +32,15 @@ keep the default port and click on <emphasis>OK</emphasis>.</para>
<para>Open a terminal and type :</para>
<screen>
<prompt>% </prompt><userinput>vlc dvdold:/dev/dvd --sout udp://client.exemple.org</userinput>
<prompt>% </prompt><userinput>vlc dvdold:/dev/dvd --sout udp://client.example.org</userinput>
</screen>
<para>where <filename>/dev/dvd</filename> is the device corresponding
to your DVD drive (put <filename>D:</filename> under Windows
if <filename>D</filename> is the letter of your DVD drive) and
<emphasis>client.exemple.org</emphasis> is the DNS name of the client
you want to stream to (you can put an IP address instead).</para>
to your DVD drive (put <filename>D:</filename> under Windows if
<filename>D</filename> is the letter of your DVD drive) or the directory
where you copied your DVD, and <emphasis>client.example.org</emphasis>
is the DNS name of the client you want to stream to (you can put an IP
address instead).</para>
<note>
......@@ -84,7 +85,7 @@ of multicast streaming is that only the machines that want to receive
the stream actually receive it, and the streaming server only sends one
stream even if there are multiple clients receiving it.</para>
<simplesect><title>Start VLC on the server side</title>
<simplesect><title>Start VLC on the server</title>
<para>Open a terminal and type :</para>
......@@ -98,11 +99,11 @@ under Unix or <emphasis>dvdold:D:</emphasis> under Windows if you want
to multicast a DVD), <emphasis>239.255.12.42</emphasis> is the multicast
IP address you want to stream on and <emphasis>12</emphasis> is the
value of the TTL (Time To Live) of your IP packets (which means that the
multicast stream will to able to cross 11 routers).</para>
multicast stream will be able to cross 11 routers).</para>
<simplesect><title>Start VLC(s)</title>
<simplesect><title>Start VLC(s) on the clients</title>
<para>Launch VLC and click on the <emphasis>Net</emphasis>
button. Then select <emphasis>UDP Multicast</emphasis>, type
......
<chapter id="vlc"><title id="tvlc">The VideoLAN Client (VLC)</title>
<chapter id="vlc"><title id="tvlc">VLC, the universal media player</title>
<sect1><title>Installing VLC</title>
......
......@@ -32,4 +32,4 @@ txt:
sgmltools -b txt vlc-user-guide.sgml
clean:
rm -f *.zip *.html *.pdf *.ps *.jpg *.txt
rm -f *.zip *.html *.pdf *.ps *.jpg *.txt *.rtf
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment