stream(mpeg audio) v1.24 by megacz(megacz@usa.com), Wednesday 29-Nov-2006
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^  =====================


         __                                    ___  ___  __ __
   _____/ /_________  ____ _____ ___     _   _<  / |__ \/ // /
  / ___/ __/ ___/ _ \/ __ `/ __ `__ \   | | / / /  __/ / // /_
 (__  ) /_/ /  /  __/ /_/ / / / / / /   | |/ / /_ / __/__  __/
/____/\__/_/   \___/\__,_/_/ /_/ /_/    |___/_/(_)____/ /_/   
                                                              


 ]i[   intro
===== =======

'stream' is a very powerful ARexx script that makes possible to STREAM,
RECORD and/or PLAY Shoutcast(MPEG-1,2,2.5/I,II,III) radio.

The main feature is unlimited number of streamers running at the same time,
so basically u r able to record as many Shoutcasts as ur machine resources
r adequate to launch new process, not worying too much about the CPU time
(coz of resetable process priorities that could be below 0 when recording).


Other features in brief:

  - fully CLI driven ( i see now faces of those who dont like the CONSOLE:,
    hehheh)

  - streamers following-tracing ( up to 10 streamers could be traced)

  - very informational progress indicator for each streamer:

                           [...](194/14/3153820/7300/0/0/4/5/0/0)[...]
      1. time elapsed------------/^^ /^ /^^^^^^ /^^^ / / / / / /
      2. network speed (Kb/s)-------/  /       /    / / / / / /
      3. tot. number of bytes received/       /    / / / / / /
      4. network buffer fill level(bytes)----/    / / / / / /
      5. disk buffer fill level(bytes)-----------/ / / / / /
      6. if player not running network !delay-----/ / / / /
      7. number of loops to pass until !delay------/ / / /
      8. refresh rate of ind. in VERBOSE/S----------/ / /      
      9. is recording paused(0=no/1=yes)?------------/ /
     10. number of reconnects-------------------------/

  - custom, reusable ports ( useful with web browsers for instance)

  - streamers switching ( the ability to drop the audio at one streamer and
    link it again to the other without terminating the previous one)

  - auto sense of the buffering ( when audio decoder is linked and then
    dropped streamer will behave like it would be still online, in the
    other words there will be no full-speed effect after audio dropping)

  - possibility to PAUSE and/or RESUME any recording streamer at any time

  - AHI support ( now also from command line)

  - popular pls://,m3u:// playlists support as well as list:// books
    ( to create fresh books use 'tools/screparse')

  - synchronous disk buffer ( no more filesystem performance loss when
    recording)

  - silent reconnection on Shoutcast drops ( streamer will try to reconnect
    unlimited number of times, but if there will be critial/init error it will
    give up - critical/init means usually timeout at some operation, like
    dns querying failure or connection timeout at startup)

  - eventized streamer priorities ( when player linked and when player
    dropped priorities)   

  - http proxy support ( just in case)

  - ... and many other minor ones u will discover by using frequently =D



 ]h[   history             
===== =========


older versions
--------------

 1.0 , ??-???-2004    - initial version
 1.1 , 26-Jun-2005    - first improved version
 1.21, 28-Jan-2006    - rewritten with new features
 1.22, 14-May-2006    - fixed problems with KingCON,
                        fixed problem where .mp3's could not be played
 1.23, 14-Jun-2006    - updated 'tools/'


current version
---------------

 1.24, 24-Nov-2006    - rewritten from scratch with new features
                        and new methods of controlling pipe dev.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 2296    6083  37.7% -lh5- 1058 Dec  5 00:16 stream124/books/comedy
[generic]                  267     474  56.3% -lh5- 9fad Dec  5 00:17 stream124/books/pranks
[generic]                 3022    7900  38.3% -lh5- b136 Dec  5 00:19 stream124/books/punk
[generic]                  263     553  47.6% -lh5- 6ea3 Dec  5 00:26 stream124/books/stoner
[generic]                11641   45350  25.7% -lh5- 8471 Dec  5 20:56 stream124/stream
[generic]                 8744   22704  38.5% -lh5- f765 Dec  5 02:19 stream124/stream.readme
[generic]                 2204    5236  42.1% -lh5- d025 May 14  2006 stream124/tools/screparse
[generic]                 1085    2048  53.0% -lh5- 8ae0 May 14  2006 stream124/tools/screparse.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         8 files   29522   90348  32.7%            Dec  6 03:47