<html>
<body>

<h3 align=center>Lyrics Manager 0.2.14</h3>

<h4>Description</h4>
<p>This script extends <a href="http://amarok.kde.org/">Amarok</a> operations with lyrics. Lyrics Manager provides the following additional actions:</p>
<ul>
	<li>edit lyrics with external editor,</li>
	<li>automatic text cleanup,</li>
	<li>export lyrics to file,</li>
	<li>import lyrics from file,</li>
	<li>erase lyrics from Amarok database,</li>
	<li>fill up lyrics with empty string,</li>
	<li>mass operations (process all files in the playlist).</li>
</ul>
<p>The script is configurable via Amarok Script Manager. You can select menu items and features that you need, setup editor and storage directory for lyrics. All these parameters are saved in a config file and loaded silently at player startup.</p>
<p>Lyrics Manager takes care of HTML tags and special symbols in lyrics and lets you edit a plain text. If you enable editing features, you should configure editor. It can be any shell command with arguments, filename is inserted by script at the end. Editor must work in foreground mode.</p>
<p>If you enable file management features, you should configure texts directory. Script writes and reads files in it (don't forget to setup permissions). File names for each song are determined by template that is prompted during configuration. Supported placeholders are:</p>
<ul>
	<li><tt>%t</tt> for a title,</li>
	<li><tt>%a</tt> for an artist,</li>
	<li><tt>%l</tt> for an album,</li>
	<li><tt>%r</tt> for a track number,</li>
	<li><tt>%f</tt> for a filename without extension,</li>
	<li><tt>%F</tt> for a filename,</li>
	<li><tt>%%</tt> for a single percent symbol.</li>
</ul>
<p>Any other <tt>%</tt> with a following symbol will be removed. Default template is &quot;<tt>%a - %t.txt</tt>&quot;. The template evaluator handles any relative paths properly. Also you can save lyrics in the same dir where the audio file is. Use &quot;Place text with music&quot; option for that. &quot;Automatic export after edit&quot; feature helps you to keep texts directory up-to-date.</p>
<p>Files with an empty lyrics, i.e. lyrics that contain only space characters, are handled specially. You can choose whether to export and import empty lyrics or not. If you want to remove lyrics from Amarok database for particular file, use &quot;erase&quot; action. Player will automatically download lyrics when you play a file that has no lyrics entry in database. To prevent fetching you can use &quot;fill up&quot; action that will create that entry and put an empty string in it. This action applies only on empty lyrics, other cases are ignored.</p>
<p>Mass operations will save your time. They are also could be used to backup and restore lyrics. All items of playlist are handled sequentially and report is generated at the end.</p>
<p>Note that lyrics are stored by player only for those files that are in its collection. Script determines this status for each file and skips ones that are not in the collection.</p>

<h4>Dependencies</h4>
<ul>
	<li>amaroK &ge; 1.4.3, &lt; 2.0</li>
	<li>PERL &ge; 5.8</li>
	<li>KDialog &ge; 1.0 (optional: for GUI configuration)</li>
</ul>
<p>Tested on: amarok 1.4.10; perl 5.8.8; kdebase 3.5.10.</p>

<h4>Known issues</h4>
<p>The script could miss some special characters in lyrics if your locale is not Unicode. This seems to be DCOP restriction and there is nothing we can do.</p>

<h4>Author</h4>
<p>Nikita Melnichenko [<a href="http://nikita.melnichenko.name">http://nikita.melnichenko.name</a>]</p>

<h4>Homepage</h4>
<p><a href="http://nikita.melnichenko.name/projects/amarok-lyrics-manager/">http://nikita.melnichenko.name/projects/amarok-lyrics-manager/</a></p>
<p>You can find extended description, ChangeLog and discussion here.</p>

<h4>Thanks</h4>
<p>Thanks to panzi (KDE-Apps.org), bleearg (KDE-Apps.org), BrutuZ (KDE-Apps.org), Max (xzoert.org) and others who helped to test the script.</p>

</body>
</html>
