\______________________________________________________________________________/
\_______________________                               ________________________/
                        \_____________________________/
\_______________________                               ________________________/
                        \_____________________________/

\_______________________       CoverCatch V1.29        ________________________/
\_______________________\_____________________________/________________________/
\_______________________\_____________________________/________________________/
                        \_____________________________/
\______________________________________________________________________________/


     CoverCatch is a simple commandline-tool written in java which
     downloads covers of audio-CDs using the Amazon WebServices.


     Requirement: JRE/SDK 1.4 or higher
     Download   : zip or tar.gz  (~1.4 MB)
     Sourcecode : zip or tar.gz  (<0.1 MB)


     CoverCatch acts as a WebService-requestor (based on Apache Axis)
     and calls »AristSearch« from the Amazon WebServices 2.x (WSDL).


     From Amazon WebService licensing agreement: "You may store Amazon.com
     Properties [images, xml-files] for caching purposes for up to 24 hours."






\______________________________________________________________________________/
\_______________________                               ________________________/
                        \_____________________________/

\_______________________            Usage              ________________________/
\_______________________\_____________________________/________________________/
\______________________________________________________________________________/


  CoverCatch -a <artist> [-d <savedir>] [<restriction> [<restriction> [...]]]
  or
  CoverCatch -exp        ...
  
  
      -a <artist>    artist, wich is searched for 
                     (if the artistname consits of more as one word
                     use quotes or replace blanks with underscores)
    
      -exp           explore artist automatically from current dir-name
                     ("../artist - album")
  
  
      -d <savedir>   savedir for downloaded images 
                     (default: "./CoverCatch/<artist>[ - <restrictions>]")
  
      -xml           create xml-file with additional infos provided by amazon
  
      <restriction>  download only pics matching ALL restrictions
                     (e.g. if you looking for a certain album)


  
  
  
\______________________________________________________________________________/
\_______________________                               ________________________/
                        \_____________________________/

\_______________________           Examples            ________________________/
\_______________________\_____________________________/________________________/
\______________________________________________________________________________/


      CoverCatch -a "david bowie" ziggy stardust

          Searches for audio-covers of "david bowie" but downloads only 
          pictures from releases which matches "ziggy" AND "stardust".


      CoverCatch -exp -xml

          Supposed CoverCatch is called from a directory named
          "Beck - Mutations", CoverCatch will search for "Beck" as artist.
          The xml-option enables the saving of each found release to a 
          xml-file, which contains informations like track titles.
         



\______________________________________________________________________________/
\_______________________                               ________________________/
                        \_____________________________/

\_______________________           History             ________________________/
\_______________________\_____________________________/________________________/
\______________________________________________________________________________/


      1.29
      - fixed bug which causes overriding of jpg/xml file when amazon 
        lists a audio-cd twice (with exact same name)

      1.26
      - first official release



\______________________________________________________________________________/
\_______________________                               ________________________/
\_______________________\_____________________________/________________________/
\_______________________\_____________________________/________________________/
                        \_____________________________/
\_______________________                               ________________________/
                        \_____________________________/
\_______________________                               ________________________/
                        \_____________________________/
        

\_______________________                               ________________________/
                        \_____________________________/

\_______________________                               ________________________/
                        \_____________________________/
\_______________________                               ________________________/
\_______________________\_____________________________/________________________/
\_______________________\_____________________________/________________________/
                        \_____________________________/
 
\_______________________     elektronengehirn.net      ________________________/
\_______________________\_____________________________/________________________/
                        \_____________________________/
\______________________________________________________________________________/