README

AlbumFinder
version 0.2.3

Kyle Konrad
7/22/2011

ABOUT:
  AlbumFinder is a bare-bones web app that creates YouTube playlists for albums.

SETUP:
  In order to run AlbumFinder you need to:
    1) Get the code
    2) Install dependencies. If your system supports aptitude you can just run the install script as root. Otherwise install the following dependencies:
       a) easy_install python-amazon-product-api
       b) easy_install BeautifulSoup
       c) easy_install gdata
       d) easy_install web.py
       e) easy_install lxml (requires gcc and (libxml2-dev or libxslt-devel))
    3) Get a Google API developer key and Amazon AWS key and secret and put them in a file called 'albumFinder.cfg' in the same directory as albumFinder.py. See albumFinder.cfg.example for format.
    4) Make albumFinder.py executable by doing `chmod +x albumFinder.py`
    5) run with `./albumFinder.py 9000` where 9000 may be replaced by a port number of your choice - default is 8080

USAGE:
  Once the web service is running go to localhost:9000 where 9000 is replaced by the port you chose in step 4) above. Enter and album and artist and submit. Grant access to YouTube when prompted.

LICENSING:
  This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.