Man Linux: Main Page and Category List

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

       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.

       -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.

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>