1clamz(1) General Commands Manual clamz(1)
2
6 clamz - download MP3 music files from Amazon.com
7
9 clamz [ options ] amz-file ...
10
13 clamz is a little command-line program to download MP3 files from Ama‐
14 zon.com's music store. It is intended to serve as a substitute for
15 Amazon's official MP3 Downloader, which is not free software (and
16 therefore is only available in binary form for a limited set of plat‐
17 forms.) clamz can be used to download either individual songs or com‐
18 plete albums that you have purchased from Amazon.
19 In order to use clamz, you must first enable the ``MP3 dowloader mode''
21 by visiting the following URL:
22 http://www.amazon.com/gp/dmusic/after_download_man‐
24 ager_install.html?AMDVersion=1.0.9
25 If you are outside the US, replace `amazon.com' with the corresponding
27 domain for your country (e.g., amazon.co.uk for the UK, or amazon.fr
28 for France.) Amazon does not allow anyone to purchase MP3 files from
29 outside their country of residence.
30 To download the contents of an AMZ file into the current directory,
32 just run
33 clamz some-file-name.amz
35 More advanced options are listed below.
37 OPTIONS
40 -o name-format, --output=name-format
41 Set the name of the downloaded file(s). This may contain any of
42 several variables which are derived from the input AMZ file; see
43 FORMAT VARIABLES below. Note that the format string should be
44 enclosed in single quotes, to stop the shell from expanding
45 variables itself.
46 -d directory-format, --output-dir=directory-format
48 Set the directory where the downloaded files should be placed.
49 (If this directory does not exist, it will be created.) This
50 may also contain format variables.
51 -r, --resume
53 Resume downloading a partially-downloaded album. (By default,
54 if you are downloading a file named foo.mp3, and the file
55 foo.mp3 already exists in the destination directory, clamz will
56 rename the new file to foo.mp3.1 to avoid overwriting the old
57 file. If the -r option is used, clamz will instead assume that
58 the first part of the file has already been downloaded, and will
59 resume downloading from where it left off.)
60 -i, --info
62 Rather than downloading anything, just display detailed informa‐
63 tion about the given AMZ file(s) to standard output.
64 -x, --xml
66 Rather than downloading anything, print the raw, decrypted XML
67 data from the AMZ file to standard output.
68 -v, --verbose
70 Display detailed information while downloading.
71 -q, --quiet
73 Turn off the normal progress display; display only error mes‐
74 sages.
75 --forbid-chars=characters
77 Do not allow the given characters to be used in output file‐
78 names. Note that control characters and slashes may never be
79 used in filenames.
80 --allow-chars=characters
82 Opposite of the above; remove the given characters from the set
83 of disallowed characters.
84 --allow-uppercase
86 Allow uppercase letters in filenames.
87 --forbid-uppercase
89 Do not allow uppercase letters in filenames.
90 --utf8-filenames
92 Use UTF-8 when writing filenames (the default behavior is to use
93 UTF-8 if the system locale says so, otherwise ASCII.)
94 --ascii-filenames
96 Use only ASCII characters in filenames.
97 --help Print out a summary of options.
99 --version
101 Print out version information.
102 FORMAT VARIABLES
105 As part of a name-format or directory-format option, you may include
106 references to environment variables (e.g., $HOME) or to the `xdg-user-
107 dirs' configuration variables (e.g., $XDG_MUSIC_DIR or $XDG_DESK‐
108 TOP_DIR.)
109 In addition, the following special variables are defined for each
111 track, based on the information provided in the AMZ file, and subject
112 to the above configuration options (--forbid-chars, --forbid-uppercase,
113 etc.)
114 ${title}, ${creator}, ${tracknum}, ${discnum}, ${genre}, ${asin}
116 Title, creator, track number, disc number, genre, and ASIN (Ama‐
117 zon Standard Identification Number) of each individual track.
118 ${album}, ${album_artist}, ${album_asin}
120 Title, primary artist, and ASIN of the album the track comes
121 from. (This information is available both for single-track and
122 full-album downloads.)
123 ${suffix}
125 Suffix of the output file (currently only `mp3'.)
126 ${amz_title}, ${amz_creator}, ${amz_genre}, ${amz_asin}
128 These variables formerly contained metadata for the AMZ file as
129 a whole; current AMZ files do not contain this information.
130 Using these variables is not recommended.
131 Similar to shell variable expansion, you can also use the following
133 conditional expressions:
134 ${var:-string}
136 Expands to the value of variable var if it is defined and non-
137 empty; otherwise, expands to string (which may itself contain
138 variable references.)
139 ${var:+string}
141 Expands to string if the variable var is defined and non-empty;
142 otherwise, expands to an empty string.
143 Note that when you include format variables in a command-line argument,
145 you will usually need to enclose the argument in single quotes ('...'),
146 or insert a backslash before the `$', to prevent the shell from trying
147 to expand the variables itself.
148
151 $HOME/.clamz/config
152 General configuration file, providing default settings for the
153 --output, --forbid-chars, --allow-uppercase and --utf8-filenames
154 options.
155 $HOME/.clamz/amzfiles/
157 Directory containing backup copies of AMZ files.
158 $HOME/.clamz/logs/
160 Directory containing log files.
161
164 http_proxy
165 HTTP proxy to use for downloading files; use `server:port' to
166 specify a port number.
167
170 Benjamin Moody <floppusmaximus@users.sf.net>
171Clamz 0.5 October 2011 clamz(1)