1clamz(1)                    General Commands Manual                   clamz(1)
2
3
4

NAME

6       clamz - download MP3 music files from Amazon.com
7

SYNOPSIS

9       clamz [ options ] amz-file ...
10
11

DESCRIPTION

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
20       In order to use clamz, you must first enable the ``MP3 dowloader mode''
21       by visiting the following URL:
22
23              http://www.amazon.com/gp/dmusic/after_download_man
24              ager_install.html?AMDVersion=1.0.9
25
26       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
31       To  download  the  contents  of an AMZ file into the current directory,
32       just run
33
34              clamz some-file-name.amz
35
36       More advanced options are listed below.
37
38
39   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
47       -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
52       -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
61       -i, --info
62              Rather than downloading anything, just display detailed informa‐
63              tion about the given AMZ file(s) to standard output.
64
65       -x, --xml
66              Rather  than  downloading anything, print the raw, decrypted XML
67              data from the AMZ file to standard output.
68
69       -v, --verbose
70              Display detailed information while downloading.
71
72       -q, --quiet
73              Turn off the normal progress display; display  only  error  mes‐
74              sages.
75
76       --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
81       --allow-chars=characters
82              Opposite  of the above; remove the given characters from the set
83              of disallowed characters.
84
85       --allow-uppercase
86              Allow uppercase letters in filenames.
87
88       --forbid-uppercase
89              Do not allow uppercase letters in filenames.
90
91       --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
95       --ascii-filenames
96              Use only ASCII characters in filenames.
97
98       --help Print out a summary of options.
99
100       --version
101              Print out version information.
102
103
104   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
110       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
115       ${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
119       ${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
124       ${suffix}
125              Suffix of the output file (currently only `mp3'.)
126
127       ${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
132       Similar to shell variable expansion, you can  also  use  the  following
133       conditional expressions:
134
135       ${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
140       ${var:+string}
141              Expands  to string if the variable var is defined and non-empty;
142              otherwise, expands to an empty string.
143
144       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
149

FILES

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
156       $HOME/.clamz/amzfiles/
157              Directory containing backup copies of AMZ files.
158
159       $HOME/.clamz/logs/
160              Directory containing log files.
161
162

ENVIRONMENT

164       http_proxy
165              HTTP  proxy  to  use for downloading files; use `server:port' to
166              specify a port number.
167
168

AUTHOR

170       Benjamin Moody <floppusmaximus@users.sf.net>
171
172
173
174Clamz 0.5                        October 2011                         clamz(1)
Impressum