lrcplayer

This plugin displays lyrics in .lrc file synchronized with song being played.

************
Supproted files
(priority when searching file is the same order)

.lrc
.lrc8 (treated as utf8 file regardless the encode setting)
.snc
.txt
id3v2 SYLT or USLT tag for mp3

if the file is encoded with UTF-16, the file will be converted to 
UTF-8 before loaing.

note: code of reading id3v2 is taken from apps/metadata/mp3.c.
Lyrics3 isn't supported.

************
Controls

it is almost same as WPS with default settings in main screen.
button is same for play/pause, fast-forward/rewind, skip and up/down volume.
(most code relating control is taken from apps/gui/gwps.c,
 apps/gui/gwps-common.c, and apps/plugins/lib/playback_control.c. thanks.)
to quit plugin, press button to stop playback or go to browser (playback is not stopped).
button for menu display menu of this plugin.
button for context will go to edior for editing time tag.

************
Searching directory

this plugin checks following directories for lyrics file.

1. the same directory and the parent directory of the audio file.
e.g.
if the audio file is /Musics/Artist/Album/Title.mp3, then following files will be checked.
/Musics/Artist/Album/Title.(ext)
/Musics/Artist/Title.(ext)
/Musics/Title.(ext)
/Title.(ext)

2. the sub directory named `Lylics' (customizable) of the directories in 1.
e.g.
/Musics/Artist/Album/Lylics/Title.(ext)
/Musics/Artist/Lylics/Title.(ext)
/Musics/Lylics/Title.(ext)
/Lylics/Title.(ext)

3. the directory in root named `/Lylics' (customizable).
e.g.
/Lyrics/Musics/Artist/Album/Title.(ext)
/Lyrics/Musics/Artist/Title.(ext)
/Lyrics/Musics/Title.(ext)
/Lyrics/Title.(ext)

************
Open lyrics files

This plugin also works as viewer.
Open lyrics file with this plugin will display the specified file.
the file must be one of supported files.
note: once song is changed, specified file won't be used
      even when the same song is played next time.

************
Edit time tag

Time when to dispaly the line can be edited with timetag editor, 
which can be accessed either from menu or by pressing button for context menu.
"Select" line changes its time to current position of the song - delta.
To set a specific time or to adjust the time, pressing button for
context to bring up a screen where time can be adjusted.
Changes will be saved automatically when the song is changed.

note: icon indicates which line is being played.
      but cursor position is NOT updated unless any button is pressed.

************
Limitations

max size of each line in file including tag and so on is 256byte (defined as MAX_LINE_LEN)
it is not possible to edit words (time tag can be adjusted still).
if the lyrics is read from txt file and its time is changed,
changes will be saved to `filename.lrc'.
lyrics read from id3 tag will be saved to `filename.lrc8' encoded by UTF8.

************
.lrc/.lrc8(UTF-8)

supported tag/format:
[ti:title]
[ar:artist]
[offset:offset (msec)]
[timetag]line
[timetag]...[timetag]line
[time tag]<word time tag>word<word time tag>...<word time tag>

timetag format:
[mm:ss]
[mm:ss.xx]
[mm:ss:xx]

any other tags and lines without timetags are skipped
time tag will be saved in the format: [mm:ss.xx].

************
.snc file

format:
Άβ00000000ΆΠ
line 1
line 2
...
Άβ00000100ΆΠ
...

or

Άβ00000000ΆΠline 1
Άβ00000100ΆΠline 2
...

************

************
.txt file

text file.
whole file is read as lyrics.

************
id3v2 SYLT/USLT tag for mp3

only data of first SYLT/USLT tag will be used.

***************