Short:        stream, record and/or play Shoutcast radio
Author:       megacz(megacz@usa.com)
Uploader:     megacz(megacz usa com)
Type:         util/rexx
Version:      1.24
Requires:     68000+/os2.04+
Architecture: generic
Distribution: Aminet

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.