lrcplayer

This plugin displays lyrics in .lrc file synchronized with song playing.

************
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 and they are not tested well.

************
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 /music/artist/album/title.mp3, then following files will be checked.
/music/artist/album/title.(ext)
/music/artist/title.(ext)
/music/title.(ext)
/title.(ext)
also check the directory `/Lylics' (customizable). following files will be checked.
/Lyrics/music/artist/album/title.(ext)
/Lyrics/music/artist/title.(ext)
/Lyrics/music/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 must be being played. Otherwise, just egnore the specified file.
note: once song is changed, specified file won't be used
      even when the same song is played next time.

************
Editing time

Time when to dispaly the line can be edited with lrc editor screen
can be accessed 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 brings up a screen where time can be adjusted.
Changes will be saved automatically when the song is changed.
backup file will be created before saving.
e.g. when saving /Lyrics/hoge.lrc, removes /Lyrics/hoge.lrc~ if exists,
     and then creates /Lyrics/hoge.lrc~ as backup.

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 is 128byte (defined as MAX_LINE_LEN)
it is not possible to edit words (time tag can be adjusted).
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

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

any other tags and lines without timetags are skipped
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.

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

data of first SYLT/USLT tag will be used.
they are not tested well.
***************