toc - install Display: - status supported: - lrc file - snc file - id3v2.3 SYLT (only for mp3) - txt file - bmp file Button mapping (iRiver H1XX/H3XX): - sroll mode - edit mode - set time offset Button mapping (iPod): - sroll mode - edit mode Button mapping (iAudio X5): - sroll mode - edit mode Button mapping (Toshiba Gigabeat): - sroll mode - edit mode *************************************************************************** *************** install: *************** 1. use sncviewer.c compile: - preconditon: the development environment for rockbox is already setup and rockbox can be compiled - copy the sncviewer.c to [rockbox_dir]/apps/plugins directory - add the entry "sncviewer.c" (without quotes) into [rockbox_dir]/apps/plugins/SOURCES file - build rockbox again and make a installation package (rockbox.zip) install: - extract rockbox.zip onto your player 2. if you got a sncviewer.rock from somewhere - copy sncviewer.rock into /.rockbox/rocks directory on your player possible error messages when you try to run the plugin: Incompatible model: The plugin is not compatible with the model trying to run it Incompatible version: The plugin is not compatible with the rockbox version trying to run it *************** Status: *************** speaker volume ! lyrics modified !+ lyrics modified (with a positive time offset) !- lyrics modified (with a negative time offset) vbr variable bitrate mp3 (using audio_ff_rewind lead to synchronization problems) utf8 the snc file is/will be encoded in utf8 bmp_icon show album art with lyrics (time a is set time) b is set mode_icon repeat mode *************** lrc file: synchronized lyrics file (with timetags) *************** e.g.: /music/test.mp3 /music/test.lrc or /music/test.lrc8 (utf8) supported lrc format: [timetag]lyrics [timetag][timetag]...lyrics timetag format: [mm:ss] [mm:ss.xx] [mm:ss.xxx] [m:ss.xxx] any other tags and lines without timetags are skipped *************** snc file: synchronized lyrics file (with timetags) *************** e.g.: /music/test.mp3 /music/test.snc one line (recommended): *************** Άβ00000000ΆΠ line 1 line 2 ... line 7 Άβ00000100ΆΠ line 1 multilines: *************** Άβ00000000ΆΠ line 1 line 2 . line 7 Άβ00000100ΆΠ line 1 *************** id3v2.3 SYLT (SYnchronised Lyrics Tag: Synchronized lyrics embedded in a mp3 id3v2.3 tag) *************** - use Minilyrics to embed the lyrics - ANSI and Unicode encoding are supported limitations: - after modification the lyrics can only be saved into a lrc file *************** txt file: lyrics file without timetags *************** load a lyrics file for tagging: *************** 1. load lyrics file with SELECT (lyrics file extension is txt e.g.: /music/test.mp3 /music/test.txt) 2. set time tag with REC 3. save tagged file with REC HOLD notes: - after saving the tags the plugin will automatically check if the tagging is completed and it will rename the file extension to lrc/lrc8. complete means every line of the file has a time. - it is possible to interrupt the tagging and continue at a later time. don't forget to save before leaving. - navigate through the lyrics with the joystick (UP/DOWN/SELECT) - LEFT/RIGHT will change to auto scrolling mode (preview) *************** bmp file: show bitmap with lyrics or if no lyrics can be found *************** bitmap loading order: 1. path/.bmp 2. path/.bmp 3. path/cover.bmp 4. /.rockbox/rocks/sncviewer.bmp *************************************************************************** Button mapping (iRiver H1XX/H3XX): *************** scroll mode: displays the lyrics according to the synchronized time *************** PLAY . switch between play and pause STOP . exit plugin A-B . set a-b _ show a-b menu (clear/save/load/remove) REC . turn on/off backlight (unplugged) _ save changes to file (Joystick) SELECT . switch to edit mode / try to load txt if no snc is available _ show menu (time offset, switch repeat 1, reload file, album art) LEFT . go to the beginning ..previous audio file _ rewind audio RIGHT . next audio file ..next timetag _ forward audio UP/DOWN . +/- volume *************** edit mode: browse/modify the lyrics and timetags *************** PLAY . switch between play and pause STOP . exit plugin A-B . set a-b _ show a-b menu (clear/save/load/remove) REC . apply elapsed time to the highlighted line _ save changes to file (Joystick) SELECT . forward/rewind audio to the highlighted time _ show menu (insert*, delete*, join, edit+ (edit highlighted line + apply the changes to all the other lines with the same content) edit, time offset, repeat 1, reload file) LEFT . switch to scroll mode _ rewind audio RIGHT . switch to scroll mode (forward audio to the highlighted time) _ forward audio UP/DOWN . scroll lyrics * applied to the marked lines between a and b or insert a blank line or delete current line if a-b is not set *************** set time offset: apply an offset to the synchronized time *************** STOP reset offset to 0 (Joystick) SELECT exit screen (go back to edit/scroll mode) LEFT offset - 100 ms RIGHT offset + 100 ms UP/DOWN +/- 500 ms *************************************************************************** Button mapping (iPod): *************** scroll mode: displays the lyrics according to the synchronized time *************** PLAY . switch between play and pause _ exit plugin MENU _ save changes to file SELECT . switch to edit mode / try to load txt if no snc is available _ show menu (time offset, repeat 1, reload file) LEFT . go to the beginning ..previous audio file _ rewind audio RIGHT . next audio file _ forward audio SCROLL . +/- volume *************** edit mode: browse/modify the lyrics and timetags *************** PLAY . switch between play and pause MENU . apply elapsed time to the highlighted line _ save changes to file SELECT . forward/rewind audio to the highlighted time _ show menu (insert*, delete*, join, edit+ (edit highlighted line + apply the changes to all the other lines with the same content) edit, time offset, repeat 1, reload file) LEFT . switch to scroll mode RIGHT . switch to scroll mode (forward audio to the highlighted time) SCROLL . scroll lyrics (manually) *************************************************************************** Button mapping (iAudio X5): *************** scroll mode: displays the lyrics according to the synchronized time *************** PLAY . switch between play and pause _ exit plugin REC . turn on/off backlight (unplugged) _ save changes to file SELECT . switch to edit mode / try to load txt if no snc is available _ show menu (time offset, switch repeat 1, reload file, album art) LEFT . go to the beginning ..previous audio file _ rewind audio RIGHT . next audio file ..next timetag _ forward audio UP/DOWN . +/- volume *************** edit mode: browse/modify the lyrics and timetags *************** PLAY . switch between play and pause REC . apply elapsed time to the highlighted line _ save changes to file SELECT . forward/rewind audio to the highlighted time _ show menu (insert*, delete*, join, edit+ (edit highlighted line + apply the changes to all the other lines with the same content) edit, time offset, repeat 1, reload file) LEFT . switch to scroll mode RIGHT . switch to scroll mode (forward audio to the highlighted time) UP/DOWN . scroll lyrics (manually) *************************************************************************** Button mapping (Toshiba Gigabeat): *************** scroll mode: displays the lyrics according to the synchronized time *************** POWER . switch between play and pause _ exit plugin MENU . turn on/off backlight (unplugged) _ save changes to file A . set a-b _ show a-b menu (clear/save/load/remove) SELECT . switch to edit mode / try to load txt if no snc is available _ show menu (time offset, switch repeat 1, reload file, album art) LEFT . go to the beginning ..previous audio file _ rewind audio RIGHT . next audio file ..next timetag _ forward audio UP/DOWN . +/- volume *************** edit mode: browse/modify the lyrics and timetags *************** POWER . switch between play and pause MENU . apply elapsed time to the highlighted line _ save changes to file A . set a-b _ show a-b menu (clear/save/load/remove) SELECT . forward/rewind audio to the highlighted time _ show menu (insert*, delete*, join, edit+ (edit highlighted line + apply the changes to all the other lines with the same content) edit, time offset, repeat 1, reload file) LEFT . switch to scroll mode RIGHT . switch to scroll mode (forward audio to the highlighted time) UP/DOWN . scroll lyrics (manually)