[xiph-commits] r12631 - websites/icecast.org

moritz at svn.xiph.org moritz at svn.xiph.org
Sun Mar 4 11:47:58 PST 2007


Author: moritz
Date: 2007-03-04 11:47:56 -0800 (Sun, 04 Mar 2007)
New Revision: 12631

Modified:
   websites/icecast.org/ezstream.php
Log:
For an upcoming release of Ezstream 0.3.0, start work on its home page. This
change introduces a new structure and removes the old README-style docs.
Extensive documentation is now in the distribution's README, INSTALL and the new
man page.


Modified: websites/icecast.org/ezstream.php
===================================================================
--- websites/icecast.org/ezstream.php	2007-03-04 15:59:06 UTC (rev 12630)
+++ websites/icecast.org/ezstream.php	2007-03-04 19:47:56 UTC (rev 12631)
@@ -1,204 +1,135 @@
 <? include "common/header.php"; ?>
-<h2>ezstream</h2>
+<h2>Ezstream</h2>
+
 <div class="roundcont">
+
 <div class="roundtop">
 <img src="/images/corner_topleft.jpg" class="corner" style="display: none" />
 </div>
+
 <div class="newscontent">
-<h3>Download</h3>
-<br></br>
-<p>
-Version 0.2.1 is available at <a href="http://downloads.xiph.org/releases/ezstream/ezstream-0.2.1.tar.gz">ezstream-0.2.1.tar.gz</a>
-</p>
-<p>
-A windows binary is available as well at <a href="http://downloads.xiph.org/releases/ezstream/ezstream_win32_0.2.1_setup.exe">ezstream_win32_0.2.1_setup.exe</a>
-</p>
-<br></br>
-<h3>What is it ?</h3>
-<br></br>
-<p>
-ezstream is a command line utility which is a improved version of the old
-"shout" utility.  It enables you to stream mp3 or vorbis files to an icecast
-server without reencoding and thus requires very little CPU.  ezstream is
-controlled via a XML config file (a few examples are provided in the conf
-directory).
-</p>
-<p>
-ezstream can stream mp3 and ogg vorbis files as well as reading from stdin.
-ID3v1 tags are supported in mp3 files and all ogg vorbis tags are propagated
-as metadata as well.
-</p>
-<br><br>
-<h3>How to use it ?</h3>
-<br></br>
-<p>
-ezstream is XML config file based.  Configuration is done by editing the config
-file to suit your needs..The following is an example config file :
-</p>
-<p>
-&lt;ezstream&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;url&gt;http://localhost:8000/testmount.ogg&lt;/url&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;sourcepassword&gt;hackme&lt;/sourcepassword&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;format&gt;OGGVORBIS&lt;/format&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;filename&gt;sunking.ogg&lt;/filename&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfoname&gt;My Stream&lt;/svrinfoname&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfourl&gt;http://www.oddsock.org&lt;/svrinfourl&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfogenre&gt;RockNRoll&lt;/svrinfogenre&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfodescription&gt;This is a stream description&lt;/svrinfodescription&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfobitrate&gt;192&lt;/svrinfobitrate&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfoquality&gt;4.0&lt;/svrinfoquality&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfochannels&gt;2&lt;/svrinfochannels&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfosamplerate&gt;44100&lt;/svrinfosamplerate&gt;<br>
-	&nbsp;&nbsp;&nbsp;&lt;svrinfopublic&gt;1&lt;/svrinfopublic&gt;<br>
-&lt;/ezstream&gt;<br>
-</p>
-<p>
-<b>URL</b> - this URL specified the location and mountpoint of the icecast server to which the stream will be sent.
-</p>
-<p>
-<b>SOURCEPASSWORD </b>- the source password for the icecast server
-</p>
-<p>
-<b>FORMAT </b>- either MP3 or OGGVORBIS, you must specify which format you input files are in.
-</p>
-<p>
-<b>FILENAME </b>- This can be a single file (in which ezstream will stream that file over and over continuously) or can be a .m3u file which is a playlist of files.  currently, ezstream will go through the files sequentially.  If you specify "stdin" as the filename then ezstream will read the input from stdin.
-</p>
-<p>
-<b>SVRINFONAME </b>- Broadcast name (informational only)
-</p>
-<p>
-<b>SVRINFOURL </b>- Website associated with the broadcast (informational only)
-</p>
-<p>
-<b>SVRINFOGENRE </b>- Genre of broadcast (informational only) (used for YP)
-</p>
-<p>
-<b>SVRINFODESCRIPTION </b>- Description of broadcast (informational only) (used for YP)
-</p>
-<p>
-<b>SVRINFOBITRATE </b>- Bitrate of broadcast (informational only) (used for YP) It is YOUR responsibility to ensure that the bitrate specified here matches up with your input.  Note that this info is not for anything OTHER than YP listing info.
-</p>
-<p>
-<b>SVRINFOQUALITY </b>- Used only for OggVorbis streams, similar to the bitrate in that it is used only for informational and YP purposes.
-</p>
-<p>
-<b>SVRINFOCHANNELS </b>- 1 = MONO, 2 = STEREO (informational only) (used for YP)
-</p>
-<p>
-<b>SVRINFOSAMPLERATE </b>- (informational only) (used for YP)
-</p>
-<p>
-<b>SVRINFOPUBLIC </b>- Indicates wether to list this stream in a public YP.
-</p>
-<h3>Re-encoding</h3>
-<br></br>
-<p>
-ezstream now supports reencoding.  This means that your output stream need not
-be the same bitrate/samplerate or even format as your input files.
-</p>
-<p>    
-Reencoding is supported via the use of external programs.  When you enable reencoding
-you need to make sure of a few things :
-</p>
-<p>
-1. You define a "decoder" for each type of input file.<br>
-2. You define a "encoder" for each possible type of output stream.<br>
-</p>
 
