stream2tracks-

   A script to download all tracks from a stream container, transcode them all
   to the desired format, tag them using metadata from the streams and rename
   them to filenames derived from the tags.

   Currently only asx streams are supported as input and formats that are
   supported by ffmpeg and taglib2 (e.g. ogg, flac, mp3) are supported as output.

   This code is considered early alpha and therefore is not guaranteed to do
   anything useful at all. But if the rough edges don't bother you, it's sort
   of usable already.

Download:

   1. On Debian Wheezy/Sid, install these dependencies. For other platforms,
      install the equivalents. stream2tracks uses mimms to download mms streams
      contained within ASX stream containers and ffmpeg to transcode the tracks
      into the desired format. The -dev packages are required to build native
      gems for nokogiri and taglib2.

      $ sudo apt-get install mimms ffmpeg libxml2-dev libxslt-dev libtagc0-dev

   2. Install the gem.

      $ sudo gem install stream2tracks

Usage:

   $ mkdir -p <output-dir>
   $ cd <output-dir>
   $ stream2tracks <asx-file-or-url>

   After some time, the script will finish and all output will appear in the
   current directory. Look in $HOME/.cache/stream2tracks/* if anything went
   wrong, as currently the working files are not cleaned up.

   The default output format is ogg, and I've tested ogg, mp3 and flac, though
   any format supported by both ffmpeg and taglib2 should work. So, for
   example, to output as mp3:

   $ stream2tracks -f mp3 <asx-file-or-url>

   There is an experimental 'multi' mode which downloads all tracks at once.
   This may work if you have a broadband connection, but could cause problems
   if you're on a slower link. e.g.

   $ stream2tracks -m <asx-file-or-url>

Where to find streams:

   A number of radio sites archive concerts and other programs as asx streams.
   I've tested the script with http://www.cbc.ca/radio2/cod so far. There may
   be some variations in the formats and metadata wrapped in the streams, so
   I would be happy to hear about your experience using this script with
   other sites as well.

You can also install from source:

   1. Fetch the source.

      $ git clone git://github.com/synrg/stream2tracks.git

   2a. Build and install the gem.

      $ cd stream2tracks
      $ rake package
      $ sudo gem install pkg/stream2tracks*.gem

   2b. Or install using Minero Aoki's setup.rb, e.g.

      $ cd stream2tracks
      $ ruby setup.rb config --prefix=/usr/local
      $ sudo ruby setup.rb install

      See setup.rb --help for other possible options.

Bugs:

   Please file and track issues at the project site:

      https://github.com/synrg/stream2tracks

   The preferred way to contact me about bugs, including documentation bugs
   or wishlists is through the issues system.

Ben Armstrong <synrg@debian.org>