N O D RA FT V ER SI The Rockbox Manual for Archos Jukebox Studio 5000, 6000, Player 10 and 20 rockbox.
N Rockbox V ER SI O http://www.rockbox.org/ Open Source Jukebox Firmware Copyright c 2006 The Rockbox Team. FT Rockbox and this manual is the collaborative effort of the Rockbox team and its contributors. See the appendix for a complete list of contributors. D RA c 2003, 2004, 2005, 2006 The Rockbox Team and its contributors, c 2004 Christi Alice Scarborough, c 2003 José Maria Garcia-Valdecasas Bernal & Peter Schlenker.
C ONTENTS 3 Contents 7 7 7 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. The Rockbox interface 3.1. Your player . . . . . . . . . . . . . . . 3.1.1. The player’s controls . . . . . 3.1.2.
C ONTENTS 5. Sound Settings 5.1. Volume . . . 5.2. Bass . . . . . 5.3. Treble . . . . 5.4. Balance . . . 5.5. Channels . . 5.6. Stereo Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C ONTENTS 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C ONTENTS 6 . . . . . . . . . . . . . 61 61 61 62 62 63 63 63 63 64 64 65 65 65 C. Config file options C.1. Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 66 D. LCD Screen Sizes 68 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C HAPTER 1. G ETTING STARTED 7 1. Getting started N 1.1. Welcome FT V ER SI O This is the manual for Rockbox. Rockbox is an open source firmware replacement for a growing number of MP3 players. Rockbox aims to be considerably more functional and efficient than your device’s stock firmware while remaining easy to use and customizable. Rockbox is written by users, for users.
C HAPTER 1. G ETTING STARTED 8 O N main channel for rockbox is #rockbox on irc://irc.freenode.net. A bunch of helpful developers and users are usually around. Just join and ask – if someone knows the answer you’ll usually get an answer pretty quickly. More information including IRC logs can be found at http://www.rockbox.org/irc/. We also have a web client for joining the rockbox IRC channel so there is no need for you to install additional software to your computer.
C HAPTER 2. I NSTALLATION 9 2. Installation N 2.1. Prerequisites O Before installing Rockbox you should make sure you meet the prerequisites. Also you may need some tools for installation. In most cases these will be already available on your computer but if not you need to get some additional software. ER SI zip Utility. Rockbox is distributed as an archive using the “zip” format. Thus you need a tool to handle that compressed format.
C HAPTER 2. I NSTALLATION 10 from Rockbox website: Current Version, Daily Build and Bleeding Edge. You need to decide which one you want to install and get the version for your player. Current Version. The current version is the latest stable version developed by the Rockbox Team. It’s free of known critical bugs. It is available from http://www. rockbox.org/download/. The current version includes everything meaning you won’t need to download the fonts package separately. SI O N Daily Build.
C HAPTER 2. I NSTALLATION 11 2.4. Running Rockbox Remove your player from the computer’s USB port. Unplug any connected power supply and turn the unit off. When you next turn the unit on, Rockbox should load. When you see the Rockbox splash screen, Rockbox is loaded and ready for use. N 2.5. Updating Rockbox V ER SI O Updating Rockbox is easy. Download a Rockbox build. (The latest release of the Rockbox software will always be available from http://www.rockbox.org/download/).
C HAPTER 3. T HE R OCKBOX INTERFACE 12 3. The Rockbox interface V ER SI O N 3.1. Your player FT Throughout this manual, the buttons on the player are labelled according to the picture above. 3.1.1. The player’s controls ¸ RA Write a section describing the player for blind users. 3.1.2.
C HAPTER 3. T HE R OCKBOX INTERFACE 13 On shutdown, Rockbox automatically saves its settings. In the unlikely event of a software failure, a hardware power off can be performed by holding down Stop until the player power light goes off. O N 3.2. File Browser SI Figure 3.1.: The file browser D RA FT V ER Rockbox lets you browse your music in either of two ways.
C HAPTER 3. T HE R OCKBOX INTERFACE 14 3.2.1. File Browser Controls Key Action Minus/Plus Go to previous/next item in list. If you are on the first/last entry, the cursor will wrap to the last/first entry. Move one page up/down on the list. Go to the parent directory. Executes an action. Depending on the file type, that action may vary. (See section 3.2.2 (page 14)) If there is a MP3 playing, returns to the While Playing Screen (WPS) without stopping playback.
C HAPTER 3. T HE R OCKBOX INTERFACE 15 Copy: Copies the name of the currently selected file or directory to the clipboard and marks it to be ’copied’. Paste: Only visible if a file or directory name is on the clipboard. When selected it will move or copy the clipboard to the current directory. N Delete: Deletes the currently selected file. This option applies only to files, and not to directories. Rockbox will ask for confirmation before deleting a file.
C HAPTER 3. T HE R OCKBOX INTERFACE 16 Insert last: Add track(s) to end of playlist. Queue: Queue is the same as Insert except queued tracks are deleted immediately from the playlist after they’ve been played. Also, queued tracks are not saved to the playlist file (see section 4.8 (page 24)). Queue next: Queue track(s) immediately after current playing track. N Queue last: Queue track(s) at end of playlist.
C HAPTER 3. T HE R OCKBOX INTERFACE 17 Key Action Minus/Plus Moves the arrow to/from the filename and changes between the character bar and BACKSPACE, DELETE, ACCEPT and ABORT. Varies (see below) Shift. When the character selection bar is selected this changes between upper case, lower case, and accented letters. O N Play/Stop Menu SI The function of the Play and Stop buttons depends on what the arrow is pointing to, as follows.
C HAPTER 3. T HE R OCKBOX INTERFACE 18 section. 3.3.3. The Tag Cache Menu N Auto Update: If A UTO UPDATE is set to ON, each time the player boots, Tag Cache will automatically do everything that the U PDATE NOW setting does. Note that the A UTO U PDATE will only check for deleted files if the Directory Cache (G ENERAL S ETTINGS → S YSTEM → D ISK → D IRECTORY C ACHE) is enabled. U PDATE NOW includes that check whether dircache has been enabled or not.
C HAPTER 3. T HE R OCKBOX INTERFACE 19 the information in the Tag Cache database. Note: You may need to increase the value of the M AX FILES IN DIR BROWSER setting (G ENERAL S ETTINGS → S YSTEM → L IMITS) in order to view long lists of tracks in the ID3 database browser. b Unsupported Tags Artist Album Bitrate Composer Genre Length Title Track Number Comment Performer V 3.4. While Playing Screen ER SI O Supported Tags N There is no option to turn off Tag Cache completely.
C HAPTER 3. T HE R OCKBOX INTERFACE 20 3.4.1. WPS Key Controls Action Menu+Plus/Minus Minus Volume up/down Go to beginning of track, or if pressed while in the first seconds of a track, go to previous track. Rewind in track Go to next track. Fast forward in track. Toggle play/pause Return to the F ILE B ROWSER Enter the WPS C ONTEXT M ENU Stop playback Go to Main menu Key lock on/off Mute on/off Enter ID3 V IEWER O SI 3.4.2.
C HAPTER 3. T HE R OCKBOX INTERFACE 21 ID3 Viewer N Figure 3.5.: The ID3 viewer SI O This screen is accessible from the WPS screen, and provides a detailed view of all the identity information about the current track. This info is known as meta data and is stored in audio file formats to keep information on artist, album etc. To access this screen, press Menu+On.Use Minus and Plus to move through the information. Open With...
C HAPTER 4. T HE M AIN M ENU 22 4. The Main Menu SI O N 4.1. Introducing the Main Menu Figure 4.1.: The main menu FT V ER The M AIN M ENU is the screen from which the rest of the Rockbox functions can be accessed. It is used for a variety of functions, which are detailed below. All options in Rockbox can be controlled via the M AIN M ENU. To enter the M AIN M ENU, press the Menu button. All settings are stored on the unit.
C HAPTER 4. T HE M AIN M ENU 23 Figure 4.2.: The list bookmarks screen N 4.3. Recent Bookmarks SI O If the S AVE A LIST OF RECENTLY CREATED BOOKMARKS option is enabled then you can view a list of several recent bookmarks here and select one to jump straight to that track. See section 6.5 (page 34) for more details on configuring bookmarking in Rockbox. Note: This option is off by default. ER 4.4.
C HAPTER 4. T HE M AIN M ENU 24 N A theme is basically a configuration file, stored in a specific directory, that typically changes the WPS , font used and on some platforms additional information such as background image and text colours. There are a number of themes that ship with Rockbox. If none of these suit your needs, many more can be downloaded from . Some of the downloads from this site will actually be standalone WPS files, others will be full-blown themes.
C HAPTER 4. T HE M AIN M ENU 25 4.10. Info This option shows RAM buffer size, battery voltage level and estimated time remaining, disk total space and disk free space. Use the MINUS and PLUS keys to step through several pages of information. N Rockbox Info: Displays some basic system information. This is, from top to bottom, the amount of memory Rockbox has available for storing music (the buffer), battery status, hard disk size and the amount of free space on the disk.
C HAPTER 5. S OUND S ETTINGS 26 SI Figure 5.1.: The sound settings screen O N 5. Sound Settings ER The Sound Settings menu offers a selection of sound properties you may change to customize your listening experience. 5.1. Volume FT V This setting adjusts the volume of your music.
C HAPTER 5. S OUND S ETTINGS 27 5.4. Balance This setting controls the balance between the left and right channels. The default, 0, means that the left and right outputs are equal in volume. Negative numbers increase the volume of the left channel relative to the right, positive numbers increase the volume of the right channel relative to the left. N 5.5. Channels O A stereo audio signal consists of two channels, left and right.
C HAPTER 6. G ENERAL S ETTINGS 28 SI Figure 6.1.: The general settings screen O N 6. General Settings 6.1. Playback Options ER The P LAYBACK O PTIONS submenu allows you to configure settings related to audio playback. Shuffle: Alters how Rockbox will select which next song to play. Options: O N/O FF. V Repeat: Configures settings related to repeating of directories or playlists.
C HAPTER 6. G ENERAL S ETTINGS 29 repeat mode and then the start and end points defined. Hold Play and press Left — Sets Start Point (A) Hold Play and press Right — Sets End Point (B) N Play Selected First: This setting controls what happens when you select a file for playback while shuffle mode is on. If the P LAY S ELECTED F IRST setting is Y ES, the file you selected will be played first. If this setting is N O, a random file in the directory will be played first.
C HAPTER 6. G ENERAL S ETTINGS 30 Fade On Stop/Pause: Enables and disables a fade effect when you pause or stop playing a song. If the Fade on Stop/Pause option is set to Y ES, your music will fade out when you stop or pause playback, and fade in when you resume playback. N Party Mode: Enables unstoppable music playback. When new songs are selected, they are added to the end of the current dynamic playlist instead of being played immediately. The PLAY and STOP buttons are disabled.
C HAPTER 6. G ENERAL S ETTINGS 31 ID3 Database: This shows the files based on the TAG C ACHE information, thus disabling the F ILE B ROWSER. You can browse the database by various tags and search them. Only information present in music file tags are shown. For a detailed description of TAG C ACHE refer to section 3.3 (page 17). O N Follow Playlist: This option determines what directory the F ILE B ROWSER displays first.
C HAPTER 6. G ENERAL S ETTINGS 32 having any other effect. When disabled the first keypress will also perform its appropriate action. Contrast: Changes the contrast of your LCD display. Warning: Setting the contrast too dark or too light can make it hard to find this menu option again! N Scrolling This feature controls how text will scroll in Rockbox. You can configure the following parameters: Scroll Speed: Controls how many times per second the scrolling text moves a step.
C HAPTER 6. G ENERAL S ETTINGS 33 Battery Capacity: This setting can be used to tell Rockbox what capacity (in mAh) of battery is being used inside it. The default is 1500mAh, which is the capacity value for the standard batteries shipped with the player. Rockbox uses this value to estimate remaining battery life for the status bar and WPS. Changing this setting has no effect whatsoever on actual battery life. This setting affects only the the accuracy of the battery life display on screen. N 6.4.2.
C HAPTER 6. G ENERAL S ETTINGS 34 N Car Adapter Mode: When using the player in a car, C AR A DAPTER M ODE automatically stops playback on the player when power (i.e. from cigarette lighter power adapter) to the external DC in jack is turned off. If the C AR A DAPTER M ODE is set to O N, Rockbox will pause playback when the external power off condition is detected. Rockbox will then shutdown the player after the length of time set in the I DLE P OWEROFF setting (see above).
C HAPTER 6. G ENERAL S ETTINGS 35 With the two R ECENT O NLY options, nothing is written to the .bmark file. If the M AINTAIN A LIST OF R ECENTLY U SED B OOKMARKS option is enabled, the bookmarking information will however be added to recent bookmarks list. Note: The R ESUME function remembers your position in the most recently accessed track regardless of how the B OOKMARK ON S TOP option is set. N Load Last Bookmark.
C HAPTER 6. G ENERAL S ETTINGS 36 • Setting the Sound Option C HANNELS to K ARAOKE may disable voice menus. • Plugins do not support voice features. Voice Directories. This option turns on the speaking of directory names. The player is not powerful enough to produce these voices in real time, so a number of options are available. N .talk mp3 clip. Use special pre-recorded MP3 files ( dirname.talk) in each directory.
C HAPTER 7. P LUGINS 37 7. Plugins SI O N Plugins are little programs that Rockbox can load and run. Only one plugin can be loaded at a time. Plugins have exclusive control over the user interface. This means you cannot switch back and forth between a plugin and Rockbox, a plugin is loaded, run and then exited, which returns control to Rockbox. Most plugins will not interfere with music playback but some of them will stop playback while running. Plugins have the file extension .rock.
C HAPTER 7. P LUGINS 38 7.1.2. Nim N Figure 7.2.: Nim SI O Rules of Nim: There are 21 matches. Two players (you and the Jukebox) alternately pick a certain number of matches and the one who takes the last match loses. You can take up to twice as many matches as the Jukebox selected, and vice versa. Action Minus Plus Play Stop Decrease the number of matches Increase the number of matches Remove the number of matches you have selected Exit the game 7.2.1. Credits V 7.2.
Action On Play Menu Plus/Minus On+ Plus/Minus Menu+ Plus/Minus Stop Display at maximum frame rate Pause Cycle draw mode Increase / decrease x axis Increase / decrease y axis Increase / decrease z axis Quit 7.2.3. Logo SI Demo showing the Rockbox logo bouncing around the screen. O Key N C HAPTER 7. P LUGINS Action Plus / Minus Increase / decrease speed on the xaxis Increase / decrease speed on the yaxis Quit ER Key On+Plus/ On+Minus RA FT 7.2.4. Mosaic V Stop Figure 7.4.
C HAPTER 7. P LUGINS 40 7.2.5. Snow N Figure 7.5.: Have you ever seen snow falling? O This demo replicates snow falling on your screen. If you love winter, you will love this demo. Or maybe not. Press Stop to quit. SI 7.3. Viewers ER Viewers are plugins which are associated with specific file extensions. They cannot be run directly but are started by “playing” the associated file. Viewers are stored in the /.rockbox/viewers/ directory. 7.3.1. Search 7.3.2.
C HAPTER 7. P LUGINS 41 Chop breaks lines at the maximum column limit. Line mode cycles through Normal, Join and Expand. Normal breaks lines at newline characters. Join ignores unpaired newline characters (i.e., joins lines). Useful for adopting the orphans that occur with e-mail style (i.e.,pre-wrapped) text files. N Expand doubles unpaired newlines (i.e., adds a blank line). Useful for making the paragraphs clearer in some book style text files. O View mode toggles between Narrow and Wide.
C HAPTER 7. P LUGINS 42 7.3.4. VBRfix b N This function scans a VBR (Variable Bitrate) MP3 file and updates/creates the Xing VBR header. The Xing header contains information about the VBR stream used to calculate average bit rate, time information and to more accurately fwd/rew in the stream. This function is especially useful when the playback of a file skips, fwd/rew does not work correctly or the time display is incorrect.
C HAPTER 7. P LUGINS 43 7.4.2. Battery Benchmark N The Battery Benchmark Plugin enables you to test your battery’s performance, while making normal use of your player. Once loaded it will run in the background (TSR plugin), reading various info about your battery while you use it. Once you finish your session you can find the benchmark output data in a file on your player /battery bench.txt. Please submit your results to the Rockbox wiki. http://www.rockbox.
C HAPTER 7. P LUGINS 44 Time Left It shows the estimated (by Rockbox) remaining time until shutdown. Again, as Level, this column can be used to see differences between real time left and estimated time left. This could help make time left more accurate. N Voltage The current, battery voltage, the moment the measurement was captured. Measurements are captured when this number changes while benchmarking. This column can be used to give quite interesting graphs in a spreadsheet program. (Excel, Calc, e.t.
C HAPTER 7. P LUGINS 45 Setup Action Plus/Minus Play Stop Increase / decrease displayed Value Move to next screen Move to previous screen N Key • First enter the number of players (1–10) O • Then set the total game time in mm:ss ER • Done. Player 1 starts in paused mode. SI • Then the maximum round time is entered. For example, this could be used to play Scrabble for a maximum of 15 minutes each, with each round taking no longer than one minute.
C HAPTER 7. P LUGINS 46 Action Minus/Plus Play/Stop On Menu Pick between type and number of dice Select number of sides or number of dice Roll dice Quit N Key 7.4.5. Euro Converter SI O [Warning: Image ignored] Euro converter This plugin converts euros back into pre-euro currency. The country for which is does this is selectable by pressing the MENU key. The MINUS and PLUS keys move the cursor between the digits and the PLAY and STOP keys increase and decrease the current digit.
C HAPTER 7. P LUGINS 47 7.4.8. Stats N Figure 7.8.: The stats-plugin O The stats-plugin simply counts the number of files and folders on your player. Press Stop to exit the plugin. SI 7.4.9. Stopwatch WARNING! Image not found ER Figure 7.9.: Stopwatch Keys are as follows: V A simple stopwatch program with support for saving times.
C HAPTER 8. A DVANCED T OPICS 48 8. Advanced Topics N 8.1. Customising the userinterface 8.1.1. Getting Extras (Fonts, Languages) SI O Rockbox supports custom fonts (for the Recorder and Ondio only) and a number of different languages. Rockbox comes with several fonts and languages already included. If new fonts have been created, then they will be found in the font package at http: //www.rockbox.org/daily.shtml. The latest .lng files are always included in the daily Rockbox builds. ER 8.1.2.
C HAPTER 8. A DVANCED T OPICS 49 /.rockbox folder, it will be remembered and used after reboot. The .wps filename must be no more than 24 characters long for it to be remembered. 8.2.2. WPS – Build Your Own SI • All characters not preceded by % are displayed as typed. O N Quite simply, enter the WPS code in your favourite text editor, Notepad on Windows works fine. When you save it, instead of saving it as a .txt file, save it as a .wps file. Example: Instead of Rockbox.
C HAPTER 8. A DVANCED T OPICS 50 If you use the upper-case versions of the three tags: F, I and D, they will instead refer to the next song instead of the current one. Example: %Ig is the genre name used in the next song and %Ff is the mp3 frequency. Note: The next song information will not be available at all times, but will most likely be available at the end of a song.
C HAPTER 8. A DVANCED T OPICS 51 • repeat. . . If the ID3 artist and title are not present: • Display the filename continuously. N Note that by using a subline display time of 0 in one branch of a conditional, a subline can be skipped (not displayed) when that condition is met. Using Images O You can have as many as 52 images in your WPS. There are various ways of displaying images: 1. Load and always show the image, using the %x tag ER Example on bitmap preloading and use: SI 2.
C HAPTER 8. A DVANCED T OPICS 52 N A configuration file may reside anywhere on the hard disk. Multiple configuration files are permitted. So, for example, you could have a car.cfg file for the settings that you use while playing your jukebox in your car, and a headphones.cfg file to store the settings that you use while listening to your player through headphones. See section 8.3.2 (page 52) below for an explanation of the format for configuration files. See section 8.3.
C HAPTER 8. A DVANCED T OPICS 53 8.3.3. The M ANAGE S ETTINGS menu The M ANAGE S ETTINGS menu can be found in the M AIN M ENU. The M ANAGE S ETTINGS menu allows you to save and load .cfg files. The M ANAGE S ETTINGS menu also allows you to load or save different firmware versions. N Browse .cfg Files. Opens the file browser in the /.rockbox directory and displays all .cfg (configuration) files. Selecting a .cfg file will cause Rockbox to load the settings contained in that file.
C HAPTER 8. A DVANCED T OPICS 54 8.5. Rockbox in flash These instructions are outdated!!. This section is a copy of the wikipage FlashingRockbox revision r.1.19. Warning: Flashing Rockbox is optional. It is not required for using Rockbox on your Archos Jukebox Studio 5000, 6000, Player 10 and 20. Please read the whole section thoroughly before flashing. N 8.5.1. Introduction ! 8.5.2. Terminology ER Firmware: The flash ROM content as a whole.
C HAPTER 8. A DVANCED T OPICS 55 • The second one is called rockbox flash.rock and is used to reprogram only the second image. It won’t touch any other byte, should be safe to fool around with. If the programmed firmware is inoperational, you can still use the Minus start with the Archos firmware and Rockbox booted from disk to try better. O N The non-user tools are in the flash subdirectory of the cvs source files.
C HAPTER 8. A DVANCED T OPICS 56 from flash is not 100% stable for everyone, you can still use the box, reflash the second image with an updated Rockbox copy, etc. The flash chip being used by Archos is specified for 100,000 cycles, so you don’t need to worry about that wearing out. 8.5.5. Requirements N You need two things: • The first is a Archos Jukebox Studio 5000, 6000, Player 10 and 20. Be sure you’re using the correct package, they are different! ER 8.5.6.
C HAPTER 8. A DVANCED T OPICS 57 6. Connect the charger and make sure your batteries are also in good shape. That’s just for security reasons, it’s not that flashing needs more power. N 7. Run the firmware flash.rock plugin. It again tells you about your flash and the file it’s gonna program. After Minus it checks the file. Your hardware mask value will be kept, it won’t overwrite it. Hitting On gives you a big warning.
C HAPTER 8. A DVANCED T OPICS 58 1. Normally, you’ll simply download a .zip distribution. Copy all the content to the USB drive, replacing the old. 2. Force a disk boot by holding Minus during power-up, or at least rolo into the new Rockbox version by Playing the ajbrec.ajz/fnamearchos.mod file. This may not always be necessary, but it’s better to first run the version you’re about to flash. It is required if you are currently running RomBox. O N 3. Just play the .ucl file in the .
C HAPTER 8. A DVANCED T OPICS 59 a CRC value of 0x222F in the hardware info screen. Without a boot ROM there is no UART boot safety net. To compensate for that as much as possible the MiniMon monitor is included, it starts with Plus+On. Using that the box can be reprogrammed via serial if the first 2000 bytes of the flash are OK. 8.5.10. Download the new flash content file to your box D RA FT V ER SI O N These links are not valid.
A PPENDIX A. F ILE FORMATS 60 A. File formats Extension Action when selected Directory Audio file none mp3 Wave Audio File Playlist .wav .m3u Rockbox firmware While Playing Screen .mod .wps Language File Text File .lng .
A PPENDIX B. WPS TAGS 61 B. WPS Tags %we %wd Status Bar Enabled Status Bar Disabled O Description SI Tag N B.1. Status Bar ER These tags override the player setting for the display of the status bar. They must be noted on their own line. B.2. ID3 Info Description %ia %ic %id %ig %in %it %iv %iy ID3 Artist ID3 Composer ID3 Album Name ID3 Genre Name ID3 Track Number ID3 Track Title ID3 Version (1.0, 1.1, 2.2, 2.3, 2.
A PPENDIX B. WPS TAGS 62 B.3. Power Related Information Description %bl Show numeric battery level in percent. Can also be used in a conditional: %?bl<0|1|2|3|4> Show the battery level in volts Show estimated battery time left “p” if the charger is connected (only on targets that can charge batteries) “c” if the unit is currently charging the battery (only on targets that have software charge control or monitoring) Sleep timer.
A PPENDIX B. WPS TAGS 63 B.5. Playlist/Song Info Description %pb Progress Bar This will display a 1 character “cup” that empties as the time progresses. Full-line progress bar & time display Current Time In Song Total Number of Playlist Entries Peak Meter (Recorder only) The entire line is used as volume peak meter. Playlist Name (Without path or extension) Playlist Position Remaining Time In Song Shuffle. Shows ’s’ if shuffle mode is enabled. Total Track Time Current volume.
A PPENDIX B. WPS TAGS 64 Example: %?mm B.9. Playback Mode Tags Description %mp Play status, 0-4, in the order: Stop, Play, Pause, Fast forward, Rewind N Tag O Example: %?mp SI B.10. Images Description %P|filename.bmp| Load a Progress bar image for the WPS. Use %pb tag to show the progress bar Load and display an image n: image ID (a-z and A-Z) filename: filename relative to /.rockbox/ and including .bmp x: x coordinate y: y coordinate.
A PPENDIX B. WPS TAGS 65 • The size of the LCD screen for each player varies. See table below for appropriate sizes of each device. The x and y coordinates must repect each of the players’ limits. %al %ac %ar Text is left aligned Text is center aligned Text is right aligned O Description SI Tag N B.11. Alignment B.12. Conditional Tags Tag ER All alignment tags may be present in one line, but they need to be in the order left – center – right. If the aligned texts overlap, they are merged.
A PPENDIX C. C ONFIG FILE OPTIONS 66 C. Config file options N C.1.
A PPENDIX C. C ONFIG FILE OPTIONS seconds mAh minutes O N N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A 0.
A PPENDIX D. LCD S CREEN S IZES 68 D.
A PPENDIX E. U SER FEEDBACK 69 E. User feedback N E.1. Bug reports E.1.1. Rules for submitting new bug reports SI O If you experience inappropriate performance from any supported feature, please file a bug report on our web page. Do not report missing features as bugs, instead file them as feature requests (see below). For open bug reports refer to http://www.rockbox.org/tracker/index.php?type=2 1. Check that the bug hasn’t already been reported ER 2.
A PPENDIX E. U SER FEEDBACK 70 E.2.2. Features we will not implement This is a list of Feature Requests we get repeatedly that we simply cannot do. View it as the opposite of a TODO! • Record to WAV (uncompressed) or MP3pro format! The recording hardware (the MAS) does not allow us to do this N • Crossfade between tracks! Crossfading would require two mp3 decoders, and we only have one. This is not possible.
A PPENDIX E. U SER FEEDBACK 71 N • Interfacing with other USB devices (like cameras) or 2 player games over USB The USB system demands that there is a master that talks to a slave. The player can only serve as a slave, as most other USB devices such as cameras can. Thus, without a master no communication between the slaves can take place.
A PPENDIX F. C HANGELOG 72 F. Changelog N F.1. What’s new since v2.5? D RA FT V ER SI O Changes in version 2.
A PPENDIX G. C REDITS 73 G.
A PPENDIX G.
A PPENDIX H. GNU F REE D OCUMENTATION L ICENCE 75 H. GNU Free Documentation Licence O 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA N Version 1.2, November 2002 Copyright c 2000,2001,2002 Free Software Foundation, Inc. Preamble SI Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
A PPENDIX H. GNU F REE D OCUMENTATION L ICENCE 76 D RA FT V ER SI O N A ”Secondary Section” is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document’s overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.
A PPENDIX H. GNU F REE D OCUMENTATION L ICENCE 77 2. VERBATIM COPYING N serve the Title” of such a section when you modify the Document means that it remains a section ”Entitled XYZ” according to this definition. The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document.
A PPENDIX H. GNU F REE D OCUMENTATION L ICENCE 78 It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document. 4.
A PPENDIX H. GNU F REE D OCUMENTATION L ICENCE 79 J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the ”History” section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission. N K.
A PPENDIX H. GNU F REE D OCUMENTATION L ICENCE 80 SI O N You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.
A PPENDIX H. GNU F REE D OCUMENTATION L ICENCE 81 O N Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections.
A PPENDIX H. GNU F REE D OCUMENTATION L ICENCE 82 Back-Cover Texts. A copy of the license is included in the section entitled ”GNU Free Documentation License”. If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the ”with...Texts.” line with this: O N with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.