Commit a3096469 authored by Alexis de Lattre's avatar Alexis de Lattre

Makefile : RAHH, il ne faut pas donner le même nom à la target et au

sous-répertoire, sinon il dit que c'est "à jour" et ne fait rien.

Nouvelle politique pour la doc : on ne parle plus des interfaces mais
seulement de la ligne de commande. Et on met "-vvv" partout, pour que
les gens aient le reflexe de regarder les logs.
parent c5e04d4a
...@@ -267,14 +267,7 @@ under Windows 95 / 98 / ME.</para> ...@@ -267,14 +267,7 @@ under Windows 95 / 98 / ME.</para>
</figure> </figure>
<note><para>Under Windows, you need to be in the directory where the <note><para>Under Windows, you need to be in the directory where the
program is installed to run it ; for this use the <command>cd</command> program is installed to run it.</para></note>
instruction, for example :</para>
<screen>
<prompt>% </prompt><userinput>cd C:\Program Files\VLC</userinput>
</screen>
</note>
<simplesect><title>under Linux or Unix</title> <simplesect><title>under Linux or Unix</title>
...@@ -323,17 +316,23 @@ folder <emphasis>Utilities</emphasis> and double-click on ...@@ -323,17 +316,23 @@ folder <emphasis>Utilities</emphasis> and double-click on
</mediaobject> </mediaobject>
</figure> </figure>
<note><para>Under Mac OS X, you need to be in the directory where the <note><para>Under Mac OS X, you need to be in the directory where
program is installed to run it ; for this use the <command>cd</command> the program is installed to run it, and start the command with
instruction, for example :</para> <command>./</command> .</para></note>
<screen>
<prompt>% </prompt><userinput>cd /Applications/VLC.app/Contents/MacOS/VLC</userinput>
</screen>
</note>
<simplesect><title>under BeOS</title> <simplesect><title>under BeOS</title>
<para>[TODO]</para> <para>In the deskbar, go to <emphasis>Application</emphasis> and then
<emphasis>Terminal</emphasis> :</para>
<figure><title>BeOS terminal</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/terminal-beos.&magic;" format="&magic;" scalefit="1" scale="60">
</imageobject>
</mediaobject>
</figure>
<note><para>Under BeOS, you need to be in the directory where
the program is installed to run it, and start the command with
<command>./</command>.</para></note>
...@@ -54,9 +54,7 @@ your config file is <filename>/etc/sap.cfg</filename>.</para> ...@@ -54,9 +54,7 @@ your config file is <filename>/etc/sap.cfg</filename>.</para>
</sect1> </sect1>
<sect1><title>Configure VLC(s) to listen to the SAP announces</title> <sect1><title>Start VLC(s) on the client(s)</title>
<para>Start VLC with the following command line:</para>
<screen> <screen>
<prompt>% </prompt><userinput>vlc --extraintf sap</userinput> <prompt>% </prompt><userinput>vlc --extraintf sap</userinput>
......
...@@ -3,10 +3,10 @@ ...@@ -3,10 +3,10 @@
DOC := videolan-howto DOC := videolan-howto
# We build HTML, PS, PDF, RTF and TXT for the Web site # We build HTML, PS, PDF, RTF and TXT for the Web site
all: images html ps pdf rtf txt all: img html ps pdf rtf txt
# Get the images from the /images/documentation directory # Get the images from the /images/documentation directory
images: img:
rm -rf images rm -rf images
cp -R ../../images/documentation images cp -R ../../images/documentation images
......
...@@ -21,17 +21,17 @@ yourself to the group : ...@@ -21,17 +21,17 @@ yourself to the group :
<sect1><title>Stream a DVD with VLC</title> <sect1><title>Stream a DVD with VLC</title>
<screen> <screen>
<prompt>% </prompt><userinput>vlc dvdold:/dev/dvd --sout udp://192.168.0.12 --ttl 12</userinput> <prompt>% </prompt><userinput>vlc -vvv dvdold:/dev/dvd --sout udp://192.168.0.12 --ttl 12</userinput>
</screen> </screen>
<para>where :</para> <para>where :</para>
<itemizedlist> <itemizedlist>
<listitem><para><filename>/dev/dvd</filename> is the device <listitem><para><filename>/dev/dvd</filename> is the name of
corresponding to your DVD drive (put <filename>D:</filename> under your DVD drive (put <filename>D:</filename> under Windows if
Windows if <filename>D</filename> is the letter of your DVD drive) or <filename>D</filename> is the letter of your DVD drive) or the directory
the directory where you copied your DVD,</para> where you copied your DVD,</para>
<listitem><para><emphasis>192.168.0.12</emphasis> is either : <listitem><para><emphasis>192.168.0.12</emphasis> is either :
......
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
<sect1><title>Stream a file with VLC</title> <sect1><title>Stream a file with VLC</title>
<screen> <screen>
<prompt>% </prompt><userinput>vlc /media/video/video1.avi --sout udp://192.168.0.42 --ttl 12</userinput> <prompt>% </prompt><userinput>vlc -vvv /media/video/video1.avi --sout udp://192.168.0.42 --ttl 12</userinput>
</screen> </screen>
<para>where :</para> <para>where :</para>
...@@ -29,15 +29,9 @@ able to cross 11 routers).</para> ...@@ -29,15 +29,9 @@ able to cross 11 routers).</para>
</itemizedlist> </itemizedlist>
<para>If you want to stream the file continuously, add the <para>If you want to stream the file continuously, add the
<emphasis>--loop</emphasis> option.</para> <emphasis>--loop</emphasis> option.</para>
<note><para>Under Windows, make sure that you are in the same directory
as the VLC install directory.</para></note>
<sect1><title>Stream a file with VLS</title> <sect1><title>Stream a file with VLS</title>
......
...@@ -23,7 +23,7 @@ BIOS.</para></note> ...@@ -23,7 +23,7 @@ BIOS.</para></note>
<sect1><title>Stream with VLC</title> <sect1><title>Stream with VLC</title>
<screen> <screen>
<prompt>% </prompt><userinput>vlc kfir:/dev/video --sout udp:192.168.0.42 --ttl 12</userinput> <prompt>% </prompt><userinput>vlc -vvv kfir:/dev/video --sout udp:192.168.0.42 --ttl 12</userinput>
</screen> </screen>
<para>where :</para> <para>where :</para>
......
...@@ -4,29 +4,16 @@ ...@@ -4,29 +4,16 @@
<sect2><title>Receive an unicast stream</title> <sect2><title>Receive 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> <screen>
<prompt>% </prompt><userinput>vlc udp:</userinput> <prompt>% </prompt><userinput>vlc -vvv udp:</userinput>
</screen> </screen>
</sect2> </sect2>
<sect2><title>Receive a multicast stream</title> <sect2><title>Receive 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> <screen>
<prompt>% </prompt><userinput>vlc udp:@239.255.12.42</userinput> <prompt>% </prompt><userinput>vlc -vvv udp:@239.255.12.42</userinput>
</screen> </screen>
<para>where <emphasis>239.255.12.42</emphasis> is the multicast IP <para>where <emphasis>239.255.12.42</emphasis> is the multicast IP
...@@ -36,18 +23,14 @@ address you want to join.</para> ...@@ -36,18 +23,14 @@ address you want to join.</para>
<sect2><title>Receive an HTTP/FTP/MMS stream</title> <sect2><title>Receive an HTTP/FTP/MMS stream</title>
<para>Launch VLC, click on the <emphasis>Net</emphasis> <para>Use one of the following command lines :</para>
button, select <emphasis>HTTP/FTP/MMS</emphasis>, type
the URL and click on <emphasis>OK</emphasis>.</para>
<para>You can also use the following command line :</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<screen> <screen>
<prompt>% </prompt><userinput>vlc http://localserver/stream.ps</userinput> <prompt>% </prompt><userinput>vlc -vvv http://localserver/stream.ps</userinput>
</screen> </screen>
<para>where <emphasis>http://localserver/stream.ps</emphasis> is <para>where <emphasis>http://localserver/stream.ps</emphasis> is
...@@ -58,7 +41,7 @@ the HTTP address of the stream ;</para> ...@@ -58,7 +41,7 @@ the HTTP address of the stream ;</para>
<listitem> <listitem>
<screen> <screen>
<prompt>% </prompt><userinput>vlc ftp://localserver/stream.ps</userinput> <prompt>% </prompt><userinput>vlc -vvv ftp://localserver/stream.ps</userinput>
</screen> </screen>
<para>where <emphasis>ftp://localserver/stream.ps</emphasis> is <para>where <emphasis>ftp://localserver/stream.ps</emphasis> is
...@@ -69,7 +52,7 @@ the FTP address of the stream ;</para> ...@@ -69,7 +52,7 @@ the FTP address of the stream ;</para>
<listitem> <listitem>
<screen> <screen>
<prompt>% </prompt><userinput>vlc mms://viptvr.yacast.fr/encoderfranceinfo</userinput> <prompt>% </prompt><userinput>vlc -vvv mms://viptvr.yacast.fr/encoderfranceinfo</userinput>
</screen> </screen>
<para>where <para>where
......
...@@ -25,7 +25,7 @@ and you must specify <command>--enable-v4l</command> to ...@@ -25,7 +25,7 @@ and you must specify <command>--enable-v4l</command> to
<screen> <screen>
<!-- We cut the lines when they are too long, so that it looks OK in PDF format ! --> <!-- We cut the lines when they are too long, so that it looks OK in PDF format ! -->
<prompt>% </prompt><userinput>vlc v4l:/dev/video:norm=secam:frequency=8692:size=640x480:channel=0:adev=/dev/dsp:audio=0 <prompt>% </prompt><userinput>vlc -vvv v4l:/dev/video:norm=secam:frequency=8692:size=640x480:channel=0:adev=/dev/dsp:audio=0
--sout '#transcode{vcodec=mp4v,ab=256,vb=3000,vt=800000,keyint=80,acodec=mpga} --sout '#transcode{vcodec=mp4v,ab=256,vb=3000,vt=800000,keyint=80,acodec=mpga}
:std{access=udp,mux=ts,url=239.255.12.13}' --ttl 12</userinput> :std{access=udp,mux=ts,url=239.255.12.13}' --ttl 12</userinput>
</screen> </screen>
......
...@@ -3,10 +3,10 @@ ...@@ -3,10 +3,10 @@
DOC := videolan-quickstart DOC := videolan-quickstart
# We build HTML, PS, PDF, RTF and TXT for the Web site # We build HTML, PS, PDF, RTF and TXT for the Web site
all: images html ps pdf rtf txt all: img html ps pdf rtf txt
# Get the images from the /images/documentation directory # Get the images from the /images/documentation directory
images: img:
rm -rf images rm -rf images
cp -R ../../images/documentation images cp -R ../../images/documentation images
......
...@@ -5,10 +5,8 @@ ...@@ -5,10 +5,8 @@
<simplesect><title>Start VLC on the server</title> <simplesect><title>Start VLC on the server</title>
<para>Open a terminal and type :</para>
<screen> <screen>
<prompt>% </prompt><userinput>vlc /media/video/video1.avi --sout udp://client.example.org</userinput> <prompt>% </prompt><userinput>vlc -vvv /media/video/video1.avi --sout udp://client.example.org</userinput>
</screen> </screen>
<para>where <filename>/media/video/video1.avi</filename> is the file <para>where <filename>/media/video/video1.avi</filename> is the file
...@@ -16,32 +14,25 @@ you want to stream and <emphasis>client.example.org</emphasis> is the ...@@ -16,32 +14,25 @@ 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 DNS name of the client you want to stream to (you can put an IP address
instead).</para> instead).</para>
<note><para>Under Windows, make sure that you are in the same directory
as the VLC install directory.</para></note>
<simplesect><title>Start VLC on the client</title> <simplesect><title>Start VLC on the client</title>
<para>Launch VLC on the machine which receives the stream and click on <screen>
the <emphasis>Net</emphasis> button. Then select <emphasis>UDP</emphasis>, <prompt>% </prompt><userinput>vlc -vvv udp:</userinput>
keep the default port and click on <emphasis>OK</emphasis>.</para> </screen>
<sect1><title>Unicast a DVD</title> <sect1><title>Unicast a DVD</title>
<simplesect><title>Start VLC on the server</title> <simplesect><title>Start VLC on the server</title>
<para>Open a terminal and type :</para>
<screen> <screen>
<prompt>% </prompt><userinput>vlc dvdold:/dev/dvd --sout udp://client.example.org</userinput> <prompt>% </prompt><userinput>vlc -vvv dvdold:/dev/dvd --sout udp://client.example.org</userinput>
</screen> </screen>
<para>where <filename>/dev/dvd</filename> is the device corresponding <para>where <filename>/dev/dvd</filename> is the name of your DVD drive
to your DVD drive (put <filename>D:</filename> under Windows if (put <filename>D:</filename> under Windows if <filename>D</filename> is
<filename>D</filename> is the letter of your DVD drive) or the directory the letter of your DVD drive) or the directory where you copied your
where you copied your DVD, and <emphasis>client.example.org</emphasis> DVD, and <emphasis>client.example.org</emphasis> is the DNS name of the
is the DNS name of the client you want to stream to (you can put an IP client you want to stream to (you can put an IP address instead).</para>
address instead).</para>
<note> <note>
<para> <para>
...@@ -64,7 +55,9 @@ yourself to the group : ...@@ -64,7 +55,9 @@ yourself to the group :
<simplesect><title>Start VLC on the client</title> <simplesect><title>Start VLC on the client</title>
<para>Use the same procedure as in the previous section.</para> <screen>
<prompt>% </prompt><userinput>vlc -vvv udp:</userinput>
</screen>
<sect1><title>Multicast to several VLC's</title> <sect1><title>Multicast to several VLC's</title>
...@@ -87,10 +80,8 @@ stream even if there are multiple clients receiving it.</para> ...@@ -87,10 +80,8 @@ stream even if there are multiple clients receiving it.</para>
<simplesect><title>Start VLC on the server</title> <simplesect><title>Start VLC on the server</title>
<para>Open a terminal and type :</para>
<screen> <screen>
<prompt>% </prompt><userinput>vlc /media/video/video1.avi --sout udp://239.255.12.42 --ttl 12</userinput> <prompt>% </prompt><userinput>vlc -vvv /media/video/video1.avi --sout udp://239.255.12.42 --ttl 12</userinput>
</screen> </screen>
<para>where <filename>/media/video/video1.avi</filename> is the file you <para>where <filename>/media/video/video1.avi</filename> is the file you
...@@ -102,12 +93,10 @@ value of the TTL (Time To Live) of your IP packets (which means that the ...@@ -102,12 +93,10 @@ 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> multicast stream will be able to cross 11 routers).</para>
<simplesect><title>Start VLC(s) on the client(s)</title>
<simplesect><title>Start VLC(s) on the clients</title> <screen>
<prompt>% </prompt><userinput>vlc -vvv udp:@239.255.12.42</userinput>
<para>Launch VLC and click on the <emphasis>Net</emphasis> </screen>
button. Then select <emphasis>UDP Multicast</emphasis>, type
the multicast IP address, keep the default port and click on
<emphasis>OK</emphasis>.</para>
</sect1> </sect1>
...@@ -10,32 +10,24 @@ ...@@ -10,32 +10,24 @@
<sect2><title>Read a File</title> <sect2><title>Read a File</title>
<para> <screen>
<prompt>% </prompt><userinput>vlc -vvv video.avi</userinput>
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>. </screen>
</para>
<para>
To read an MPEG-1 MPEG-2 or MPEG-4 / DivX file stored on a hard drive
or a CD-ROM, click on the <emphasis>File</emphasis> icon or select in the
menu <emphasis>File / Open file</emphasis> and select the file you want
to play.
</para> <para>where <filename>video.avi</filename> is the name of the file you
want to play.</para>
</sect2> </sect2>
<sect2><title>Read a DVD</title> <sect2><title>Read a DVD or a VCD</title>
<para>
To read a DVD or a VCD, click on the <emphasis>disc</emphasis> icon or <screen>
select in the menu <emphasis>File / Open disk</emphasis> and enter the <prompt>% </prompt><userinput>vlc -vvv dvd:/dev/dvd</userinput>
device name of your DVD drive. </screen>
</para> <para>where <filename>/dev/dvd</filename> is the name of your drive (put
<filename>D:</filename> under Windows if <filename>D</filename> is the
letter of your DVD drive).</para>
<note><para> <note><para>
...@@ -59,9 +51,8 @@ yourself to the group : ...@@ -59,9 +51,8 @@ yourself to the group :
<sect2><title>Troubleshooting</title> <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, try to spot an error message
<emphasis>View / Messages</emphasis> and try to spot an error message in the logs that are printed in the terminal.</para>
that could explain your problem.</para>
<para>Then, read the <ulink <para>Then, read the <ulink
url="http://www.videolan.org/doc/faq-vlc/faq/">vlc FAQ</ulink> and have a url="http://www.videolan.org/doc/faq-vlc/faq/">vlc FAQ</ulink> and have a
......
...@@ -2,26 +2,21 @@ ...@@ -2,26 +2,21 @@
<sect1><title>Overview</title> <sect1><title>Overview</title>
<para> <para>With Video On Demand (VOD), the user can start the video when he
With Video On Demand (VOD), the user can start the video when he
wants, make pauses, go forward and back in the video. It is of course wants, make pauses, go forward and back in the video. It is of course
the best in video streaming and the dream for every user. the best in video streaming and the dream for every user.</para>
</para>
<para>VOD is a very big consumer of resources for the server and the
<para> network. VOD is unicast, not multicast : this means that the network
VOD is a very big consumer of resources for the server and the and server resources needed are directly proportional to the number of
network. VOD is unicast, not multicast : this means that the network and clients.</para>
server resources needed are directly proportional to the number of
clients. <para>The design of VideoLAN's VOD solution is very simple. The idea
</para> is to do HTTP streaming, i.e. stream an MPEG video encapsulated in
HTTP. The regulation of the bitrate between the client and the server
<para> is done automatically by TCP. With HTTP version 1.1, there is the
The design of VideoLAN's VOD solution is very simple. The idea is to possibility to seek in a file downloaded, that's what we use to seek in
do HTTP streaming, i.e. stream an MPEG video encapsulated in HTTP. The the video.</para>
regulation of the bitrate between the client and the server is done
automatically by TCP. With HTTP version 1.1, there is the possibility to
seek in a file downloaded, that's what we use to seek in the video.
</para>
<sect1><title>On the server side</title> <sect1><title>On the server side</title>
...@@ -32,30 +27,18 @@ and other Web servers should work too, but we have never tested.</para> ...@@ -32,30 +27,18 @@ and other Web servers should work too, but we have never tested.</para>
<para>Make your MPEG-1, MPEG-2 or MPEG-4 / DivX files available to the <para>Make your MPEG-1, MPEG-2 or MPEG-4 / DivX files available to the
clients on the Web server. </para> clients on the Web server. </para>
<para> <para>For example, we have a Web server whose DNS name
is <emphasis>localserver</emphasis>. On this server,
For example, we have a Web server whose DNS name is
<emphasis>localserver</emphasis>. On this server,
we put an MPEG file <filename>video1.mpg</filename> we put an MPEG file <filename>video1.mpg</filename>
which will be available to the clients at the URL which will be available to the clients at the URL
<filename>http://localserver/test/video1.mpg</filename>. <filename>http://localserver/test/video1.mpg</filename>.</para>
</para>
<sect1><title>On the client side</title> <sect1><title>On the client side</title>
<para> <screen>
<prompt>% </prompt><userinput>vlc -vvv http://localserver/test/video1.mpg</userinput>
Launch VLC, then click on the <emphasis>Net</emphasis> </screen>
button or select in the menu <emphasis>File / Network
stream</emphasis>, select <emphasis>HTTP</emphasis> and type the URL
<filename>http://localserver/test/video1.mpg</filename>.
</para>
<para>
VLC starts to read the stream nearly immediately and you can seek in the
stream, make pauses, etc... as if the stream was a local file.
</para> <para>VLC starts to read the stream nearly immediately and you can
seek in the stream, make pauses, etc... as if the stream was a local
file.</para>
...@@ -3,10 +3,10 @@ ...@@ -3,10 +3,10 @@
DOC := vlc-user-guide DOC := vlc-user-guide
# We build HTML, PS, PDF, RTF and TXT for the Web site # We build HTML, PS, PDF, RTF and TXT for the Web site
all: images html ps pdf rtf txt all: img html ps pdf rtf txt
# Get the images from the /images/documentation directory # Get the images from the /images/documentation directory
images: img:
rm -rf images rm -rf images
cp -R ../../images/documentation images cp -R ../../images/documentation images
......
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