toc - installation - status - menus supported: - lrc file - snc file - id3v2.3 SYLT/USLT (only for mp3) - txt file - cue file - tr file - dic file Button mapping: - scroll mode - edit mode %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% *************** installation: *************** Option 1: snclrc.c compile: - preconditon: the development environment for rockbox is already setup and rockbox can be compiled - copy the file snclrc.c to [rockbox_dir]/apps/plugins/ - open the file [rockbox_dir]/apps/plugins/SOURCES with a text editor and add the line "snclrc.c" (without quotes) - open the file [rockbox_dir]/apps/plugins/CATEGORIES with a text editor and add the line "snclrc,apps" (without quotes) - build rockbox again and make a installation package (rockbox.zip) - extract rockbox.zip onto your player Option 2: snclrc.rock - copy snclrc.rock to /.rockbox/rocks/apps or any other directory on your player *************** Status: *************** speaker volume hourglass a button was pressed/loading lyrics aa_icon show album art utf8 the snc file is/will be encoded in utf8 vbr variable bitrate mp3 tr_icon load translation file !(+/-) lyrics modified (with a positive/negative time offset) number number of files in the delete-list mode_icon repeat mode *************** Menus: *************** in scrolling mode: - translation: try to load an additional translation file if available - auto cue: create tracks with a fixed interval (default value: 0 = off) - delete-list: Show a menu and the list of files to delete (max. 20 files) : deletes all files in the list : automatically add every playing song into the delete-list : add the current playing song to the list : empty the list of files files2delete: removes the selected file from the list - time offset: add a positive or negative offset to all or the [a,b[ marked time tags - repeat 1: turn on/off repeat 1 - delete file: delete the cue or lyrics file and also the translation file - clean blanks: delete the blank lines, if the time of the following line is less than the set time - next gap: go to next blank lyrics line or if time between two sncs is > 8s - peakmeter: turn on/off peakmeter (on: show peakmeter if no lyrics can be found and auto cue is off) - Scrolling: opens a submenu with these items: scroll-limit: set the vertical scroll-limit (for the lyrics) line-scroll-start-delay: wait time before the line begins to scroll (artist/title) line-scroll-delay: value 0 = no scrolling (artist/title) - album art: opens a submenu with these items: lyrics || AA: show lyrics without album art or show album art if no lyrics available AA next to Lyrics: show album art on the left of the lyrics (album art size is configurable) AA below Lyrics: show album art below the lyrics (album art size is configurable) AA || Lyrics: show album art without lyrics or show lyrics if no album art available Size: set the size of the album art; the value unit is in pixel album art loading order: 1. see the Rockbox manual 2. /.rockbox/rocks/apps/snclrc.bmp in edit mode: - dictionary: look up a word in a dictionary (see 'dic file' section) : Change the dictionary : Open the virtual keyboard to enter a word words: Look up the selected word - delete(a-b/current): delete marked lines between [a,b[ or the current line if a-b is not set - insert(a-b/blank): insert the marked lines between [a,b[ or a blank line if a-b is not set - join: join two sections (highlighted and the one below) - edit: edit highlighted line with the virtual keyboard - edit+: edit highlighted line and apply the changes to all the other lines with the same content - the menus in scrolling 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/USLT: lyrics embedded in a mp3 id3v2.3 tag *************** - ANSI and Unicode encoding are supported - not possible to modify the id3 tag (modification will be saved to a file) SYLT (SYnchronised Lyrics Tag) - use Minilyrics to embed the lyrics USLT (UnSynchronized Lyrics Transcription) - tested with tag&rename *************** 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. *************** cue file: *************** e.g.: /music/test.mp3 /music/test.cue cue file format: PERFORMER "" TITLE "" FILE "<path>" MP3 TRACK 01 AUDIO TITLE "<title>" INDEX 01 <time> TRACK 02 AUDIO TITLE "<title>" INDEX 01 <time> ... *************** tr file: Translation file (has the same format as a lrc file) *************** e.g.: /music/La Donna E Mobile.mp3 /music/La Donna E Mobile.lrc8 /music/La Donna E Mobile.tr La Donna E Mobile.lrc8: [00:13.62][00:35.07][01:37.41]La donna è mobile [00:16.13][00:37.06][01:39.43]qual piuma al vento [00:18.88][00:39.33][01:41.53]muta d'accento [00:21.39]e di pensiero ... La Donna E Mobile.tr: [00:13.62][00:35.07][01:37.41]Woman is flighty [00:16.13][00:37.06][01:39.43]Like a feather in the wind, [00:18.88][00:39.33][01:41.53]She changes her voice [00:21.39]and her mind ... note that every time tag in the tr file must correspond to a time tag in the lrc file *************** dic file: plain text dictionary *************** How to look up a word: - change to edit/browse mode - go to the lyrics line where you want to look up a word - open the menu and select 'Dictionary' - select the word to translate the dictionaries must meet these conditions: - utf8 encoded - sorted - dictionary filename: snclrc.dic (the default dictionary) further dictionaries (can be chosen in the menu): <lc>.dic (lc is the language code: max. 2 chars) e.g. fr.dic (French dictionary) es.dic (Spanish dictionary) ... - format: [word] [translation] e.g. ... parificar beweisen parihuela Trage;Tragbahre parihuelas Trage;Tragbahre parillas Bratrost parima Reiher ... The location for the dictionaries is: /.rockbox/rocks/apps/ Plain text dictionaries: - cedict: Chinese - English dictionary (needs to be sorted) - use the free software 'dictconv' to convert various dictionaries to plain text - http://www.dicts.info/dictionaries.php: small dictionaries, but many languages available (reformatting required, especially removing the leading white space) note: I have only tested with dictionaries up to ~ 4MB %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Button mapping (Mapping to WPS actions, see "WPS Key Controls" in the Rockbox manual) *************** same for both modes (scroll and edit): *************** WPS Play . switch between play and pause WPS Stop . exit plugin WPS AB-Reset . if there's a lyrics file then set a-b else add the currently playing song to or remove it from the the delete-list WPS Quickscreen . show a-b menu (set/clear/save/load/remove) WPS Rec . save changes to file WPS Context . show menu WPS Seekfwd . forward audio WPS Seekback . rewind audio WPS Skip Next . next audio file ..next timetag (double click) WPS Skip Previous ..previous audio file (double click) *************** scroll mode: displays the lyrics according to the synchronized time *************** WPS Menu . switch backlight between 'always on' and 'normal setting' WPS Browse . switch to edit mode / try to load txt if no snc is available WPS Skip Previous . go to the beginning WPS Up/Down . +/- volume *************** edit mode: browse/modify the lyrics and timetags *************** WPS Menu . apply elapsed time to the highlighted line WPS Browse . forward/rewind audio to the highlighted time WPS Skip Previous . switch to scroll mode WPS Up/Down . scroll lyrics manually