home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / icerx092.zip / readme.txt < prev   
Text File  |  2000-10-27  |  5KB  |  158 lines
  1.  
  2. ICE REXX Version 0.92
  3.  
  4.  
  5. ICE REXX is a replacement MP3-Feeder for shout.exe or iceplay.pl in the
  6. ICECAST package with PM interface.
  7.  
  8. ICE REXX is freeware. Use it at your own risk.
  9.  
  10. ------------------------------------------------------------------------------
  11.  
  12. Features:
  13.  
  14.     * PM Interface
  15.     * skip to next/previous song
  16.     * jump within the playlist
  17.     * graphical progress bar
  18.     * file info
  19.     * cuefile for web
  20.  
  21. I have included the latest version of the ICECAST package I found.
  22. Also you need the EMX runtime library for the ICECAST Server.
  23.  
  24. ftp://hobbes.nmsu.edu/pub/os2/dev/emx/v0.9d/emxrt.zip
  25.  
  26. ------------------------------------------------------------------------------
  27.  
  28. Installation:
  29.  
  30. Copy the files from ICERX09.ZIP to any folder you want.
  31. Install the EMX runtime library found on hobbes.
  32. Install the ICECAST Server part to any folder you want.
  33.  
  34. Simply start the ICECAST Server with icecast -p password -q password
  35. -p is the password you have to tell ICE REXX for connection.
  36. -q ist the password to connect to the icecast server by telnet (admin).
  37.  
  38. The ICECAST server now defaults to this parameters (needed for ICE REXX):
  39.  
  40. server:        the ip address of your ICECAST server
  41. port:        8001
  42. password:    given behind parameter -p
  43.  
  44. ------------------------------------------------------------------------------
  45.  
  46. ICE REXX Options:
  47.  
  48. Make sure your ICECAST Server is running.
  49. Start the ICEREXX.EXE and change the options to your defaults.
  50. The PLAYLIST needs to be a listing of fully qualified filenames.
  51. That means in each line one file with Drive:\Path\Filename.
  52. A very easy way to generate a playlist is to use this command line:
  53.  
  54. dir *.mp3 /s /b > playlist.txt
  55.  
  56.  
  57. The CUEFILE is written just before playing a song and consists of
  58.  
  59.     Drive:\Path\Filename
  60.     SongCounter
  61.  
  62. A cgi-programm can parse this file and generate a webpage for the 
  63. listeners.
  64.  
  65. ------------------------------------------------------------------------------
  66.  
  67. Start Play:
  68.  
  69. If all the options are correct you can connect to the server.
  70. Then press PLAY and icerexx is starting to feed the server.
  71.  
  72. ------------------------------------------------------------------------------
  73.  
  74. While Playing:
  75.  
  76. You can step back and forth with the next and previous buttons.
  77. Also you can open the PLAYLIST and double click on an item to play it.
  78. After playing the song the playback continous at this selected point.
  79. To close the Playlist hit ESC.
  80.  
  81. The window "MP3 Tag" shows information about the current file.
  82. Some files don't contain MP3-Tags. In this case Title shows only the
  83. filename. Artist is filled with "Unknown".
  84. The fields format and mode contain encoding information.
  85. Length shows the duration in minutes and seconds.
  86.  
  87. ------------------------------------------------------------------------------
  88.  
  89. Stop Play:
  90.  
  91. To stop the playback just use STOP, DISCONNECT or simply close the
  92. programm.
  93.  
  94.  
  95. Commandline Option:
  96.  
  97. When passed -p to ICE REXX uppon start it connects to the server,
  98. reads the playlist and starts playing.
  99. Make shure that you have set the options correct in a previous session
  100. and testet it.
  101.  
  102. ------------------------------------------------------------------------------
  103.  
  104. Listen to the stream:
  105.  
  106. The best programs for listening to the stream are Z! for OS/2 and
  107. FreeAmp for Windows.
  108.  
  109. example command line for Z!:
  110.  
  111.     z.exe http://icecast_server:8000
  112.  
  113. You find the programs there:
  114.  
  115. http://dink.org    (Z!)
  116. http://www.freeamp.org
  117.  
  118. ------------------------------------------------------------------------------
  119.  
  120. Known Problems:
  121.  
  122. Memory:
  123. To prevent dropouts while playing the mp3 file (mostly read over a LAN) the 
  124. whole song is read in memory before the stream starts. This is normally a 
  125. memory load of 2 - 7 Megabytes. But I have seen (not yet testet with ICE REXX) 
  126. mix-records with up to 80 Megabytes. This will take a long time to read and 
  127. huge load of memory. 
  128. In a future version there will be an option for disable or limit the 
  129. memory-buffer.
  130.  
  131. The stream stopps at the client side:
  132. The MP3 Files are passed to the ICECAST Server as is. If the file is corrupted
  133. in any way the client player may drop some streaming packages or drop
  134. the stream completely. Just start play on the client again.
  135. The players with the most stable streaming I discovered are listet above.
  136.  
  137. WinAmp has a very bad implemented streaming. So don't worry if it drops the 
  138. stream - just use better software ;-)
  139.  
  140. ------------------------------------------------------------------------------
  141.  
  142. Coming Features:
  143.  
  144. - Playlist editing
  145. - stream cleaning (I have to learn more about MP3 formats ;-)
  146. - remote admin over the web
  147. - preloading of a second stream
  148. - Titlestreaming
  149. - ID3v2 TAG
  150. - .....
  151.  
  152.  
  153. Please report any bugs or suggestions related to ICE REXX 
  154. to mhimsser@gmx.net
  155.  
  156. ICE REXX (c)2000 by Maik Himssler
  157.  
  158.