NAME

       clamz - download MP3 music files from Amazon.com

SYNOPSIS

       clamz [ options ] amz-file ...

DESCRIPTION

       clamz  is  a  little  command-line  program  to  download MP3 files from Amazon.com's music store.  It is
       intended to serve as a substitute for Amazon's official MP3 Downloader, which is not free  software  (and
       therefore  is  only  available  in  binary  form  for  a limited set of platforms.)  clamz can be used to
       download either individual songs or complete albums that you have purchased from Amazon.

       In order to use clamz, you must first enable the ``MP3 dowloader mode'' by visiting the following URL:

              http://www.amazon.com/gp/dmusic/after_download_manager_install.html?AMDVersion=1.0.9

       If you are outside the US, replace `amazon.com' with the corresponding domain  for  your  country  (e.g.,
       amazon.co.uk  for  the  UK, or amazon.fr for France.)  Amazon does not allow anyone to purchase MP3 files
       from outside their country of residence.

       To download the contents of an AMZ file into the current directory, just run

              clamz some-file-name.amz

       More advanced options are listed below.

   OPTIONS
       -o name-format, --output=name-format
              Set the name of the downloaded file(s).  This may contain  any  of  several  variables  which  are
              derived  from  the input AMZ file; see FORMAT VARIABLES below.  Note that the format string should
              be enclosed in single quotes, to stop the shell from expanding variables itself.

       -d directory-format, --output-dir=directory-format
              Set the directory where the downloaded files should be placed.  (If this directory does not exist,
              it will be created.)  This may also contain format variables.

       -r, --resume
              Resume downloading a partially-downloaded album.  (By default, if you are downloading a file named
              foo.mp3, and the file foo.mp3 already exists in the destination directory, clamz will  rename  the
              new  file  to  foo.mp3.1  to avoid overwriting the old file.  If the -r option is used, clamz will
              instead assume that the first part of the file  has  already  been  downloaded,  and  will  resume
              downloading from where it left off.)

       -i, --info
              Rather than downloading anything, just display detailed information about the given AMZ file(s) to
              standard output.

       -x, --xml
              Rather  than downloading anything, print the raw, decrypted XML data from the AMZ file to standard
              output.

       -v, --verbose
              Display detailed information while downloading.

       -q, --quiet
              Turn off the normal progress display; display only error messages.

       --forbid-chars=characters
              Do not allow the given characters to be used in output filenames.  Note  that  control  characters
              and slashes may never be used in filenames.

       --allow-chars=characters
              Opposite of the above; remove the given characters from the set of disallowed characters.

       --allow-uppercase
              Allow uppercase letters in filenames.

       --forbid-uppercase
              Do not allow uppercase letters in filenames.

       --utf8-filenames
              Use  UTF-8  when writing filenames (the default behavior is to use UTF-8 if the system locale says
              so, otherwise ASCII.)

       --ascii-filenames
              Use only ASCII characters in filenames.

       --help Print out a summary of options.

       --version
              Print out version information.

   FORMAT VARIABLES
       As part of a name-format or directory-format option, you may include references to environment  variables
       (e.g.,   $HOME)   or   to   the   `xdg-user-dirs'   configuration   variables  (e.g.,  $XDG_MUSIC_DIR  or
       $XDG_DESKTOP_DIR.)

       In addition, the following special variables are  defined  for  each  track,  based  on  the  information
       provided  in  the  AMZ  file,  and  subject to the above configuration options (--forbid-chars, --forbid-
       uppercase, etc.)

       ${title}, ${creator}, ${tracknum}, ${discnum}, ${genre}, ${asin}
              Title, creator, track number, disc number, genre, and ASIN (Amazon Standard Identification Number)
              of each individual track.

       ${album}, ${album_artist}, ${album_asin}
              Title, primary artist, and ASIN of the album the track comes from.  (This information is available
              both for single-track and full-album downloads.)

       ${suffix}
              Suffix of the output file (currently only `mp3'.)

       ${amz_title}, ${amz_creator}, ${amz_genre}, ${amz_asin}
              These variables formerly contained metadata for the AMZ file as a whole; current AMZ files do  not
              contain this information.  Using these variables is not recommended.

       Similar to shell variable expansion, you can also use the following conditional expressions:

       ${var:-string}
              Expands  to the value of variable var if it is defined and non-empty; otherwise, expands to string
              (which may itself contain variable references.)

       ${var:+string}
              Expands to string if the variable var is defined and non-empty; otherwise,  expands  to  an  empty
              string.

       Note  that when you include format variables in a command-line argument, you will usually need to enclose
       the argument in single quotes ('...'), or insert a backslash before the `$', to prevent  the  shell  from
       trying to expand the variables itself.

FILES

       $HOME/.clamz/config
              General  configuration file, providing default settings for the --output, --forbid-chars, --allow-
              uppercase and --utf8-filenames options.

       $HOME/.clamz/amzfiles/
              Directory containing backup copies of AMZ files.

       $HOME/.clamz/logs/
              Directory containing log files.

ENVIRONMENT

       http_proxy
              HTTP proxy to use for downloading files; use `server:port' to specify a port number.

AUTHOR

       Benjamin Moody <floppusmaximus@users.sf.net>

Clamz 0.5                                         October 2011                                          clamz(1)