Get Collection

      Summary:
      GetCollection retrieves a list of the mp3s you have downloaded from 
      eMusic.com.
      
      Usage:
      GetCollection requires your eMusic.com username and password in order 
      to login to emusic.com to retrieve your emusic collection list.
      Pass your username to GetCollection by using the --username argument;
      it can be abbreviated to -u
      Pass your password to GetCollection by using the --password argument;
      it can be abbreviated to -p
      Example (">" represents your command prompt; it should not be typed): 
      > GetCollection --username someone@example.org --password smile
      Example using the abbreviated forms:
      > GetCollection -u someone@example.org -p smile
      
      THIS VERSION OF GetCollection DOES NOT DOWNLOAD .emp FILES
      
      
      Options:
      The following additional options may be given but are not required:
      
      --getemps, to download .emp files (this option is disabled in this version
      of GetCollection)
      By default, GetCollection only lists your collection by Artist 
      and Album. By specifying the option --getemps, collection.pl
      will also download .emp files, which can in turn be used to download
      music by running the .emp in the eMusic.com download manager. 
      Please note that this takes significantly more time and work, and
      should only be attempted occasionally. If you have downloaded all tracks 
      on an album (and eMusic.com tells us that), only a single "Complete Album"
      .emp, containing all tracks, will be downloaded for that album. If you
      haven't downloaded all tracks for an album, GetCollection will download
      a separate .emp for each track you have downloaded. Very occasionally,
      for undiagnosed reasons, GetCollection will fail to download a .emp
      that your browser can download (part of this is the Byzantine series 
      of redirections eMusic.com requires in order to download some .emps).
      In this case, GetCollection will often be able to download it on a 
      subsequent run.
      
      --savedir DIRNAME to specify where save data files
      By default, the .emps and the html file that list your collection are 
      saved in the directory "data", which is created in the directory from 
      which you run GetCollection. To change this default, you can specify 
      another directory with the --savedir or the abbreviated form -s option.
      If the directory you give is not absolute -- that is if it doesn't start 
      with a drive letter and colon if you're running windows, or with the root 
      directory if you're running linux -- the directory is considered to be 
      relative to the directory from which you ran GetCollection. In 
      general, please don't change the save directory, as GetCollection
      reads the files in that directory to determine if you already have an 
      .emp file, and thus it can get the job done faster by not getting it 
      again. (And see also next option.)
      
      --overwrite (this option is disbaled in this version of GetCollection)
      By default, downloaded .emp files are not overwritten if they already 
      exist, in order to skip redundant downloads. If your downloaded .emps are 
      not working, you can specify --overwrite or the abbreviated form -o 
      to have all .emps downloaded again, whether or not you have them. 
      Leaving this option out, or specifying --no-overwrite causes 
      GetCollection to not redundantly get .emps.
      
      --htmlfile FILENAME to specify the name of the file in which your 
      collection is saved.
      By default, your collection list is saved in an html file called 
      "collection.html" in the --savedir directory (by default, the directory 
      "data" in the directory where you ran  GetCollection). You can use the 
      --htmlfile or the  abbreviated form -h to change the name of that file. 
      Note that if the  name you give does not end in ".html" or ".htm", the 
      extension ".html" will be added to your filename.
      
      Option example:
      > GetCollection -u name -p pass --savedir foobar
      
      Program behavior:
      GetCollection exist to remedy a deficiency in eMusic.com's 
      "My Collection" page, notably that the "My Collection" page is difficult 
      to use. GetCollection provides a list without requiring you to wait 
      for eMusic.com's slow and balky "My Collection" page.
      
      At the same time, GetCollection if used properly REDUCES the
      STRAIN on eMusic.com TOO. The "My Collection" page can become extremely 
      long, and its design requires eMusic.com to serve many copies of this 
      very long page. GetCollection is carefully written to ask eMusic.com 
      for the bare minimum of data, with the least redundancy, in the process of
      getting your collection.  To further be a good net citizen, 
      GetCollection makes only one request at a time, and frequently pauses 
      so as to not unduly tax eMusic's servers. 
      
      For this reason, large collections will take a long time to process. To 
      monitor GetCollection's progress, you can watch the console, for 
      verbose updates on what it's doing, or you can open the file 
      "working.html" in the "data" directory. This web page will be updated
      every time GetCollection has processed another artist, and the page
      will ask your  browser to reload it every minute. By keeping this web
      page open in your browser, you'll see the progress GetCollection
      is making. When GetCollection is done, the "working.html" will
      replace itself with the "collection.html" page, letting you know it's
      done. PLEASE NOTE that older versions of the collection.html page
      will be overwritten. Rename the page if you don't want it overwritten.
      
      I hope you find GetCollection useful.
      
      eMusic.com is a trademark belonging to its owner.
      GetCollection is not manufactured by, or associated with, eMusic.com.
      Use of GetCollection is at the user's own risk; no warranty, express or
      implied, is granted.
      
      GetCollection is copyright 2004 TP Diffenbach. You are granted a 
      limited right to use GetCollection. You are granted NO RIGHTS to 
      redistribute or modify GetCollection.