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>