-<p>
-So if you had a mixture of mp3 and vorbis files in your playlist, you will need to make
-sure that a decoder is provided for each type.  Ezstream will take the output of the
-decoder and send it directly to the specific encoder.  All output of the decoder should
-be written to stdout and should be in raw form.  Most decoder support this mode.  Encoders
-should all be configured also with raw input and should read it from stdin.
-</p>
+<h3>About Ezstream</h3>
 
 <p>
-The following decoder/encoders can be used : 
+ Ezstream is a command line source client for Icecast media streaming servers.
+ It began as the successor of the old "shout" utility, and has since gained
+ a lot of useful features.
 </p>
 
 <p>
-For MP3 :<br>
-decoder : madplay<br>
-encoder : lame<br>
+ In its basic mode of operation, it streams media files or data from standard
+ input without reencoding and thus requires only very little CPU resources.
+ It can also use various external decoders and encoders to reencode from one
+ format to another, and stream the result to an Icecast server.
+ With reencoding enabled, ezstream is a very flexible source client.
 </p>
 
 <p>
-For Vorbis :<br>
-decoder : oggdec<br>
-encoder : oggenc<br>
+ Supported media formats for streaming are MP3, Ogg Vorbis and Ogg Theora.
+ Metadata support is available for MP3 (ID3v1 only) and Ogg Vorbis.
 </p>
-<p>
-For FLAC :<br>
-decoder : FLAC<br>
-encoder : not yet supported by libshout, and thus not by ezstream.<br>
-</p>
 
 <p>
-Additional decoders and encoders may be used, as long as they follow the rules defined above.
+ Ezstream is free software and licensed under the GNU General Public License.
 </p>
-<p>
-The following config file section defines the reencoding parameters :
-</p>
 
+</div>
+<div class="roundbottom">
+<img src="/images/corner_bottomleft.jpg" class="corner" style="display: none" />
+</div>
+</div>
+
+<br/>
+
+<div class="roundcont">
+<div class="roundtop">
+<img src="/images/corner_topleft.jpg" class="corner" style="display: none" />
+</div>
+<div class="newscontent">
+
+<h3>Download</h3>
+
+<center>
+ <table border=1 cellpadding=5 cellspacing=0 width=90% bordercolor="#000000">
+  <tr>
+   <td><b>Package</b></td><td><b>Download Link</b></td>
+  </tr>
+  <tr>
+   <td>
+    Source .tar.gz (all platforms)
+   </td>
+   <td>
+    <a href="http://downloads.xiph.org/releases/ezstream/ezstream-0.2.1.tar.gz">ezstream-0.2.1.tar.gz</a>
+   </td>
+  </tr>
+  <tr>
+   <td>
+    Windows NT/2000/XP binary
+   </td>
+   <td>
+    <a href="http://downloads.xiph.org/releases/ezstream/ezstream_win32_0.2.1_setup.exe">ezstream_win32_0.2.1_setup.exe</a>
+   </td>
+  </tr>
+ </table>
+</center>
+
 <p>
