Commit 7528679b authored by Alexis de Lattre's avatar Alexis de Lattre

The VideoLAN Quickstart now explain the VLC stream output.

parent bca7f71b
......@@ -10,7 +10,7 @@ exemple</para>
<para>
The VideoLAN Client works under Windows 95/98/ME/2000/XP. Download
the Windows Installer or the Zip file from the <ulink
url="http://www.videolan.org/vlc/download.html">VLC download
url="http://www.videolan.org/vlc/download-windows.html">VLC Windows download
page</ulink>. Execute the Windows installer or unzip the file in a
directory to install the VideoLAN Client.
</para>
......@@ -21,8 +21,8 @@ directory to install the VideoLAN Client.
<para>
Download the Zip file from the <ulink
url="http://www.videolan.org/vlc/download.html">VLC download
page</ulink>. Unzip the file in a directory to install vlc.
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>
......@@ -32,11 +32,12 @@ page</ulink>. Unzip the file in a directory to install vlc.
<para>
Download the Mac OS X package from the <ulink
url="http://www.videolan.org/vlc/download.html">vlc dowload 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>).
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>
......@@ -70,22 +71,13 @@ url="http://www.rpmfind.net/linux/RPM/">RPMfind.net</ulink> or search
the Internet.</para>
<para>
Download the RPM package of <emphasis>libdvdcss</emphasis> from the
<ulink url="http://www.videolan.org/libdvdcss/download.html">libdvdcss
download page</ulink>.
</para>
<para>
Download the RPM package of <emphasis>libdvdpsi</emphasis> from the
<ulink url="http://www.videolan.org/libdvbpsi/download.html">libdvdpsi
Download the RPM packages of <emphasis>libdvdcss2</emphasis>,
<emphasis>libdvdpsi1</emphasis>, <emphasis>vlc</emphasis>
<emphasis>vlc-gnome</emphasis> and <emphasis>vlc-mad</emphasis> from the
<ulink url="http://www.videolan.org/vlc/download-linux.html">VLC Linux
download page</ulink>.
</para>
<para>
Download the RPM packages <emphasis>vlc</emphasis>
<emphasis>vlc-gnome</emphasis> and <emphasis>vlc-mad</emphasis> from
the <ulink url="http://www.videolan.org/vlc/download.html">vlc download
page</ulink>.
</para>
<para>
......@@ -103,7 +95,7 @@ libdvdcss2-version.i586.rpm libdvdpsi1-version.i586.rpm</userinput>
<para>The method below is for any Unix system supported by the
VideoLAN Client,for which there is no packages available. It explains
how to compile and install vlc and the needed librairies from their
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
......@@ -128,8 +120,8 @@ files.</para></listitem>
<para>
Download the libraries from <ulink
url="http://www.videolan.org/pub/videolan/vlc/">http://www.videolan.org/pub/videolan/vlc</ulink> in the directory
<filename>version/contrib</filename>.
url="http://www.videolan.org/vlc/download-sources.html">VLC sources
download page</ulink>.
</para>
<para>For each library, uncompress, configure, compile and install :
......@@ -163,7 +155,7 @@ contains the following line :
<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.html">vlc download page</ulink>. Uncompress-it :
<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>
......@@ -171,26 +163,23 @@ Download the sources of the lastest release : get the file
<prompt>% </prompt><userinput>cd vlc-version</userinput>
</screen>
<!--
<para>For the vlc 0.5.0 version, do first :</para>
<screen>
<prompt>% </prompt><userinput>./bootstrap</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 "Modules" section of the VLC User Guide</para>
<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>Exemples of very simple configurations:</para>
<itemizedlist>
<listitem><para>if you want a basic vlc, do : </para>
<listitem><para>if you want a basic VLC, do : </para>
<screen>
<prompt>% </prompt><userinput>./configure</userinput>
</screen>
......@@ -205,13 +194,6 @@ interface (you will need the developement packages of Gnome) :</para>
</itemizedlist>
<!--
<para>
To compile and install the vlc 0.5.0 you must use the automake 1.5 or
higher version. The automake 1.6 is highly recommanded.
</para>
-->
<para>
Then, compile and install :
</para>
......
......@@ -186,7 +186,7 @@ url="http://www.videolan.org/doc/vlc-user-guide/">VLC user
guide</ulink>. This document is the complete guide for VLC.</para>
<listitem><para>the <ulink
url="http://www.videolan.org/doc/faq-vlc/faq/">VLC FAQ </ulink>. This
url="http://www.videolan.org/doc/faq-vlc/faq/">VLC FAQ</ulink>. This
document contains Frequently Asked Questions of VLC users.</para>
......
......@@ -4,19 +4,19 @@
<para>
VideoLAN can do much more than what is explained in this Quickstart.
For example, vls can stream from a satellite card, a digital
terrestial television card or an MPEG encoding card. To know
about the full streaming possibilities of VideoLAN, please read the <ulink
url="http://www.videolan.org/network/doc/videolan-howto.html">VideoLAN
HOWTO</ulink>.
For example, you can use VLS to stream digital satellite channels,
digital terrestial television channels and live videos. To know about
the full streaming possibilities of VideoLAN, please read the <ulink
url="http://www.videolan.org/doc/videolan-howto-old/videolan-howto.html"
>VideoLAN HOWTO</ulink>.
</para>
<para>
Vlc also have very interesting features that are not explained in
this Quickstart. For example, vlc can be used to do image walls !
To know about the full possibilities of vlc, please read the <ulink
url="http://www.videolan.org/doc/vlc-user-guide/">vlc user guide</ulink>.
VLC also have very interesting features that are not explained in
this Quickstart. For example, VLC can be used to do image walls !
To know about the full possibilities of VLC, please read the <ulink
url="http://www.videolan.org/doc/vlc-user-guide/">VLC user guide</ulink>.
</para>
......@@ -5,15 +5,13 @@
<!ENTITY intro SYSTEM "../common/intro.sgml">
<!ENTITY vlc SYSTEM "vlc.sgml">
<!ENTITY vls SYSTEM "vls.sgml">
<!ENTITY vlc-streamoutput SYSTEM "vlc-streamoutput.sgml">
<!ENTITY vod SYSTEM "vod.sgml">
<!ENTITY vlcs SYSTEM "vlcs.sgml">
<!ENTITY conclusion SYSTEM "conclusion.sgml">
<!ENTITY install-vlc SYSTEM "../common/install-vlc.sgml">
<!ENTITY install-vls SYSTEM "../common/install-vls.sgml">
<!ENTITY streamable-mpeg-file SYSTEM "../common/streamable-mpeg-file.sgml">
<!ENTITY install-vlcs SYSTEM "../common/install-vlcs.sgml">
<!ENTITY fdl SYSTEM "../common/fdl.sgml">
......@@ -95,7 +93,7 @@ Back-Cover Texts. The text of the license can be found the appendix
&intro;
&vlc;
&vls;
&vlc-streamoutput;
&vod;
&vlcs;
&conclusion;
......
......@@ -12,7 +12,7 @@
<para>
Start vlc : under Windows, Mac OS X or BeOS, double-clic on the icone and under Unix or Linux, use the command <command>vlc</command>.
Start VLC : under Windows, Mac OS X or BeOS, double-clic on the icone and under Unix or Linux, use the command <command>vlc</command>.
</para>
......@@ -59,13 +59,13 @@ yourself to the group :
<sect2><title>Troubleshooting</title>
<para>If vlc doesn't work for you, open the message window from the menu
<para>If VLC doesn't work for you, open the message window from the menu
<emphasis>View / Messages</emphasis> and try to spot an error message
that could explain your problem.</para>
<para>Then, read the <ulink
url="http://www.videolan.org/vlc/doc/FAQ">vlc FAQ</ulink> and have a
look at the <ulink url="http://bugzilla.videolan.org/">Buzilla</ulink>
url="http://www.videolan.org/doc/faq-vlc/faq/">vlc FAQ</ulink> and have a
look at the <ulink url="http://bugzilla.videolan.org/">Bugzilla</ulink>
to see if it is a known issue. </para>
<para>If you can't find out the problem, explain it in English in the
......
<chapter id="vls"><title id="tvls">The VideoLAN Server</title>
<sect1><title>Installing the VideoLAN Server</title>
&install-vls;
</sect1>
<sect1><title>Running the VideoLAN Server</title>
<sect2><title>Get a streamable MPEG file</title>
&streamable-mpeg-file;
<sect2><title>Unicast an MPEG file</title>
<simplesect><title>Start vls</title>
<itemizedlist>
<listitem><para>under Windows, open a command shell, go to the directory
where you installed vls and type :</para>
<screen>
<prompt>&gt; </prompt><userinput>vls -d udp:10.0.0.2 file:C:\films\presentation_short.vob</userinput>
</screen>
<para>where <filename>C:\films\presentation_short.vob</filename>
is the MPEG 1 or MPEG 2 file you want to stream and
<emphasis>10.0.0.2</emphasis> is the IP address of the machine you want
to stream to.</para>
<listitem><para>under Linux :</para>
<screen>
<prompt>% </prompt><userinput>vls -d udp:10.0.0.2 file:/mnt/films/presentation_short.vob</userinput>
</screen>
<para>where <filename>/mnt/films/presentation_short.vob</filename>
is the MPEG 1 or MPEG 2 file you want to stream and
<emphasis>10.0.0.2</emphasis> is the IP address of the machine you want
to stream to.</para>
</itemizedlist>
<simplesect><title>Start vlc</title>
<para>Launch vlc on the machine which receives the stream, then click on
the <emphasis>net</emphasis> button or select <emphasis>File / Network
stream</emphasis>, select <emphasis>UDP</emphasis>, keep the default
port and click on <emphasis>OK</emphasis>.</para>
<sect2><title>Unicast a DVD</title>
<simplesect><title>Start vls</title>
<note><para>For the moment, the Windows port of vls doesn't support DVD
streaming.</para></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>
<para>Then run vls using the following command line :</para>
<screen>
<prompt>% </prompt><userinput>vls -d udp:10.0.0.2 dvd:/dev/dvd</userinput>
</screen>
<para>where <filename>/dev/dvd</filename> is the device corresponding to
your DVD drive and <emphasis>10.0.0.2</emphasis> is the IP address of
the vlc you want to stream to.</para>
<simplesect><title>Start vlc</title>
<para>Use the same procedure as in the previous section.</para>
<sect2><title>Multicast to several VLC's</title>
<simplesect><title>What is multicast ?</title>
<para>Multicast is a norm implemented in all modern network hardware
(switches, routers, ...). It provides an intelligent manner to send a
stream to a dynamic group of machines. If you want to use multicast,
make sure that all your network hardware support it.</para>
<para>In multicast streaming, the stream is sent to a multicast IP
address (the IP addresses reserved for this purpose are from 224.0.0.0
to 239.255.255.255). Then, any machine on the network can join the
multicast group by sending a request on the network, and it will
automatically receive the stream. When it sends a request to leave the
group, it will automatically stop receiving the stream. The advantage of
multicast streaming is that only the machines that want to receive the
stream actually receive it, and the vls only sends one stream even if
there are multiple clients receiving it.</para>
<simplesect><title>Start vls</title>
<itemizedlist>
<listitem><para>under Windows, open a command shell, go to the directory
where you installed vls and type :</para>
<screen>
<prompt>&gt; </prompt><userinput>vls -d udp:239.255.12.42 file:C:\films\presentation_short.vob</userinput>
</screen>
<para>where <filename>C:\films\presentation_short.vob</filename>
is the MPEG 1 or MPEG 2 file you want to stream and
<emphasis>239.255.12.42</emphasis> is the multicast IP address you have
chosen.</para>
<listitem><para>under Linux :</para>
<screen>
<prompt>% </prompt><userinput>vls -d udp:239.255.12.42 file:/mnt/films/presentation_short.vob</userinput>
</screen>
<para>where <filename>/mnt/films/presentation_short.vob</filename>
is the MPEG 1 or MPEG 2 file you want to stream and
<emphasis>239.255.12.42</emphasis> is the multicast IP address you have
chosen.</para>
</itemizedlist>
<note><para>You can also multicast a DVD if vls is running under Linux :
replace <emphasis>file:/mnt/films/presentation_short.vob</emphasis> by
<command>dvd:/dev/dvd</command> where <filename>/dev/dvd</filename> is
the device corresponding to your DVD drive.</para></note>
<simplesect><title>Start vlc(s)</title>
<para>Launch vlc, then click on the <emphasis>net</emphasis> button or
select in the menu <emphasis>File / Network stream</emphasis>, select
<emphasis>UDP Multicast</emphasis>, type the multicast IP address and
click on <emphasis>OK</emphasis>.</para>
</sect2>
</sect1>
all: html ps pdf rtf
all: clean html ps pdf rtf
html:
rm -f *.html
......@@ -28,5 +28,8 @@ rtf:
sgmltools -b rtf -s ../common/stylesheet-print-noicones.dsl vlc-user-guide.sgml
zip vlc-user-guide-rtf.zip vlc-user-guide.rtf *.jpg
txt:
sgmltools -b txt vlc-user-guide.sgml
clean:
rm -f *.zip *.html *.pdf *.ps *.jpg
rm -f *.zip *.html *.pdf *.ps *.jpg *.txt
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