Install disorderd under launchd in Mac OS X.

[disorder] / README.streams

diff --git a/README.streams b/README.streams
index 4e6e42510fb8f2e199ea0b8978ccdbf26c929e64..82226d6b6f15cd1874897b1e3624f07775e2c9d2 100644 (file)
--- a/README.streams
+++ b/README.streams
@@ -1,5 +1,5 @@
-DisOrder and Internet Streams
-=============================
+DisOrder and Republishing Internet Streams
+==========================================

 
 DisOrder doesn't have any built-in support for playing streams but you can make
 it do so.  I use the following in my configuration file:
 
 DisOrder doesn't have any built-in support for playing streams but you can make
 it do so.  I use the following in my configuration file:


@@ -25,8 +25,72 @@ You can then queue a stream like any other track.  It won't automatically
 interrupt the playing track, you have to scratch it manually.  Go back to
 normal play by scratching the stream.
 
 interrupt the playing track, you have to scratch it manually.  Go back to
 normal play by scratching the stream.
 

+
+Creating A Stream Of DisOrder Output
+====================================
+
+This can be achieved using the speaker_command option and Icecast (see
+http://www.icecast.org/).  It will only work if you use the speaker process,
+i.e. execraw for everything.
+
+I used:
+
+  speaker_command "ices2 /etc/disorder/ices.xml"
+
+where ices.xml is:
+
+  <?xml version="1.0"?>
+  <ices>
+      <background>0</background>
+      <logpath>/var/log/ices</logpath>
+      <logfile>disorder.log</logfile>
+      <loglevel>4</loglevel>
+      <consolelog>0</consolelog>
+      <stream>
+         <metadata>
+             <name>lyonesse</name>
+             <genre>Various</genre>
+             <description>lyonesse disorder output</description>
+         </metadata>
+         <input>
+             <module>stdinpcm</module>
+             <param name="rate">44100</param>
+             <param name="channels">2</param>
+             <param name="metadata">1</param>
+             <param name="metadatafilename">/var/disorder/icedata</param>
+         </input>
+         <instance>
+             <hostname>lyonesse.anjou.terraraq.org.uk</hostname>
+             <port>8000</port>
+             <password>SOURCE PASSWORD HERE</password>
+             <mount>/disorder.ogg</mount>
+             <reconnectdelay>2</reconnectdelay>
+             <reconnectattempts>5</reconnectattempts>
+             <maxqueuelength>80</maxqueuelength>
+             <encode>
+                 <nominal-bitrate>64000</nominal-bitrate>
+                 <samplerate>44100</samplerate>
+                 <channels>2</channels>
+                 <flush-samples>8820</flush-samples>
+             </encode>
+         </instance>
+
+         </stream>
+  </ices>
+
+This doesn't seem to get on very well with pausing but you're unlikely to want
+to pause a stream in any case.  I used IceCast 2.3.1 and Ices 2.0.1.  You can
+play the stream with XMMS or whatever.  The total setup seems to play rather
+behind the 'current' time, watch this space for a fix (or contribute one!)
+
+Other DisOrder options you can set are sox_generation which you should set to
+if you have a sufficently recent version of sox, due to an incompatile change
+in its command syntax; and sample_format which determines what format is
+supplied to the speaker_command.  See disorder_config(5) for further
+information.
+
+

 Local Variables:
 mode:text
 fill-column:79
 End:
 Local Variables:
 mode:text
 fill-column:79
 End:

-arch-tag:ae95108d51c55288c4f6da4102343cd5