lrcplayer

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

************
Supproted files
(priority is the same order)

.lrc
.lrc8 (utf8)
.snc
.txt
id3v2 SYLT or USLT tag for mp3

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 the parent directory of mp3.
e.g.
if 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)
also check the directory `/Lylics' (customizable) if it exists.
following files will be also checked.
/Lyrics/Musics/Artist/Album/Title.(ext)
/Lyrics/Musics/Artist/Title.(ext)
/Lyrics/Musics/Title.(ext)
/Lyrics/Title.(ext)
for the detail, see find_lrc_file() in souce.

************
Open .lrc

This plugin also works as viewer.
Open .lrc file with this plugin will display the specified file.
When opening .lrc, music should be being played. Otherwise, the file
would be ignored.
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.
Selecting line changes its time to current position of the song.
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 if icons is enabled.
      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 as 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
the format of time tag to be saved is [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.

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