<?xml version="1.0" encoding="UTF-8"?>
<chapter id="file"><title id="tfile">
Stream a file
</title>

<!-- Todo: improve, needs GUI -->

<sect1><title>
Stream a file with VLC
</title>

<screen>
<prompt>% </prompt><userinput>vlc -vvv video1.xyz --sout udp:192.168.0.42 --ttl 12</userinput>
</screen>

<para>
where:
</para>

<itemizedlist>

<listitem><para><filename>video1.xyz</filename>
 is the file you want to stream,</para></listitem>

<listitem><para><emphasis>192.168.0.42</emphasis>
 is either:
</para>

<itemizedlist>

<listitem><para>
the IP address of the machine you want to unicast
to;
</para></listitem>

<listitem><para>
or the DNS name the machine you want to unicast
to;
</para></listitem>

<listitem><para>
or a multicast IP address.
</para></listitem>

</itemizedlist>

</listitem>

<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></listitem>
</itemizedlist>

<para>
If you want to stream the file continuously, add the
<emphasis>--loop</emphasis> option.
</para>

</sect1>

</chapter>

