README

youtube-dl-rockar
=================

Download music from youtube based on rockar information.

Usage
-----

    youtube_dl_rockar [-h] artista [disco]

This only works with argentinean artists found in the rock[dot]com[dot]ar
site. It will retrieve artists discography and download the songs using
youtube-dl. If the `disco` argument is not provided, will download the whole
discography.

The output format is::

    {artist}/{albumyear} - {album}/{num} - {song}.{ext}

Where `artist` is the given artist name, `album` the name of the given album
or each album name retrieved. The filename is composed of the position of the
song in the album padding with a zero, the name of the song and the extension
given by the codec (usually m4a).

Requirements
------------

 * [youtube-dl](http://rg3.github.com/youtube-dl/)

Changelog
---------

2013-07-31

 * Update to 2013.07.19
 * Do not create folders if simulate.

2013-02-25

 * Add album year to output format.
 * Normalize artist name in URL.
 * Add simulate.
 * Titled artist name.
 * Compare album name normalized.

2013-02-23

First public version.

License
-------

(ISC license)

Copyright (c) 2012, Juan M Martínez

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.