-<pre>
-&lt;reencode&gt;
-        &lt;enable&gt;1&lt;/enable&gt;
-        &lt;encdec&gt;
-        &lt;!-- Support for FLAC decoding (input files) --&gt;
-                &lt;format&gt;FLAC&lt;/format&gt; &lt;!-- format = output stream format --&gt;
-                &lt;match&gt;.flac&lt;/match&gt;  &lt;!-- match = input file format --&gt;
-                &lt;decode&gt;flac -s -d --force-raw-format --sign=signed 
-                              --endian=little @T@ -o -&lt;/decode&gt;
-                &lt;encode&gt;Not supported Yet&lt;/encode&gt;
-        &lt;/encdec&gt;
-        &lt;encdec&gt;
-        &lt;!-- Support for MP3 decoding via madplay, and encoding via LAME --&gt;
-                &lt;format&gt;MP3&lt;/format&gt;
-                &lt;match&gt;.mp3&lt;/match&gt;
-                &lt;decode&gt;madplay -o raw:- @T@ 2&gt;/dev/null&lt;/decode&gt;
-                &lt;encode&gt;lame -r -x -b 56 -s 44.1 --resample 22.05 -a - - 
-                              2&gt;/dev/null&lt;/encode&gt;
-        &lt;/encdec&gt;
-        &lt;encdec&gt;
-        &lt;!-- Support for Vorbis decoding via oggdec, and encoding via oggenc --&gt;
-                &lt;format&gt;VORBIS&lt;/format&gt;
-                &lt;match&gt;.ogg&lt;/match&gt;
-                &lt;decode&gt;oggdec --raw=1 @T@ -o - 2&gt;/dev/null&lt;/decode&gt;
-                &lt;encode&gt;oggenc -Q -r -q 0 --resample=44100 --downmix 
-                              -t "@M@" -c STREAMER=ezstream -&lt;/encode&gt;
-        &lt;/encdec&gt;
-&lt;/reencode&gt;
-</pre>
+ Older releases can be found at
+ <a href="http://downloads.xiph.org/releases/ezstream/">http://downloads.xiph.org/releases/ezstream/</a>.
 </p>
-<p>
-Note that the following keywords can be used :
-</p>
 
+</div>
+<div class="roundbottom">
+<img src="/images/corner_bottomleft.jpg" class="corner" style="display: none" />
+</div>
+</div>
+
+<br/>
+
+<div class="roundcont">
+<div class="roundtop">
+<img src="/images/corner_topleft.jpg" class="corner" style="display: none" />
+</div>
+<div class="newscontent">
+
+<h3>Prerequisites and Installation</h3>
+
 <p>
- at T@ = The fully qualified name of the track being played in the playlist<br>
- at M@ = The metadata for the current track<br>
+ Ezstream depends on:
 </p>
 
+<ul>
+ <li>
+  libshout 2.2.x
+  (<a href="http://www.icecast.org/download.php">http://www.icecast.org/download.php</a>)
+ </li>
+ <li>
+  Dependencies of libshout, such as libogg, libvorbis, libtheora, etc.
+  (<a href="http://www.vorbis.com/">http://www.vorbis.com/</a> and
+  <a href="http://www.theora.org/">http://www.theora.org/</a>)
+ </li>
+ <li>
+  libxml 2.x
+  (<a href="http://xmlsoft.org">http://xmlsoft.org</a>)
+ </li>
+</ul>
+
 <p>
-All encoding options (bitrate/samplerate/channels/quality) are set as command line options of
-each of the encoders.  Each encoder has slightly different options that control these values.
-The examples here can be used as a guide, but please make sure you check the manual for each
-encoder for the correct encoding options.  In all cases, the encoder should be configured to
-read RAW audio data from stdin.
+ On UNIX and UNIX-like systems, such as Linux and *BSD, binary packages for the
+ required libraries are usually available.
+ To compile ezstream, ensure that the respective <em>-devel</em> packages are
+ installed as well, if applicable.
+ Further steps are explained in the <em>README</em> and <em>INSTALL</em> files
+ inside the distribution package.
 </p>
 
-
 </div>
 <div class="roundbottom">
 <img src="/images/corner_bottomleft.jpg" class="corner" style="display: none" />
 </div>
 </div>
-<br><br>
 
-<br><br>
-<? include "common/footer.php"; ?>
+<br/>
 
-
+<? include "common/footer.php"; ?>



More information about the commits mailing list