lrcplayer

display lyrics in .lrc file synchronized with song playing.

************
supproted files:

(priority is the same order)
.lrc
.lrc8 (utf8)
.snc
.txt
id3v2.3 SYLT/USLT tag for mp3

note: code about reading .snc and id3v2.3 is stollen from
      sncviewer and they are not tested well.

************
controls:

it is almost same as WPS with default settings in main screen.
button is same to play/pause, fast-forward/rewind, skip and up/down volume.
(most code relating control is 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 for settings.
button for context will go to edior.
note: to set offset, it is needed to enter numbers with keybord.

************
searching directory:

this plugin checks the parent directory of mp3.
e.g.
if file is /music/artist/album/title.mp3, then following files are checked.
/music/artist/album/title.(ext)
/music/artist/title.(ext)
/music/title.(ext)
/title.(ext)
also check the directory `Lylics' (customizable). following files are 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.
this may result to loading wrong lyrics file.

************
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 playing.
note: once song is changed, specified file will be no longer used
      even if the same song is playing.

************
editing time

time when to dispaly the line can be edited with lrc editor screen
can be accessed from menu or button for context for shortcut.
Selecting line changes its time to current position of the song.
changes will be saved when close this screen automatically.
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.

************
limitation:

max size of each line is 128byte (defined as MAX_LINE_LEN)
it is not possible to edit lyrics (it is possible to set time).
lyrics is read from txt file and its time is changed,
changes will be saved to (path_wihout_extention).lrc.
lyrics read from id3 tag will be saved to (path_wihout_extention).lrc8.

************
.lrc/.lrc8

supported lrc format:
[ti:title]
[ar:artist]
[offset:offset (msec)]
[timetag]lyrics
[timetag][timetag]...lyrics

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

any other tags and lines without timetags are skipped

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

not tested well

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

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

text file.

************
id3v2.3 SYLT/USLT (only for mp3)

USLT is not tested well.
SYLT is not tested at all.

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