clamz man page on OpenSuSE

Man page or keyword search:  
man Server   25941 pages
apropos Keyword Search (all sections)
Output format
OpenSuSE logo
[printable version]

clamz(1)							      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 Ama‐
       zon.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	 plat‐
       forms.)	 clamz can be used to download either individual songs or com‐
       plete 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_man‐
	      ager_install.html?AMDVersion=1.0.9

       If you are outside the US, replace `amazon.com' with the	 corresponding
       domain  for  your  country (e.g., amazon.co.uk for the UK, or amazon.fr
       for France.)  Amazon does not allow anyone to purchase MP3  files  from
       outside their country of residence.

       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.  Note that the format string  should  be
	      enclosed	in  single  quotes,  to	 stop the shell from expanding
	      variables itself.

       -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 informa‐
	      tion 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  mes‐
	      sages.

       --forbid-chars=characters
	      Do  not  allow  the  given characters to be used in output file‐
	      names.  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_DESK‐
       TOP_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 (Ama‐
	      zon 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.

       Note that when you include format variables in a command-line argument,
       you will usually need to enclose the argument in single quotes ('...'),
       or insert a backslash before the `$', to prevent the shell from	trying
       to expand the variables itself.

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>

Clamz 0.5			 October 2011			      clamz(1)
[top]

List of man pages available for OpenSuSE

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net