Move netstream documentation into TOOLS/README.

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@22951 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
diego 2007-04-09 11:54:03 +00:00
parent bf3fff69ca
commit b8dcfde2dc
2 changed files with 32 additions and 63 deletions

View File

@ -429,68 +429,6 @@ This works with all protocols supported by
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
<sect1 id="mpst" xreflabel="Remote streams">
<title>Remote streams</title>
<para>
Remote streams allow you to access most <application>MPlayer</application>
stream type from a remote host. The main purpose of this feature is to make
it possible to directly use the CD or DVD drive of another computer on the
network (provided you have the required bandwidth). On the downside some
stream type (currently TV and MF) are not usable remotely because they are
implemented at the demuxer level. It is sad for MF but TV stream would anyway
require an insane amount of bandwidth.
</para>
<!-- ********** -->
<sect2 id="compile_mpst_server">
<title>Compiling the server</title>
<para>
After having compiled <application>MPlayer</application> go to the
<filename>TOOLS/netstream</filename> directory and enter
<application>make</application> to build the server binary.
You can then copy the <application>netstream</application> binary
to the right place on your system (usually
<filename class="directory">/usr/local/bin</filename> on Linux).
</para>
</sect2>
<!-- ********** -->
<sect2 id="use_mpst">
<title>Using remote streams</title>
<para>
First you have to start the server on the computer you intend to remotely
access. Currently the server is very basic and does not have any commands
line arguments so just enter <filename>netstream</filename>. Now you can
for example play the second track of a VCD on the server with :
<screen>
mplayer -cache 5000 <replaceable>mpst://servername/vcd://2</replaceable>
</screen>
You can also access files on this server :
<screen>
mplayer -cache 5000 <replaceable>mpst://servername//usr/local/movies/lol.avi</replaceable>
</screen>
Note that paths which aren't starting with a / will be relative to
the directory where the server is running. The <option>-cache</option> option
is not needed but highly recommended.
</para>
<para>
Be aware that currently the server is not secure at all. So do not complain
about the numerous exploits which are possible through this. Instead send
some (good) patch to make it better or start writing your own server.
</para>
</sect2>
</sect1>
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
<sect1 id="edl" xreflabel="Edit Decision Lists (EDL)">
<title>Edit Decision Lists (EDL)</title>

View File

@ -11,7 +11,6 @@ encoding in three pass mode or creating SVCDs from a movie.
FIXME: Document the following tools:
bmovl-test
netstream
MPlayer scripts in the TOOLS dir
@ -517,3 +516,35 @@ Usage: - Set the path to the RealPlayer codecs directory in the C files.
- Put the wrappers in the RealPlayer codecs directory.
Notes: Known to work at least on Linux x86 with RealPlayer8.
netstream - access remote streams
---------------------------------
NOTE: netstream does not link at the moment - help welcome.
netstream allows you to access most MPlayer stream types from a remote host.
The main purpose of this feature is to make it possible to directly use the
CD or DVD drive of another computer on the network (provided you have the
required bandwidth). On the downside some stream types (currently TV and MF)
are not usable remotely because they are implemented at the demuxer level.
Be aware that currently the server is not secure at all.
Compile the server by running 'make netstream' and then copy the netstream
binary to the right place on your system (usually /usr/local/bin on Unix).
Start the netstream server on the computer you intend to access remotely.
There are no command line arguments.
Play the second track of a VCD on the server with:
mplayer -cache 5000 mpst://servername/vcd://2
Access files on this server with:
mplayer -cache 5000 mpst://servername//usr/local/movies/lol.avi
Note that paths which do not start with a / will be interpreted as relative to
the directory where the server is running. The '-cache' option is not needed
but highly recommended.