Commit 7bda3c2d authored by Alexis de Lattre's avatar Alexis de Lattre

Let's switch to the SAP announces !

parent 1b05d131
......@@ -218,7 +218,7 @@ the users :
on VLC,</para>
<listitem><para><emphasis>streaming@videolan.org</emphasis> for the questions
on VLS, mini-VLCS and the network.</para>
on VLS, mini-SAP-server and the network.</para>
</itemizedlist>
......
<chapter id="sap"><title id="tsap">Add a channel information service</title>
<para>Typing multicast addresses is not very fun... that's why you need
a channel information service ! VideoLAN has implemented a channel
information service based on the SAP/SDP standard. The mini-SAP-server
sends announces about the multicast programs on the network (via the
multicast address <emphasis>224.2.127.254</emphasis> reserved for this
purpose), and VLCs receive these annouces and automatically add the
programs announced to their playlist.</para>
<sect1><title>Install and configure the mini-SAP-server</title>
<note><para>The mini-SAP-server is only available for Linux.</para></note>
<para>Download the latest version of the mini-SAP-server from the <ulink
url="http://www.videolan.org/streaming/">streaming download
page</ulink>.</para>
<para>Install-it:</para>
<screen>
<prompt>% </prompt><userinput>tar xvzf miniSAPserver-version.tar.gz</userinput>
<prompt>% </prompt><userinput>cd miniSAPserver-version</userinput>
<prompt>% </prompt><userinput>make</userinput>
</screen>
<para>Edit the configuration file <filename>sap.cfg</filename>. It
should contain a global section with the Time To Live of the SAP
announces and a section per program announced. Use the comments to
understand each parameter.</para>
</sect1>
<sect1><title>Run the mini-SAP-server</title>
<para>Start the mini-SAP-server :</para>
<screen>
<prompt>% </prompt><userinput>./sapserver -c sap.cfg</userinput>
</screen>
</sect1>
<sect1><title>Configure VLC(s) to listen to the SAP announces</title>
<para>Start VLC with the following command line:</para>
<screen>
<prompt>% </prompt><userinput>vlc --extraintf sap</userinput>
</screen>
<para>Then open the playlist : you should see the programs announced.
When you double-click on the name of a program, VLC will subscribe to
the multicast address and start to play the stream !</para>
</sect1>
......@@ -12,7 +12,7 @@
<!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 sap SYSTEM "../common/sap.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">
......@@ -104,6 +104,6 @@ solution.</para>
&hardencoding;
&softencoding;
&vod;
&vlcs;
&sap;
&fdl;
</book>
<chapter id="vlcs"><title id="tvlcs">The Mini VideoLAN Channel Server</title>
</chapter>
......@@ -7,7 +7,7 @@
<!ENTITY vlc SYSTEM "vlc.sgml">
<!ENTITY vlc-streamoutput SYSTEM "vlc-streamoutput.sgml">
<!ENTITY vod SYSTEM "vod.sgml">
<!ENTITY vlcs SYSTEM "vlcs.sgml">
<!ENTITY sap SYSTEM "../common/sap.sgml">
<!ENTITY conclusion SYSTEM "conclusion.sgml">
......@@ -94,7 +94,7 @@ Back-Cover Texts. The text of the license can be found in the appendix
&vlc;
&vlc-streamoutput;
&vod;
&vlcs;
&sap;
&conclusion;
&fdl;
......
<chapter id="vlcs"><title id="tvlcs">Add a channel information service</title>
<para>Typing multicast addresses and URLs is not very fun... and that's
where a small program, the mini VideoLAN Channel Server (mini-VLCS),
is very useful. The mini VideoLAN Channel Server associate URLs or
multicast addresses to channels, like on a TV.</para>
<sect1><title>Installing mini-VLCS</title>
<note><para>Mini-VLCS is only available for Linux.</para></note>
<para>You don't have to change anything to vls or the Web server.
Mini-VLCS is independant from them, but is can be installed on the same
machine as vls or the Web server.</para>
<para>Download the latest version of mini-VLCS from the <ulink
url="http://www.videolan.org/network/download.html">network download
page</ulink>.</para>
<para>Install-it:</para>
<screen>
<prompt>% </prompt><userinput>tar xvzf miniVLCS-version.tar.gz</userinput>
<prompt>% </prompt><userinput>cd miniVLCS-version</userinput>
<prompt>% </prompt><userinput>make</userinput>
</screen>
<para>It creates an executable program named <command>vlcs</command>.</para>
</sect1>
<sect1><title>Configuring mini-VLCS</title>
<para>Edit the configuration file <filename>vlcs.conf</filename>. The
syntax rules of this configuration file are the following :</para>
<itemizedlist>
<listitem><para>the first line corresponds to channel 0, the second
line corresponds to channel 1, the third line to channel 2, and so
on...,</para></listitem>
<listitem><para>lines are considered raw data
and sent directly to the client (for example,
<emphasis>udp:@239.255.12.42</emphasis>),<para></listitem>
<listitem><para>lines beginning by <emphasis>I:</emphasis> are "dummy"
channel programs that tell VLC there is nothing in this channel (which
should be the case of channel 0).</para></listitem>
</itemizedlist>
<para>For exemple, if you want channels 1 and 2 to be two multicasted
streams and channels 3 and 4 to be two on-demand streams, your
<filename>vlcs.conf</filename> file will look like this :</para>
<programlisting>
I:nostream
udp:@239.255.12.42
udp:@239.255.12.43
http://vod.videolan.org/test/video1.mpg
http://vod.videolan.org/test/video2.mpg
</programlisting>
</sect1>
<sect1><title>Running mini-VLCS</title>
<para>Start mini-VLCS :</para>
<screen>
<prompt>% </prompt><userinput>./vlcs</userinput>
</screen>
<para>For production, you should run the program in a screen, so that
you can detach-it and reattach-it:</para>
<screen>
<prompt>% </prompt><userinput>screen ./vlcs</userinput>
</screen>
</sect1>
<sect1><title>Configure VLC(s) to use mini-VLCS</title>
<para>Launch VLC, click on the <emphasis>net</emphasis> button or
select in the menu <emphasis>File / Network stream</emphasis>, select
<emphasis>Channel Server</emphasis>, enter the DNS name or the IP
address of the machine hosting mini-VLCS and click on
<emphasis>OK</emphasis>.</para>
<para>Then, you see a new section <emphasis>Network Channel</emphasis>
on the interface. Select the channel of your choice and click on
<emphasis>Go!</emphasis>.</para>
</sect1>
......@@ -6,18 +6,16 @@
require("header.php3");
?>
<? function pkgitem($version,$name) { ?><li><a href="/pub/videolan/network/<? echo $version."/".$name; ?>"><code><? echo $name; ?></code></a></li><? } ?>
<? function pkgitem($version,$name) { ?><li><a href="/pub/videolan/vlcs/<? echo $version."/".$name; ?>"><code><? echo $name; ?></code></a></li><? } ?>
<h1> Mini-VLCS for Linux</h1>
<? h2("Tarball"); ?>
<p>Latest mini-vlcs tarball (0.2.0b):</p>
<ul>
<? pkgitem("0.2.0","miniVLCS-0.2.0b.tar.gz"); ?>
<li><a href="/pub/videolan/network/0.2.0/"><i>browse the list</i></a></li>
<li><a href="/pub/videolan/vlcs/0.2.0/"><i>browse the list</i></a></li>
</ul>
<? footer('$Id: download-vlcs.html,v 1.6 2003/04/08 20:18:51 karibu Exp $'); ?>
<? footer('$Id: download-vlcs.html,v 1.7 2003/04/25 22:30:07 alexis Exp $'); ?>
......@@ -64,11 +64,11 @@ digital terrestial television card or an MPEG-2 encoding card.</li>
</ul>
<p>You can add a channel information service to the VideoLAN solution
with the mini VideoLAN Channel Server (mini-VLCS). Mini-VLCS associate
multicast addresses and URLs to channels, like on a TV. If you install
it, the clients won't have to type multicast addresses and URLs by hand
any more, they will only need to give the DNS name of the mini-VLCS.</p>
<p>You can add a channel information service based on the SAP/SDP
standard to the VideoLAN solution. The mini-SAP-server sends announces
about the multicast programs on the network, and VLCs receive these
annouces and automatically add the programs announced to their
playlist.</p>
<? h2("Download"); ?>
......@@ -76,7 +76,7 @@ any more, they will only need to give the DNS name of the mini-VLCS.</p>
<li><p>To download VLC, go to the <a href="/vlc/index.html">VLC
download page</a>.</p></li>
<li><p>To download VLS, click on one of the icons below:</p>
<li><p>To download VLS and its required libraries, click on the icon below:</p>
<table cellspacing="10">
<tr>
......@@ -97,14 +97,14 @@ download page</a>.</p></li>
</li>
<li><p>To download mini-VLCS, get the source code:</p>
<li><p>To download the mini-SAP-server, click on the icon below:</p>
<table cellspacing="10">
<tr>
<td>
<a href="download-vlcs.html"><img src="/images/icons/source.gif"
<a href="download-sap-server.html"><img src="/images/icons/source.gif"
style="vertical-align: middle; border-width: 1px;"
alt="mini-VLCS source code" /></a>&nbsp;mini-VLCS source&nbsp;code
alt="mini-SAP-server source code" /></a>&nbsp;mini-SAP-server source&nbsp;code
</td>
</tr>
</table>
......@@ -149,4 +149,4 @@ download page</a>.</p></li>
</table>
<? footer('$Id: index.html,v 1.34 2003/04/25 13:19:08 alexis Exp $'); ?>
<? footer('$Id: index.html,v 1.35 2003/04/25 22:30:07 alexis Exp $'); ?>
......@@ -49,9 +49,9 @@ subscription or unsubscription.</p>
<code><b>videolan-announce@videolan.org</b></code>
(low-traffic and moderated announce list for VideoLAN releases and events)<br />
<input type="checkbox" name="vlc" />
<code><b>vlc@videolan.org</b></code> (user discussions about vlc)<br />
<code><b>vlc@videolan.org</b></code> (user discussions about VLC)<br />
<input type="checkbox" name="streaming" />
<code><b>streaming@videolan.org</b></code> (user discussions about the streaming solution: vls, vlms, mini-vlcs, the network...)<br />
<code><b>streaming@videolan.org</b></code> (user discussions about the streaming solution: VLS, mini-SAP-server, the network...)<br />
</p>
<p><input type="submit" name="subscribe" value="Subscribe" />
......@@ -70,4 +70,4 @@ the developers Web site.</p>
Experienced users can issue their commands to
<a href="mailto:ecartis@videolan.org">ecartis@videolan.org</a>.</p>
<? footer('$Id: lists.html,v 1.14 2003/04/17 19:12:10 sam Exp $'); ?>
<? footer('$Id: lists.html,v 1.15 2003/04/25 22:30:07 alexis Exp $'); ?>
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