Ruby Lyric Parser 1.0

[James Gleeson]

Name: Ruby Lyric Parser
Version: 1.0
Type: Amarok 2.0 Script
Depend: 
License: Creative Commons by
Homepage: 
More Info:
http://www.kde-apps.org/content/show.php?content=86602

Description:
 -- About --
RLP is a lyric fetching script for Amarok written
in Ruby.

The RLP philosophy:
1) Keep the number of search engines to a minimum.
2) Use the best search engines.
3) Search effectively and efficiently.

Search Engines (in order of search priority):
1) LyricWiki - a reliable, well-maintained, and
constantly updated lyric site
2) JustSomeLyrics - good for less popular music
(not found on LyricWiki)

__Basic Search Algorithm Description__
Processing Artist/Song Data:
1) Artist and song data are first \"processed\";
this involves stripping any useless/junk
characters that would otherwise prevent useful
search results.
2) Original artist and song data are still
preserved.  In the event that a search with the
processed info fails, we\'ll try it again but with
the unprocessed data.
3) Adding to 2)... RLP will retry only if the
following conditions hold true:
	a) The processed and unprocessed song information
differs
	b) retry is set to true in configuration options
	c) The search method itself is set to retry (as
defined by me)

LyricWiki Search Methods:
1) Guess the url:  This method \"guesses\" the url
from the song/artist data.  So, if the meta tags
on your music are accurate, then you\'ll have no
problems getting lyrics.
2) Google search: This method searches google
using the song/artist data and grabs the first
search result.

JustSomeLyrics Search Methods:
1) Google search: This method searches google
using the song/artist data and grabs the first
search result.

-- Benefits of RLP --
1) I actively develop and constantly test my code
(see the Test Cases suite I\'ve included in
lyric_parser.rb).
2) The general trend with lyrics scripts seems to
be:
\"more search engines = better results\"
I disagree, and instead believe:
\"more search engines = bloated and slow script
that searches ineffectively\"
3) I\'m open to suggestions (see Contact
information below).

-- Configuration --
The configuration is located at the top of
lyric_parser.rb, and is quite minimal (and in my
opinion, not needed).

-- Contact --
Having trouble getting lyrics for a song even
though it\'s on one of the above search engines?
Know a better lyric search engine that I should
include in future releases?

By all means, email me about it, and I\'ll
consider implementing it.
Email: chocomoojuice at gmail.com

Changelog:
 ###############################################################################
Version 1.0
Date: Monday, August 4th, 2008
###############################################################################
> Initial release.