WWW::Grooveshark version 0.02 ============================= Grooveshark is an internationally-available online music search, streaming, and recommendation service. WWW::Grooveshark wraps this service's API in an object-oriented Perl interface, allowing you to programmatically search for songs, artists, albums, or playlists; browse popular music; get song recommendations; manage playlists; and more. This version wraps a few more API methods, fixes some documentation errors, and increases laziness potential: response objects can be used as booleans to check if an API call was successful and WWW::Grooveshark objects will end their session, if any, when garbage collected. INSTALLATION To install this module, open a terminal in the directory containing the unarchived source and type: perl Makefile.PL make make test make install This should work on most modern systems assuming you have Perl and a Make utility installed and configured in the usual way. The most likely change you might need to make to the above is replacing the first line with perl Makefile.PL PREFIX=~ if you're on a Unix-like OS and wish to install the module in your home directory. The `make test' step is optional but recommended to verify that the code works as expected on your system before proceeding with the install. To run all the tests, you will need a valid Grooveshark API key as well as a Grooveshark username and password. Take a look at test_config.example to find out how to specify these. DEPENDENCIES This module requires the following other modules: Carp Digest::MD5 Exporter JSON::Any LWP::UserAgent NEXT (at least version 0.61) URI::Escape CONTACT You can reach me by e-mail at . My Google Profile at http://www.google.com/profiles/mlpalii should list additional ways of getting in touch. COPYRIGHT AND LICENSE Copyright (C) 2009 by Miorel-Lucian Palii This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.