# Get Collection

Previous Page Home

### Get Collection Man Page

          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.

First Page

eMusic.com is a trademark of its owner. All other trademarks are trademarks of their owners. Get Collection is not a product of, or affiliated with, eMusic.com