Commit 15c4b054 authored by Alexis de Lattre's avatar Alexis de Lattre

New architecture for the VideoLAN HOWTO. Comments are welcomed... and there is...

New architecture for the VideoLAN HOWTO. Comments are welcomed... and there is still a lot of work !

parent 8ca46b20
<chapter id="dvbs"><title id="tdvbs">Stream a digital satellite channel</title>
<sect1><title>Install the DVB drivers</title>
<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>Uncompress the tarball and follow the instructions written in
the <filename>INSTALL</filename> file to compile and install the
drivers.</para>
<sect1><title>Stream with VLS</title>
<para>[TODO]</para>
</sect1>
</chapter>
<chapter id="dvbt"><title id="tdvbt">Stream a digital terrestial channel</title>
<sect1><title>Install the DVB drivers</title>
<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>Uncompress the tarball and follow the instructions written in
the <filename>INSTALL</filename> file to compile and install the
drivers.</para>
<sect1><title>Stream with VLS</title>
<para>[TODO]</para>
</sect1>
</chapter>
<chapter id="dvd"><title id="tdvd">Stream a DVD</title>
<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>
<sect1><title>Stream a DVD with VLC</title>
<screen>
<prompt>% </prompt><userinput>vlc dvdold:/dev/dvd --sout udp://192.168.0.12 --ttl 12</userinput>
</screen>
<para>where :</para>
<itemizedlist>
<listitem><para><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,</para>
<listitem><para><emphasis>192.168.0.12</emphasis> is either :
<itemizedlist>
<listitem><para>the IP address of the machine you want to unicast to ;</para>
<listitem><para>or the DNS name the machine you want to unicast to ;</para>
<listitem><para>or the multicast IP address.</para>
</itemizedlist>
<listitem><para><emphasis>12</emphasis> is the value of the TTL (Time To
Live) of your IP packets (which means that the stream will be
able to cross 11 routers).</para>
</itemizedlist>
<para>If you want to stream the DVD continuously, add the
<emphasis>--loop</emphasis> option.</para>
<sect1><title>Stream a DVD with VLS</title>
<screen>
<prompt>% </prompt><userinput>vls -vv -d udp:192.168.0.12 dvd:/dev/dvd --ttl 12</userinput>
</screen>
<para>where :</para>
<itemizedlist>
<listitem><para><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,</para>
<listitem><para><emphasis>192.168.0.12</emphasis> is either :
<itemizedlist>
<listitem><para>the IP address of the machine you want to unicast to ;</para>
<listitem><para>or the DNS name the machine you want to unicast to ;</para>
<listitem><para>or the multicast IP address.</para>
</itemizedlist>
<listitem><para><emphasis>12</emphasis> is the value of the TTL (Time To
Live) of your IP packets (which means that the stream will be
able to cross 11 routers).</para>
</itemizedlist>
<para>If you want to stream the DVD continuously, add the
<emphasis>--loop</emphasis> option.</para>
</sect1>
</chapter>
<chapter id="file"><title id="tfile">Stream a file</title>
<sect1><title>Stream a file with VLC</title>
<screen>
<prompt>% </prompt><userinput>vlc /media/video/video1.avi --sout udp://192.168.0.12 --ttl 12</userinput>
</screen>
<para>where :</para>
<itemizedlist>
<listitem><para><filename>/media/video/video1.avi</filename> is the file
you want to stream,</para>
<listitem><para><emphasis>192.168.0.12</emphasis> is either :
<itemizedlist>
<listitem><para>the IP address of the machine you want to unicast to ;</para>
<listitem><para>or the DNS name the machine you want to unicast to ;</para>
<listitem><para>or the multicast IP address.</para>
</itemizedlist>
<listitem><para><emphasis>12</emphasis> is the value of the TTL (Time To
Live) of your IP packets (which means that the stream will be
able to cross 11 routers).</para>
</itemizedlist>
<para>If you want to stream the file continuously, add the
<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>
<screen>
<prompt>% </prompt><userinput>vls -vv -d udp:192.168.0.12 file:/media/video/video1.vob --ttl 12</userinput>
</screen>
<para>where :</para>
<itemizedlist>
<listitem><para><filename>/media/video/video1.vob</filename> is the file
you want to stream,</para>
<listitem><para><emphasis>192.168.0.12</emphasis> is either :
<itemizedlist>
<listitem><para>the IP address of the machine you want to unicast to ;</para>
<listitem><para>or the DNS name the machine you want to unicast to ;</para>
<listitem><para>or the multicast IP address.</para>
</itemizedlist>
<listitem><para><emphasis>12</emphasis> is the value of the TTL (Time To
Live) of your IP packets (which means that the stream will be
able to cross 11 routers).</para>
</itemizedlist>
<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, add the
<emphasis>--loop</emphasis> option.</para>
</sect1>
</chapter>
<chapter id="hardencoding"><title id="thardencoding">Stream from an MPEG encoding card</title>
<sect1><title>Install the drivers</title>
<para>If you want to be able to stream from a Kfir
card, you need to install its Linux drivers. Download
the latest release of the drivers from the <ulink
url="http://www.linuxtv.org/download/mpeg2/">drivers download
page</ulink> of the <ulink url="http://www.linuxtv.org/">LinuxTV</ulink>
Project.</para>
<para>Uncompress the tarball and follow the instructions written in
the <filename>README</filename> file to compile and install the
drivers.</para>
<note><para>If you have a VIA chipset, you need to disable USB in the
BIOS.</para></note>
<sect1><title>Stream with VLC</title>
<screen>
<prompt>% </prompt><userinput>vlc kfir:/dev/video --sout udp:192.168.0.12 --ttl 12</userinput>
</screen>
<para>where :</para>
<itemizedlist>
<listitem><para><filename>/dev/video</filename> is the device
corresponding to the Kfir card,</para>
<listitem><para><emphasis>192.168.0.12</emphasis> is either :
<itemizedlist>
<listitem><para>the IP address of the machine you want to unicast to ;</para>
<listitem><para>or the DNS name the machine you want to unicast to ;</para>
<listitem><para>or the multicast IP address.</para>
</itemizedlist>
<listitem><para><emphasis>12</emphasis> is the value of the TTL (Time To
Live) of your IP packets (which means that the stream will be
able to cross 11 routers).</para>
</itemizedlist>
</sect1>
<sect1><title>Stream with VLS</title>
<para>[TODO]</para>
</chapter>
<chapter id="install"><title id="tinstall">Install the required software and hardware</title>
<sect1><title>Install VLC</title>
&install-vlc;
</sect1>
<sect1><title>Install VLS</title>
&install-vls;
</sect1>
</chapter>
<chapter id="vlc"><title id="tvlc">Receive a stream with VLC</title>
<chapter id="receive"><title id="treceive">Receive a stream</title>
<sect1><title>Installing VLC</title>
<sect1><title>Receive a stream with VLC</title>
&install-vlc;
</sect1>
<sect1><title>Running VLC</title>
<sect2><title>Read 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>,
......@@ -22,7 +16,7 @@ keep the default port and click on <emphasis>OK</emphasis>.</para>
</sect2>
<sect2><title>Read 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
......@@ -40,6 +34,58 @@ address you want to join.</para>
</sect2>
<sect2><title>Receive an HTTP/FTP/MMS stream</title>
<para>Launch VLC, click on the <emphasis>Net</emphasis>
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>
<listitem>
<screen>
<prompt>% </prompt><userinput>vlc http://localserver/stream.ps</userinput>
</screen>
<para>where <emphasis>http://localserver/stream.ps</emphasis> is
the HTTP address of the stream ;</para>
</listitem>
<listitem>
<screen>
<prompt>% </prompt><userinput>vlc ftp://localserver/stream.ps</userinput>
</screen>
<para>where <emphasis>ftp://localserver/stream.ps</emphasis> is
the FTP address of the stream ;</para>
</listitem>
<listitem>
<screen>
<prompt>% </prompt><userinput>vlc mms://viptvr.yacast.fr/encoderfranceinfo</userinput>
</screen>
<para>where
<emphasis>mms://viptvr.yacast.fr/encoderfranceinfo</emphasis> is the MMS
address of the stream.</para>
</listitem>
</itemizedlist>
</sect2>
</sect1>
<sect1><title>Receive a stream with a Set Top Box</title>
<para>[TODO]</para>
</chapter>
<chapter id="softencoding"><title id="tsoftencoding">Stream from an acquisition card</title>
<sect1><title>Install the Video for Linux drivers</title>
<para>[TODO]</para>
<sect1><title>Stream with VLC</title>
<screen>
<prompt>% </prompt><userinput>vlc v4l:/dev/video:channel=0:frequency=8052:norm=secam:size=vga --sout udp:192.168.0.12 --ttl 12</userinput>
</screen>
<para>where :</para>
<itemizedlist>
<listitem><para><filename>/dev/video</filename> is the device
corresponding to your acquisition card,</para>
<listitem><para><emphasis>192.168.0.12</emphasis> is either :
<itemizedlist>
<listitem><para>the IP address of the machine you want to unicast to ;</para>
<listitem><para>or the DNS name the machine you want to unicast to ;</para>
<listitem><para>or the multicast IP address.</para>
</itemizedlist>
<listitem><para><emphasis>12</emphasis> is the value of the TTL (Time To
Live) of your IP packets (which means that the stream will be
able to cross 11 routers).</para>
</itemizedlist>
<para>[TODO : complete]</para>
</sect1>
<sect1><title>Stream with VLS</title>
<para>[TODO]</para>
</chapter>
......@@ -4,12 +4,16 @@
%magic-entities;
<!ENTITY intro SYSTEM "../common/intro.sgml">
<!ENTITY vlc SYSTEM "vlc.sgml">
<!ENTITY vlc-streamoutput SYSTEM "vlc-streamoutput.sgml">
<!ENTITY vls SYSTEM "vls.sgml">
<!ENTITY install SYSTEM "install.sgml">
<!ENTITY receive SYSTEM "receive.sgml">
<!ENTITY file SYSTEM "file.sgml">
<!ENTITY dvd SYSTEM "dvd.sgml">
<!ENTITY dvbs SYSTEM "dvbs.sgml">
<!ENTITY dvbt SYSTEM "dvbt.sgml">
<!ENTITY hardencoding SYSTEM "hardencoding.sgml">
<!ENTITY softencoding SYSTEM "softencoding.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">
......@@ -93,9 +97,14 @@ solution.</para>
<toc></toc>
&intro;
&vlc;
&vlc-streamoutput;
&vls;
&install;
&receive;
&file;
&dvd;
&dvbs;
&dvbt;
&hardencoding;
&softencoding;
&vod;
&vlcs;
&fdl;
......
<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="vls"><title id="tvls">Stream with VLS</title>
<sect1><title>Installing VLS</title>
&install-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).
<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>
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