clamz(1)
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-userdirs' 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 nonempty; 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>