The Rockbox Manual for Packard Bell Vibe 500 rockbox.
Rockbox http://www.rockbox.org/ Open Source Jukebox Firmware Rockbox and this manual is the collaborative effort of the Rockbox team and its contributors. See the appendix for a complete list of contributors. c 2003-2011 The Rockbox Team and its contributors, c 2004 Christi Alice Scarborough, c 2003 José Maria Garcia-Valdecasas Bernal & Peter Schlenker. Version 3.10. Built using pdfLATEX.
Contents Contents 1. Introduction 1.1. Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2. Getting more help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3. Naming conventions and marks . . . . . . . . . . . . . . . . . . . . . . . . 11 11 11 12 2. Installation 2.1. Before Starting . . . . . . . . . . . . . . . . 2.2. Installing Rockbox . . . . . . . . . . . . . . 2.2.1. Automated Installation . . . . . . . 2.2.2. Manual Installation . . . . . . .
Contents 4.2. Database . . . . . . . . . . . . . 4.2.1. Introduction . . . . . . . 4.2.2. Initializing the Database . 4.2.3. The Database Menu . . . 4.2.4. Using the Database . . . 4.3. While Playing Screen . . . . . . . 4.3.1. WPS Key Controls . . . . 4.3.2. Peak Meter . . . . . . . . 4.3.3. The WPS Context Menu 4.4. Working with Playlists . . . . . . 4.4.1. Playlist terminology . . . 4.4.2. Creating playlists . . . . . 4.4.3. Adding music to playlists 4.4.4. Modifying playlists . . . . 4.4.5.
Contents 6.4. Balance . . . 6.5. Channels . . 6.6. Stereo Width 6.7. Crossfeed . . 6.8. Equalizer . . 6.9. Dithering . . 6.10. Timestretch . 6.11. Compressor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. Playback Settings 7.1. Shuffle . . . . . . . . . . 7.2. Repeat . . . . . . . . . . 7.3. Play Selected First . . . 7.4. Fast-Forward/Rewind . 7.5. Anti-Skip Buffer . . . . 7.6. Fade on Stop/Pause . . 7.7. Party Mode . . . . . . . 7.8.
Contents 8.7. Automatic 8.8. Language 8.9. Voice . . . 8.10. Hotkey . . resume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. Theme Settings 73 10.Recording Settings 10.1. Format . . . . . . . . . . . . . 10.2.
Contents 12.1.21.Robotfindskitten . . . 12.1.22.Rockblox . . . . . . . 12.1.23.Rockblox1d . . . . . . 12.1.24.Rocklife . . . . . . . . 12.1.25.Sliding Puzzle . . . . . 12.1.26.Snake . . . . . . . . . 12.1.27.Snake 2 . . . . . . . . 12.1.28.Sokoban . . . . . . . . 12.1.29.Solitaire . . . . . . . . 12.1.30.Spacerocks . . . . . . 12.1.31.Star . . . . . . . . . . 12.1.32.Sudoku . . . . . . . . 12.1.33.Wormlet . . . . . . . . 12.1.34.Xobox . . . . . . . . . 12.2. Demos . . . . . . . . . . . . . 12.2.1.
Contents 12.3.15.VBRfix . . . . . . . . . 12.3.16.ZXBox . . . . . . . . . . 12.4. Applications . . . . . . . . . . . 12.4.1. Alarm Clock . . . . . . 12.4.2. Battery Benchmark . . 12.4.3. Calculator . . . . . . . . 12.4.4. Calendar . . . . . . . . 12.4.5. Chess Clock . . . . . . . 12.4.6. Clock . . . . . . . . . . 12.4.7. Disk Tidy . . . . . . . . 12.4.8. Keybox . . . . . . . . . 12.4.9. Lamp . . . . . . . . . . 12.4.10.Lrcplayer . . . . . . . . 12.4.11.md5sum . . . . . . . . . 12.4.12.Metronome . . . . .
Contents 13.5.2. 13.5.3. 13.5.4. 13.5.5. 13.5.6. Display power-off . . . . . Anti-Skip Buffer . . . . . Replaygain . . . . . . . . Audio format and bitrate Sound settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 168 168 168 168 A. File formats 169 A.1. Supported file formats .
Contents C.21.3. How to display the album art C.22.Alignment and language direction . . C.23.Conditional Tags . . . . . . . . . . . C.24.Subline Tags . . . . . . . . . . . . . C.25.Time and Date . . . . . . . . . . . . C.26.Text Translation . . . . . . . . . . . C.27.Bar Tags . . . . . . . . . . . . . . . . C.27.1. Options . . . . . . . . . . . . C.28.Other Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 1. Introduction 11 1. Introduction 1.1. Welcome This is the manual for Rockbox. Rockbox is an open source firmware replacement for a growing number of digital audio players. Rockbox aims to be considerably more functional and efficient than your device’s stock firmware while remaining easy to use and customisable. Rockbox is written by users, for users.
Chapter 1. Introduction 12 main channel for Rockbox is #rockbox on irc://irc.freenode.net. Many helpful developers and users are usually around. Just join and ask your question (don’t ask to 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 so that you can join the Rockbox IRC channel without needing to install additional software onto your computer.
Chapter 2. Installation 2. Installation Installing Rockbox is generally a quick and easy procedure. However before beginning there are a few important things to know. 2.1. Before Starting USB connection. To transfer Rockbox to your player you need to connect it to your computer. For manual installation/uninstallation, or should autodetection fail during automatic installation, you need to know where to access the player.
Chapter 2. Installation The Rockbox bootloader. The Rockbox bootloader is loaded from disk by the Packard Bell bootloader. It is responsible for loading the Rockbox firmware and for providing the dual boot function. It directly replaces the Packard Bell firmware in the player’s boot sequence. The Rockbox firmware. Similar to the Packard Bell firmware, most of the Rockbox code is contained in a “build” that resides on your player’s drive. This makes it easy to update Rockbox.
Chapter 2. Installation Choosing a Rockbox version There are three different versions of Rockbox available from the Rockbox website: Release version, current build and archived daily build. You need to decide which one you want to install and get the appropriate version for your player. If you select either “Minimal Installation” or “Complete Installation” from the “Quick Start” tab, then Rockbox Utility will automatically install the release version of Rockbox.
Chapter 2. Installation 3. Take the .zip file that you downloaded and use the “Extract all” command of your unzip program to extract the files onto your player. Note: The entire contents of the .zip file should be extracted directly to the root of your player’s drive. Do not try to create a separate directory on your player for the Rockbox files! The .zip file already contains the internal structure that Rockbox needs. b If the contents of the .
Chapter 2. Installation 2.3. Running Rockbox When you turn the unit on, Rockbox should load. 2.4. Updating Rockbox Rockbox can be easily updated with Rockbox Utility. You can also update Rockbox manually – download a Rockbox build as detailed above, and unzip the build to the root directory of your player as in the manual installation stage. If your unzip program asks you whether to overwrite files, choose the “Yes to all” option. The new build will be installed over your current build.
Chapter 2. Installation 18 extracting the contents of the .zip file to the proper location, and should not happen when Rockbox has been installed with Rockbox Utility. To fix this, either install Rockbox with the Rockbox Utility which will take care of this for you, or recheck the Manual Install section to see where the files need to be located. The Rockbox manual (version 3.
Chapter 3. Quick Start 3. Quick Start 3.1. Basic Overview 3.1.1. The player’s controls Hold Power Rec Scroll Up OK Menu Play Prev Next Scroll Down Cancel Throughout this manual, the buttons on the player are labelled according to the picture above. Whenever a button name is prefixed by “Long”, a long press of approximately one second should be performed on that button. The buttons are described in detail in the following paragraph.
Chapter 3. Quick Start controls are disabled. Be sure Hold is off before trying to use your player. On the top on the player is the internal microphone on the left and the line-in socket on the right, near the headphone socket. 3.1.2. Turning the player on and off To turn on and off your Rockbox enabled player use the following keys: Key Action Power Long Power Start Rockbox Shutdown Rockbox On shutdown, Rockbox automatically saves its settings.
Chapter 3. Quick Start 21 3.1.5. The first contact After you have first started the player, you’ll be presented by the Main Menu. From this menu you can reach every function of Rockbox, for more information (see section 5.1 (page 40)). To browse the files on your player, select Files (see section 4.1 (page 23)), and to browse in a view that is based on the meta-data1 of your audio files, select Database (see section 4.2 (page 27)). 3.1.6.
Chapter 3. Quick Start 22 the currently playing file. Also there are some actions that do not apply to the current file but refer to the screen from which the context menu gets called. One example is the playback menu, which can be called using the context menu from within the WPS. 3.2. Customising Rockbox Rockbox’ User Interface can be customised using “Themes”.
Chapter 4. Browsing and playing 23 4. Browsing and playing 4.1. File Browser Figure 4.1.: The file browser Rockbox lets you browse your music in either of two ways. The File Browser lets you navigate through the files and directories on your player, entering directories and executing the default action on each file. To help differentiate files, each file format is displayed with an icon.
Chapter 4. Browsing and playing 4.1.1. File Browser Controls Key Action Scroll Up/Scroll Down Go to previous/next item in list. If you are on the first/last entry, the cursor will wrap to the last/first entry. Go to the parent directory. Execute the default action on the selected file or enter a directory. If there is an audio file playing, return to the While Playing Screen (WPS) without stopping playback. Stop audio playback. Enter the Context Menu. Enter the Main Menu.
Chapter 4. Browsing and playing The Context Menu contains the following options (unless otherwise noted, each option pertains both to files and directories): Playlist. Enters the Playlist Submenu (see section 4.4.3 (page 37)). Playlist Catalogue. Enters the Playlist Catalogue Submenu (see section 4.4.2 (page 36)). Rename. This function lets the user modify the name of a file or directory. Cut. Copies the name of the currently selected file or directory to the clipboard and marks it to be ‘cut’. Copy.
Chapter 4. Browsing and playing Add to Shortcuts. Adds a link to the selected item in the shortcuts.link file. If the file does not already exist it will be created in the root directory. Note that if you create a shortcut to a file, Rockbox will not open it upon selecting, but simply bring you to its location in the File Browser. 4.1.3. Virtual Keyboard Figure 4.3.
Chapter 4. Browsing and playing Key Action Prev / Next Move the cursor on the virtual keyboard. If you move out of the picker area, you get the previous/next page of characters (if there is more than one). Move the cursor on the virtual keyboard. If you move out of the picker area you get to the line edit mode. Insert the selected keyboard letter at the current line cursor position. Exit the virtual keyboard and save any changes. Exit the virtual keyboard without saving any changes.
Chapter 4. Browsing and playing that directory and all its subdirectories from scanning their tags and adding them to the database. This will speed up the database initialization. If a subdirectory of an ‘ignored’ directory should still be scanned, place a file named database.unignore in it. The files in that directory and its subdirectories will be scanned and added to the database. 4.2.3.
Chapter 4. Browsing and playing 29 Import Modifications. Allows the /.rockbox/database_changelog.txt backup to be conveniently loaded into the database. If Auto Update is enabled this is performed automatically when the database is initialized. 4.2.4. Using the Database Once the database has been initialized, you can browse your music by Artist, Album, Genre, Song Name, etc. To use the database, go to the Main Menu and select Database.
Chapter 4.
Chapter 4. Browsing and playing • The ID3 album name. • The ID3 artist name. • Bit rate. VBR files display average bitrate and “(avg)” • Elapsed and total time. • A slidebar progress meter representing where in the song you are. • Peak meter. See section 13.2 (page 159) for details of customising your WPS (While Playing Screen). 4.3.1. WPS Key Controls Key Action Scroll Up / Scroll Down Prev Volume up/down.
Chapter 4. Browsing and playing 4.3.2. Peak Meter The peak meter can be displayed on the While Playing Screen and consists of several indicators. For a picture of the peak meter, please see the While Recording Screen in section 5.8.1 (page 43). The bar: This is the wide horizontal bar. It represents the current volume value. The peak indicator: This is a little vertical line at the right end of the bar. It indicates the peak volume value that occurred recently.
Chapter 4. Browsing and playing Playlist catalogue View catalogue. This lists all playlists that are part of the Playlist catalogue. You can load a new playlist directly from this list. Add to playlist. Adds the currently playing file to a playlist. Select the playlist you want the file to be added to and it will get appended to that playlist. Add to new playlist. Similar to the previous entry this will add the currently playing track to a playlist. You need to enter a name for the new playlist first.
Chapter 4. Browsing and playing 34 is stored in audio file formats to keep information on artist, album etc. To access this screen, press Long Menu to access the WPS Context Menu and select Show Track Info. Open With... This Open With function is the same as the Open With function in the file browser’s Context Menu. Delete Delete the currently playing file. The file will be deleted but the playback of the file will not stop immediately. Instead, the part of the file that has already been buffered (i.e.
Chapter 4. Browsing and playing Key Action Play Toggle pitch changing mode (cycle through all available modes). Increase / Decrease pitch by 0.1% (in procentual mode) or 0.1 semitone (in semitone mode). Temporarily change pitch by 2% (beatmatch), or modify speed (in timestretch mode). Reset pitch and speed to 100%. Leave the Pitch Screen. Scroll Up / Scroll Down Prev / Next Menu OK 4.4. Working with Playlists 4.4.1.
Chapter 4. Browsing and playing 36 By selecting (“playing”) a song from the File Browser Whenever a song is selected from the File Browser with Next, Rockbox will automatically create a playlist containing all of the songs in that directory and start playback with the selected song. Note: If you already have created a dynamic playlist, playing a new song will erase the current dynamic playlist and create a new one.
Chapter 4. Browsing and playing 4.4.3. Adding music to playlists Adding music to a dynamic playlist Figure 4.5.: The Playlist Submenu The Playlist Submenu is a submenu in the Context Menu (see section 4.1.2 (page 24)), it allows you to put tracks into a “dynamic playlist”. If there is no music currently playing, Rockbox will create a new dynamic playlist and put the selected track(s) into it. If there is music currently playing, Rockbox will put the selected track(s) into the current playlist.
Chapter 4. Browsing and playing 38 Play Next. Replaces all but the current playing track with track(s). Current playing track is queued. The Playlist Submenu can be used to add either single tracks or entire directories to a playlist. If the Playlist Submenu is invoked on a single track, it will put only that track into the playlist. On the other hand, if the Playlist Submenu is invoked on a directory, Rockbox adds all of the tracks in that directory to the playlist.
Chapter 4. Browsing and playing 39 4.4.6. Loading saved playlists Through the File Browser Playlist files, like regular music tracks, can be selected through the File Browser. When loading a playlist from disk it will replace the current dynamic playlist. Through the Playlist catalogue The Playlist catalogue offers a shortcut to all playlists in your player’s specified playlist directory. It can be used like the File Browser. 4.4.7.
Chapter 5. The Main Menu 5. The Main Menu 5.1. Introducing the Main Menu Figure 5.1.: The main menu The Main Menu is the screen from which all of the Rockbox functions can be accessed. This is the first screen you will see when starting Rockbox. To return to the Main Menu, press the Menu button. All settings are stored on the unit. However, Rockbox does not access the hard disk solely for the purpose of saving settings.
Chapter 5. The Main Menu 5.3. Recent Bookmarks Figure 5.2.: The list bookmarks screen If the Save 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. Note: Bookmarking only works when tracks are launched from the file browser, and does not currently work for tracks launched via the database. In addition, they do not currently work with dynamic playlists.
Chapter 5. The Main Menu 5.5. Database Browse by the meta-data in your audio files (see section 4.2 (page 27)). 5.6. Now Playing/Resume Playback Go to the While Playing Screen and resume if music playback is stopped or paused and there is something to resume (see section 4.3 (page 30)). 5.7. Settings The Settings menu allows you to set or adjust many parameters that affect the way your player works. There are many submenus for different parameter areas.
Chapter 5. The Main Menu 5.7.6. Manage Settings The Manage Settings option allows the saving and re-loading of user configuration settings, browsing the hard drive for alternate firmwares, and finally resetting your player back to initial configuration. The details of this menu are covered in section 13.3 (page 165). 5.8. Recording 5.8.1. While Recording Screen Figure 5.3.
Chapter 5. The Main Menu Key Action Scroll Up / Scroll Down Prev / Next Play Select setting. Cancel Rec Long Menu Adjust selected setting. Start recording. While recording: pause recording (press again to continue). Exit Recording Screen. While recording: Stop recording. Start recording. While recording: close the current file and open a new one. Open Recording Settings (see section 10 (page 75)). 5.9. Playlists This menu allows you to work with playlists. Playlists can be created in three ways.
Chapter 5. The Main Menu 5.11. System 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). The battery status. Hard disk size and the amount of free space on the disk. Credits: Display the list of contributors. Running Time: Shows the runtime of your player in hours, minutes and seconds.
Chapter 6. Sound Settings 6. Sound Settings Figure 6.1.: The sound settings screen The sound settings menu offers a selection of sound settings you may change to customise your listening experience. 6.1. Volume This setting adjusts the volume of your music. Like most professional audio gear and many consumer audio products, Rockbox uses a decibel scale where 0 dB is a reference that indicates the maximum volume that the player can produce without possible distortion (clipping).
Chapter 6. Sound Settings setting is -24 dB and the maximum is 24 dB. 6.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. 6.5. Channels A stereo audio signal consists of two channels, left and right.
Chapter 6. Sound Settings 6.7. Crossfeed Crossfeed attempts to make the experience of listening to music on headphones more similar to listening to music with stereo speakers. When you listen to music through speakers, each ear will hear sound originating from both speakers. However, the sound from the left speaker reaches your right ear slightly later than it does your left ear, and vice versa.
Chapter 6. Sound Settings 6.8. Equalizer Figure 6.2.: The graphical equalizer Rockbox features a parametric equalizer (EQ). As the name suggests, a parametric EQ lets you control several different parameters for each band of the EQ. In some ways the EQ is similar to the Bass and Treble settings described earlier, but the EQ allows you to control the sound much more carefully. Rockbox’s parametric EQ is composed of five different bands: Band 0: Low shelf filter.
Chapter 6. Sound Settings except that it works on the high end of the frequency spectrum rather than the low end. As a general guide, EQ band 0 should be used for low frequencies, EQ bands 1 through 3 should be used for mids, and EQ band 4 should be used for highs. Enable EQ. This option controls whether the EQ is on or off. Graphical EQ.
Chapter 6. Sound Settings 51 6.9. Dithering This setting controls the dithering and noise shaping functionality of Rockbox. Most of Rockbox’ audio file decoders work at a higher bit depth than the 16 bits used for output on the player’s audio connectors. The simplest way to convert from one bit depth to another is simply discarding all the surplus bits. This is the default behaviour, and adds distortion to the signal that will vary in character along with the desired sound.
Chapter 6. Sound Settings 52 amplify the signal so that the loudest possible signal after compression will be just under the clipping limit. This is desirable because the compressed signal without makeup gain is quieter than the input signal. Makeup Gain in Auto restores the signal to the maximum possible level and brings the quieter audio up with it. This is what makes it possible to hear the quieter audio in noisy environments.
Chapter 7. Playback Settings 7. Playback Settings The Playback Settings menu allows you to configure settings related to audio playback. 7.1. Shuffle Turning shuffle on will cause Rockbox to randomly re-order the playlist. Thus, to shuffle all of the audio files on the player, you first need to create a playlist containing all of them. For more information on creating playlists refer to section 4.4 (page 35). Options: Yes/No. 7.2.
Chapter 7. Playback Settings 54 7.3. Play Selected First This setting controls what happens when you select a file for playback while shuffle mode is on. If the Play Selected First setting is Yes, the file you selected will be played first. If this setting is No, a random file in the directory will be played first. 7.4. Fast-Forward/Rewind These settings control the speed and acceleration during fast forward and rewind.
Chapter 7. Playback Settings the track, moving to the next track in the playlist without user intervention. A manual track skip goes to the next track immediately when the appropriate button is pressed. Options for crossfade settings are: Enable Crossfade. If set to Off, crossfade is disabled and all track changes are gapless. If set to Automatic Track Change Only, crossfade occurs for automatic track changes, but not for manual track skips.
Chapter 7. Playback Settings 56 7.9. Replaygain This allows you to control the replaygain function. The purpose of replaygain is to adjust the volume of the music played so that all songs (or albums, depending on your settings) have the same apparent volume. This prevents sudden changes in volume when changing between songs recorded at different volume levels. For replaygain to work, the songs must have been processed by a program that adds replaygain information to the ID3 tags (or Vorbis tags).
Chapter 7. Playback Settings 57 Pre-amp. This allows you to adjust the volume when replaygain is applied. Replaygain often lowers the volume, sometimes quite much, so here you can compensate for that. Please note that a (large) positive pre-amp setting can cause clipping, unless prevent clipping is enabled. The pre-amp can be set to any decibel (dB) value between -12 dB and +12 dB, in increments of 0.5 dB. 7.10.
Chapter 7. Playback Settings 58 the information from the ID3 tags. When you enable this option, you’ll have to reboot for it to come into effect. 7.14. Skip Length Designed to speed up navigation when listening to long audio tracks, Skip Length changes the behaviour of the Prev and Next buttons so that they skip by a given time instead of skipping to a new track.
Chapter 8. General Settings 8. General Settings Figure 8.1.: The general settings screen 8.1. Playlist The Playlist sub menu allows you to configure settings related to playlists. Recursively Insert Directories. If set to On, then when a directory is inserted or queued into a dynamic playlist, all subdirectories will also be inserted. If set to Ask, Rockbox will prompt the user about whether to include sub-directories. Warn When Erasing Dynamic Playlist.
Chapter 8. General Settings Interpret numbers when sorting. As whole numbers enables a sorting algorithm which is similar to the default sorting of, for example, Windows Explorer, Mac OS X’s Finder or Nautilus, with regards to numbers at the beginning or within filenames. It combines consecutive digits to a number used for sorting, taking leading zeros into account. As digits disables this algorithm, and causes every digit to be compared separately.
Chapter 8. General Settings 61 If Follow Playlist is set to No, when you enter the File Browser from the WPS, you will find yourself in the directory you were in when you last left the File Browser. Show Path. If this setting is set to Full Path the full path to the current directory will be displayed on the first line in the File Browser. If set to Current Directory Only only the name of the current directory will be displayed. This has a similar effect on the Database browser.
Chapter 8. General Settings display saves battery power but turning on the display takes noticeably longer than just turning on the backlight. Brightness. Changes the brightness of your LCD display. 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! LCD Mode. This setting lets you invert the colours of the display. Upside Down. Displays the screen so that the top of the display is nearest the buttons.
Chapter 8. General Settings List Acceleration Speed. This setting controls how fast the scroll speed accelerates. The scroll speed will increase every N seconds. For example, selecting Speed up every 3s will increase the scroll speed every 3 seconds while Scroll Up or Scroll Down is held. Peak Meter. The peak meter can be configured with a number of parameters. Peak Release. This determines how fast the bar shrinks when the music becomes softer. Lower values make the peak meter look smoother.
Chapter 8. General Settings 8.5. System 8.5.1. Start Screen Set the screen that Rockbox will start in. The default is the main menu but the following options are available: Previous Screen. Start Rockbox in the same screen as when it was shut off. Main Menu. Show the main menu. Files. Display the file browser, starting in the root directory of your player. Database. Show the default database view. Resume Playback.
Chapter 8. General Settings Directory Cache. Rockbox has the ability to cache the contents of your drive in RAM. The Directory Cache takes a small amount of memory away from Rockbox that would otherwise be used to buffer music, but it speeds up navigation in the file browser by eliminating the slight pause between the time a navigation button is pressed and the time Rockbox responds. Turning this setting on activates the directory cache, and turning it off deactivates the directory cache.
Chapter 8. General Settings Keyclick. This setting controls how strong the Keyclicks are. keyclicks will be disabled. If set to Off, the Keyclick repeats. This setting turns keyclick repeats On and Off. If set to On, the keyclicks will be repeated when you hold down a button. If set to Off, you will hear only one click. 8.5.8. USB HID This option turns the USB HID feature On and Off.
Chapter 8. General Settings Key Action Play Long Play Prev Next Long Prev Long Next Cancel Menu Scroll Up/ Scroll Down OK Long OK Slideshow start Slideshow leave Slide previous Slide next Slide first Slide last Black screen White screen Previous / next link in slide, respectively Perform a ‘mouse click’ over a link Perform a ‘mouse over’ over a link Browser. This mode lets you control a web browser (e.g. Firefox).
Chapter 8. General Settings Key Action Scroll Up/ Scroll Down/ Prev/ Next Menu Play OK/ Cancel Cursor move up / down / left / right, respectively Left mouse button click Right mouse button click Mouse wheel scroll up / down, respectively 8.6. Bookmarking Bookmarks allow you to save your current position within a track so that you can return to it at a later time. Bookmarks also store rate, pitch and speed information from the Pitch Screen (see section 4.3.3 (page 34)).
Chapter 8. General Settings Update on Stop. If set to “No”, this setting has no effect and does not affect any other settings. If set to “Yes”, and the file to which a new bookmark would be added already exists, this option overrides the previous setting (Bookmark on Stop) and unconditionally creates a bookmark. This is useful if you don’t generally want to create bookmarks but only want to add them to already existing bookmark files.
Chapter 8. General Settings 8.7. Automatic resume The automatic resume feature stores and recalls resume positions for all tracks without user intervention. These resume points are stored in the database, and thus automatic resume only works when the database has been initialized. When automatic resume is enabled, manually selected tracks resume playback at their last playback position.
Chapter 8. General Settings section 13.1.3 (page 156) for further details about languages. 8.9. Voice Voice Menus. This option controls the voicing of menus/settings as they are selected by the cursor. In order for this to work, a voice file must be present in the /.rockbox/langs/ directory on the player. Voice files are large and are not shipped with Rockbox by default. The voice file is the name of the language for which it is made, followed by the extension .voice.
Chapter 8. General Settings On. Use special pre-recorded files for each file. This functions the same as for directories except that the .talk clip file must have the same name as the described file with an extra .talk extension (e.g. Punkadiddle.mp3 would require a file called Punkadiddle.mp3.talk). Off. No checking is made for file .talk clips; they are not used even if present. This can reduce disk activity. Use of a .talk clip takes precedence over other filename voicing. Otherwise (e.g. if a .
Chapter 9. Theme Settings 9. Theme Settings The Theme Settings menu offers options that you can change to customize the visual appearance of Rockbox. Browse Theme Files. This option will display all the currently installed themes on the player, press Next to load the chosen theme and apply it. A theme is 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.
Chapter 9. Theme Settings Status Bar. Allows you to choose where to display the statusbar. Volume Display. Controls whether the volume is displayed as a graphic or a numeric value on the Status Bar. If you select a numeric display, volume is displayed in decibels. See section 6.1 (page 46) for more on the volume setting. Battery Display. Controls whether the battery charge status is displayed as a graphic or numerical percentage value on the Status Bar. Line Selector Type.
Chapter 10. Recording Settings 10. Recording Settings Figure 10.1.: The recording settings screen Note: To change the location where recordings are stored open the Context Menu (see section 4.1.2 (page 24)) on the directory where you want to store them in the File Browser and select Set As Recording Directory. b 10.1. Format Choose which format to save your recording in.
Chapter 10. Recording Settings 10.4. Source Choose the source of the recording. The options are: Microphone and Line In. 10.5. Channels This allows you to select mono or stereo recording. Please note that for mono recording, only the left channel is recorded. Mono recordings are usually somewhat smaller than stereo. 10.6. Mono Mode When configured to record to mono and the source is a stereo signal, use this setting to configure how the mono signal is created. Options are L, R and L+R. 10.7.
Chapter 10. Recording Settings 10.9. Clear Recording Directory Resets the location where the recorded files are saved to the root of your player’s drive. 10.10. Clipping Light Causes the backlight to flash on when clipping has been detected. Options: Off, Main unit only, Main and remote unit, Remote unit only. 10.11. Trigger When you record a source you often are only interested in the sound and not the silence in between.
Chapter 10. Recording Settings pointing to the right. There are two special values. The value Off turns the start condition off. With this setting you have to start the recording manually and the trigger only stops the recording according to the stop condition. The setting -inf sets the trigger to the absolute minimum. This setting only makes sense when you record via a digital input as even the noise of the device itself would exceed this threshold immediately. for at least.
Chapter 11. Time and Date 79 11. Time and Date Time related menu options. Pressing Long Menu will voice the current time if voice support is enabled. Set Time/Date: Set current time and date. Wake-Up Alarm: This option will make the player start up at the specified time. Use Scroll Up and Scroll Down to adjust the minutes setting, Prev and Next to adjust the hours. OK confirms the alarm, and Cancel cancels setting an alarm.
Chapter 12. Plugins 12. Plugins Plugins are 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. When a plugin is loaded, you need to exit it to return to the Rockbox interface. Most plugins will not interfere with music playback but some of them will stop playback while running. Plugins have the file extension .rock.
Chapter 12. Plugins Key Action Prev / Next / Scroll Up / Scroll Down OK Cancel Menu Rec Enter betting amount Hit (Draw new card) / Select Stay (End hand) Double down Pause game and go to menu / Cancel 12.1.2. BrickMania Figure 12.2.: BrickMania BrickMania is a clone of the classic game Breakout. The aim of the game is to destroy all the bricks by hitting them with the ball once or more. Sometimes a special item falls down when you destroy a brick.
Chapter 12. Plugins Key Action Prev or Menu / Next or Play OK or Scroll Up Rec Moves the paddle Release the ball / Fire Open menu / Quit 12.1.3. Bubbles Figure 12.3.: Bubbles The goal of the game is to beat each level as quickly as possible by clearing the board of all bubbles. Bubbles are removed from the board when a cluster of three of more of the same type is formed. The game is over when any bubbles on the board extend below the bottom line.
Chapter 12. Plugins 12.1.4. Chessbox Figure 12.4.: Chessbox Chessbox is a one-person chess game with computer artificial intelligence. The chess engine is a port of GNU Chess 2 by John Stanback. It also works as a PGN file viewer. Instead of executing the game from the plugin menu, look for any file with .pgn extension in the file browser and execute it. Chessbox will show the list of matches included in the file and allow you to select the one you want to watch.
Chapter 12. Plugins 12.1.5. Clix Figure 12.5.: Clix The aim is to remove all blocks from the board. You can only remove blocks, if at least two blocks with the same color have a direct connection. The more blocks you remove per turn, the more points you get. Key Action Prev/Next/ Scroll Up/Scroll Down OK Rec Move the cursor around the blocks Remove a block Exit 12.1.6. Chopper Figure 12.6.: Chopper Navigate a cavernous maze without banging into walls, the ceiling, or the floor.
Chapter 12. Plugins Key Action Play / Scroll Up Rec Make chopper fly Enter menu 12.1.7. Codebuster Figure 12.7.: Codebuster Codebuster is a clone of the classic mastermind game. The computer selects a random combination of coloured pegs and the aim is to guess the correct combination in the smallest number of moves. After each attempt to guess the combination the results are displayed in the form of red and white pegs.
Chapter 12. Plugins 12.1.9. Doom Figure 12.8.: Doom This is the famous Doom game. Getting started For the game to run you need .wad game files located in /.rockbox/doom/ on your player. Create the directory and save the following files there: rockdoom.wad. The Rockbox .wad, based on prboom.wad from prboom-2.2.6 Your wad files. Copy all Doom wads you wish to play into that directory. The needed files can be found at ZPluginDoom To play addon wads create the addons directory within the doom directory.
Chapter 12. Plugins Options Menu. This menu has the following options: Sound. Enable or Disable sound in Doom Set Keys. Change the game key configuration Time Demo. Run a timed demo, to test game speed on a player (Only runs on Doom Shareware) Player Bobbing. Enable or Disable player up/Down movement Translucency. Enable or Disable sprite translucency (Fireballs, Plasma...) Fake Contrast. Enable or Disable modified game lighting Always Run. Make the player always run Headsup Display.
Chapter 12. Plugins Playing the game After installation of the wad files is complete you can start the game. more description is needed 12.1.10. Flipit Figure 12.9.: Flipit Flipping the colour of the token under the cursor also flips the tokens above, below, left and right of the cursor. The aim is to end up with a screen containing tokens of only one colour.
Chapter 12. Plugins 12.1.11. Goban Figure 12.10.: Goban Goban is a a plugin for playing, viewing and recording games of Go (also known as Weiqi, Baduk, Igo and Goe). It uses standard Smart Game Format (SGF) files for saving and loading games. You can find a short introduction to Go at http://senseis.xmp. net/?WhatIsGo and more information about SGF files can be read at http://senseis.xmp. net/?SmartGameFormat or the SGF specification at http://www.red-bean.com/sgf/.
Chapter 12. Plugins Mark Meaning + * There are nodes after the current node in the SGF tree. There are sibling variations which can be navigated to using the Next Variation menu option of the Context Menu or the Cancel button. There is a comment at the current node. It can be viewed/edited using the Add/Edit Comment menu option of the Context Menu.
Chapter 12. Plugins Context Menu. Open the Context Menu which allows you to set play modes and other tools. Quit. Leave the plugin. Any unsaved changes are saved to /sgf/gbn_def.sgf. Game Info. The menu for modifying game info (metadata) of the current game. This information will be saved to the SGF file and can be viewed in almost all SGF readers. Basic Info. Shows a quick view of the basic game metadata, if any has been set (otherwise does nothing). This option does not allow editing. Time Limit.
Chapter 12. Plugins Disable Idle Poweroff? Enable this if you do not want the player to turn off after a certain period of inactivity (depends on your global Rockbox settings). Idle Autosave Time. Set the amount of idle time to wait before automatically saving any unsaved changes. These autosaves go to the file /sgf/gbn_def.sgf regardless of if you have loaded a game or used Save As to save the game before or not. Set to Off to disable this functionality completely.
Chapter 12. Plugins Add/Edit Comment. Add or edit a comment at the current node. Done. Go back to the previous screen. 12.1.12. Invadrox Figure 12.11.: Invadrox Invadrox is a clone of the classic arcade game Space Invaders. Kill those pesky aliens before they get to you. Remember, they increase speed, drop down and reverse direction after every pass! Key Action Prev Next OK Rec Move left Move right Fire Quit 12.1.13. Jackpot Figure 12.12.: Jackpot This is a jackpot slot machine game.
Chapter 12. Plugins Key Action OK Menu Play Exit the game 12.1.14. Jewels Figure 12.13.: Jewels Jewels is a simple yet addicting game which involves swapping pairs of jewels in order to form connected segments of three or more of the same type. The goal of the game is to score as many points as possible before running out of available moves. Higher points are awarded to larger combos. The game advances to the next level after every one hundred points and randomly clears several jewels.
Chapter 12. Plugins 12.1.15. MazezaM Figure 12.14.: MazezaM The goal of this puzzle game is to escape a dungeon consisting of ten “mazezams”. These are rooms containing rows of blocks which can be shifted left or right. You can move the rows only by pushing them and if you move the rows carelessly, you will get stuck. You can have another go by selecting “retry level” from the menu, but this will cost you a life. You start the game with three lives.
Chapter 12. Plugins then the number of mines adjacent to the current square is revealed. The aim is to use the information you are given to work out where the mines are and avoid them. When the player is certain that they know the location of a mine, it can be tagged to avoid accidentally “stepping” on it.
Chapter 12. Plugins Filename MD5 checksum pacman.5e pacman.5f pacman.6e pacman.6f pacman.6h pacman.6j 2791455babaf26e0b396c78d2b45f8f6 9240f35d1d2beee0ff17195653b5e405 290aa5eae9e2f63587b5dd5a7da932da 19a886fcd8b5e88b0ed1b97f9d8659c0 d7cce8bffd9563b133ec17ebbb6373d4 33c0e197be4c787142af6c3be0d8f6b0 These need to be stored in the /.rockbox/pacman/ directory on your player. In the MAME ROMs collection the necessary files can be found in pacman.zip and puckman.zip.
Chapter 12. Plugins Key Action Scroll Up, Scroll Down, Prev, Next Play Menu OK Cancel Rec to move around to to to to to choose peg restart level go up a level go down a level quit 12.1.19. Pong Figure 12.18.: Pong Pong is a simple one or two player “tennis game”. Whenever a player misses the ball the other scores. The game starts in demo mode, with the CPU controlling both sides.
Chapter 12. Plugins 12.1.20. Reversi This is a simple implementation of the Reversi game. The objective of the game is to have a majority of own coloured pieces showing at the end of the game. The game rules can be found in the internet. You can choose to play manually (you place both the white and dark pieces) or to play against a (not very smart) robot. 12.1.21. Robotfindskitten Figure 12.19.: Robotfindskitten In this game, you are robot (#). Your job is to find kitten.
Chapter 12. Plugins 12.1.22. Rockblox Figure 12.20.: Rockblox Rockblox is a Rockbox version of the classic falling blocks game from Russia. The aim of the game is to make the falling blocks of different shapes form full rows. Whenever a row is completed, it will be cleared away, and you gain points. For every ten lines completed, the game level increases, making the blocks fall faster. If the pile of blocks reaches the ceiling, the game is over.
Chapter 12. Plugins 12.1.24. Rocklife This an implementation of J. H. Conway’s Game of Life (see http://en.wikipedia.org/ wiki/Conway%27s_Game_of_Life for a detailed description). Rockbox can open files with a configuration description (.cells files). Just “play” such file and the game configuration stored in it will be loaded into this plugin. A .cells file is a text file. A capital ‘O’ marks a live cell, a dot marks a dead cell, all other characters are ignored.
Chapter 12. Plugins Key Action Prev, Next, Scroll Up and Scroll Down Cancel Menu Move Tile Rec Shuffle Switch between pictures (default puzzle, album art, and your own image if launched via Open With), and numbered tiles Stop the game 12.1.26. Snake Figure 12.22.: Snake This is the popular snake game. The aim is to grow your snake as large as possible by eating the dots that appear on the screen. The game will end when the snake touches either the borders of the screen or itself.
Chapter 12. Plugins 12.1.27. Snake 2 Figure 12.23.: Snake 2 – The Snake Strikes Back Another version of the Snake game. Move the snake around, and eat the apples that pop up on the screen. Each time an apple is eaten, the snake gets longer. The game ends when the snake hits a wall, or runs into itself.
Chapter 12. Plugins 12.1.28. Sokoban Figure 12.24.: Sokoban The object of the game is to push boxes into their correct position in a crowded warehouse with a minimal number of pushes and moves. The boxes can only be pushed, never pulled, and only one can be pushed at a time. Sokoban may be used as a viewer for viewing saved solutions and playing external level sets with the .sok extension. Level sets should be in the standard Sokoban text format or RLE (Run Length Encoded).
Chapter 12. Plugins Note that some level sets may contain levels that are too large for this version of Sokoban and are unplayable as a result. 12.1.29. Solitaire Figure 12.25.: Klondike solitaire This is the classic Klondike solitaire game for Rockbox. This is probably the best-known solitaire in the world. Many people do not even realize that other games exist. Though the name may not be familiar, the game itself certainly is.
Chapter 12. Plugins 12.1.30. Spacerocks Figure 12.26.: Spacerocks Spacerocks is a clone of the old arcade game Asteroids. The goal of the game is to blow up the asteroids and avoid being hit by them. Once in a while, a UFO will appear – shoot this for extra points. Key Action OK Scroll Up Prev/ Next Scroll Down Play Rec Shoot Thrust Turn left/right Teleport Pause game Quit 12.1.31. Star Figure 12.27.: Star game This is a puzzle game.
Chapter 12. Plugins Rules: Take all of the “o”s to go to the next level. You can switch control between the filled circle, which can take “o”s, and the filled square, which is used as a mobile wall to allow your filled circle to get to places on the screen it could not otherwise reach. The block cannot take “o”s.
Chapter 12. Plugins The scratchpad When you play Sudoku on paper most people like to mark numbers in cells that are possible candidates for the cells. This can be done with the scratchpad, shown as separate column. Change the number under the cursor to the number you want to put on the scratchpad and press the scratchpad button, the number will then be added. If the number was already on the scratchpad it will get removed again. The column is stored separately for every cell on the board.
Chapter 12. Plugins Wormlet is a multi-worm game on a multi-threaded multi-functional Rockbox console. You navigate a hungry little worm. Help your worm to find food and to avoid poisoned argh-tiles. The goal is to turn your tiny worm into a big worm for as long as possible. Game controls: Key Action Prev Next Scroll Up Scroll Down Turn Turn Turn Turn left right Up Down The game Use the control keys of your worm to navigate around obstacles and find food.
Chapter 12. Plugins • If you want to stop the game and still see the screen hit Cancel. This freezes the game. If you hit Cancel button again a new game starts with the same configuration. To return to the games menu you can hit Rec. A stopped game can not be resumed. The scoreboard On the right side of the game field is the score board. For each worm it displays its status and its length. The top most entry displays the state of worm 1, the second worm 2 and the third worm 3.
Chapter 12. Plugins 12.1.34. Xobox Figure 12.30.: Xobox Xobox is a simple clone of the well known arcade game Qix. The aim of the game is to section off parts of the arena with your trail in order to remove that section from the game. Be careful not to get in the way of enemy balls because, if they hit you or your trail, you lose a life. To finish a level you have to section off more than 75%. Key Action Scroll Up, Scroll Down, Prev, Next Play Rec Move around the arena Pause Open menu 12.2.
Chapter 12. Plugins This demo is of the word “Rockbox” bouncing across the screen. There is also an analogue clock in the background. In Scroll mode the bouncing text is replaced by a different one scrolling from right to left. Key Action Scroll Up / Scroll Down Next / Prev Menu Rec Moves to next/previous option Increases/decreases option value Toggles Scroll mode Exits bounce demo Available options are: Xdist/Ydist. The distance to X axis and Y axis respectively Xadd/Yadd.
Chapter 12. Plugins Key Action OK Play Menu Next / Prev Scroll Up / Scroll Down Rec Display at maximum frame rate Pause Cycle draw mode Select axis to adjust Change speed/angle (speed can not be changed while paused) Quit 12.2.4. Demystify Figure 12.33.: Demystify Demystify is a screen saver like demo. Key Action Prev / Next Scroll Up / Scroll Down Menu Increase / decrease speed Add / remove polygon The Rockbox manual Quit (version 3.
Chapter 12. Plugins 12.2.5. Fire Figure 12.34.: Fire Fire is a demo displaying a fire effect. Key Action Scroll Up / Scroll Down Prev Next Menu Increase / decrease number of flames Toggle flame type Toggle moving flames Quit 12.2.6. Fractals Figure 12.35.: Fractals: Mandelbrot set This demonstration draws fractal images from the Mandelbrot set. The Rockbox manual (version 3.
Chapter 12. Plugins Key Action Direction keys Play Menu Cancel OK Long Cancel Rec Move about the image Zoom in Zoom out Decrease iteration depth (less detail) Increase iteration depth (more detail) Reset and return to the default image Quit 12.2.7. Logo Demo showing the Rockbox logo bouncing around the screen. Key Action Next / Prev Scroll Up / Scroll Down Rec Increase / decrease speed on the x-axis Increase / decrease speed on the y-axis Quit 12.2.8. Mosaique Figure 12.36.
Chapter 12. Plugins 12.2.9. Oscilloscope Figure 12.37.: Oscilloscope This demo shows the shape of the sound samples that make up the music being played. At faster speed rates, the player is less responsive to user input and music may start to skip. Keys Key Action Menu Cancel OK Play Scroll Up / Scroll Down Next / Prev Rec Toggle filled / curve / plot Toggle whether to scroll or not Toggle drawing orientation Pause the demo Increase / decrease volume Increase / decrease speed Exit demo 12.2.10.
Chapter 12. Plugins PictureFlow provides a visualisation of your albums with their associated cover art. It is possible to start playback of the selected album from PictureFlow. Playback will start from the selected track. The PictureFlow plugin will continue to run while your tracks are played. Requirements PictureFlow uses both the album art (see section C.21 (page 186)) and database (see section 4.2 (page 27)) features of Rockbox.
Chapter 12. Plugins Centre margin. The distance, in screen pixels, with zoom at 100, between the centre and side slides. Scales with zoom. Number of slides. Sets the number of slides at each side, including the centre slide. Therefore if set to 4, there will be 3 slides on the left, the centre slide, and then 3 slides on the right. Zoom. Changes the distance at which slides are rendered from the “camera”. Show album title.
Chapter 12. Plugins 12.2.12. Snow Figure 12.40.: Have you ever seen snow falling? This demo replicates snow falling on your screen. If you love winter, you will love this demo. Or maybe not. Press Rec to quit. 12.2.13. Starfield Figure 12.41.: Starfield Starfield simulation (like the classic screensaver). Key Action Next / Prev Scroll Up / Scroll Down Play Rec Increase / decrease number of stars Increase / decrease speed The Rockbox manual Change colours Quit (version 3.
Chapter 12. Plugins 12.2.14. VU meter Figure 12.42.: VU-Meter This is a VU meter, which displays the volume of the left and right audio channels. There are 3 types of meter selectable. The analogue meter is a classic needle style. The digital meter is modelled after LED volume displays, and the mini-meter option allows for the display of small meters in addition to the main display (as above).
Chapter 12. Plugins Viewer gin Plu- Shortcuts Chip-8 Emulator Frotz Image Viewer Lua scripting language Midiplay MPEG Player MP3 Encoder Rockboy Search Sort Text Viewer VBRfix ZXBox Shopping list Associated filetype(s) Context Menu only .link .ch8 .z1 - .z8 .bmp, .jpg, .jpeg, .png, .ppm .lua .mid, .midi .mpg, .mpeg, .mpv, .m2v .wav .gb, .gbc .m3u, .m3u8 .* .txt,.nfo, .* .mp3 .tap, .tax, .sna, .z80 .shopper x x x x 12.3.1.
Chapter 12. Plugins the directory selected, or with the file selected in the file browser. You can then play the file or do with it whatever you want. The file will not be “played” automatically. If the .link file contains only one entry no list will be shown, you will directly jump to that location. The file shortcuts.link in the root directory is an exception. After “playing” it, the list will be shown even if the file contains just one entry. If the list you are seeing is from shortcuts.
3 4 5 6 7 8 9 A B C D E F Scroll Down 2 Next 1 OK Rec 0 Prev Off Scroll Up Chip8 Key Chapter 12. Plugins Some places where can you can find .ch8 files: • The PluginChip8 page on www.rockbox.org has several attached: ZPluginChip8 • Check out the HP48 chip games section: http://www.hpcalc.org/hp48/games/chip/ • PC emulator by the guy who wrote the HP48 emulator: http://www.pdc.kth.se/ ~lfo/chip8/CHIP8.htm • Links to other chip8 emulators: http://www.zophar.net/chip8.html 12.3.3.
Chapter 12. Plugins • A Beginner’s Guide to Playing Interactive Fiction: http://www.microheaven.com/ IFGuide/ Key Action Scroll Up OK Menu Display keyboard to enter text Press enter Open Frotz menu (not available at MORE prompts) Quit Long Rec 12.3.4. Image Viewer This plugin opens image files from the File Browser to display them. Supported formats are as follows. Format File-extension(s) BMP JPEG PNG PPM .bmp .jpg, .jpe, .jpeg .png .
Chapter 12. Plugins The menu has the following entries. Return. Returns you to the image Toggle Slideshow Mode. Enables or disables the slideshow mode. Change Slideshow Timeout. You can set the timeout for the slideshow between 1 second and 20 seconds. Show Playback Menu. From the playback menu you can control the playback of the currently loaded playlist and change the volume of your player. Display Options.
Chapter 12. Plugins 12.3.6. Midiplay To get MIDI file playback, a patchset is required. This file contains the instruments required to synthesize the music. A sample patchset is available through the wiki at ZPluginMidiPlay, and needs to be extracted to the .rockbox directory in the root of your player. There should now be a /.rockbox/patchset/ directory, with the patchset directory containing several .pat files and two .cfg files. Just select a MIDI file with either the .mid or .
Chapter 12. Plugins Resume at: mm:ss Resume video playback at stored resume time mm:ss (start of the video if no resume time is found). Set start time A preview screen is presented consisting of a thumbnail preview and a progress bar where the user can select a start time by ‘seeking’ through the video. The video playback is started by pressing the select button. Settings Open Settings submenu – see below. Quit mpegplayer Exit the plugin. Main Menu Settings Open Settings submenu – see below.
Chapter 12. Plugins Backlight Brightness (default: Use setting) Choose brightness to use during video playback. Set to Use setting to use the Brightness setting. Audio Options Menu Tone Controls (default: force off) Use the bass and treble control settings or force them off. Channel Modes (default: force off) Use the channel configuration setting or force Stereo mode. Crossfeed (default: force off) Use the Crossfeed setting or force crossfeed off.
Chapter 12. Plugins 12.3.9. Rockboy Figure 12.43.: Rockboy Rockboy is a Nintendo Game Boy and Game Boy Color emulator for Rockbox based on the gnuboy emulator. To start a game, open a ROM file saved as .gb or .gbc in the file browser. Default keys Key Action OK / Cancel Prev / Next Power Rec Play Scroll Up Menu Direction keys A button B button Start Select Open Rockboy menu Rockboy menu Load Game. . . Loads a previously saved game. Save Game. . . Saves your current state. Options. . .
Chapter 12. Plugins Screen Size. Choose whether the original aspect ratio should be kept when scaling the picture to the screen. Screen Rotate. Rotate the displayed picture and direction keys by 90 degrees. Set Palette. Pick one of a few predefined colour palettes. Reset. Resets the Emulator. Quit RockBoy. Quits the Rockboy plugin. 12.3.10. Search This plugin can be used on playlists. It searches through the playlist that it opened on looking for any occurrences of the string entered by the user.
Chapter 12. Plugins Default keys Key Action OK Cancel Prev Scroll-up Scroll-down Top of file (Narrow mode) / One screen left (Wide mode) Bottom of file (Narrow mode) / One screen right (Wide mode) One line up One line down Toggle autoscroll Set/Reset bookmarks Enter menu Exit text viewer Next Scroll Up Scroll Down Play Power Menu Rec Menu Return Return to the file being viewed. Viewer Options Change settings for the current file. Encoding Set the codepage in the text viewer.
Chapter 12. Plugins Alignment Set the text alignment. Right Set the text alignment to the right. (Useful for displaying right-to-left languages, such as Arabic or Hebrew) Left Set the text alignment to the left. Show Header Select whether to show the header. The header displays the file path. No Do not display the header. Yes Display the header. Show Footer Select whether to show the footer. The footer dispays the page number. No Do not display the footer. Yes Display the footer.
Chapter 12. Plugins Scroll by Line Scroll up or down one line. Overlap Pages Set whether the last line from the previous screen is retained when scrolling pages. No Do not retain previous line. Yes Retain previous line. Auto-scroll Speed Control the speed of auto-scrolling in number of lines per second. Available options are 1 to 10 lines per second. As an example, 4 will scroll the text at four lines per second.
Chapter 12. Plugins Bookmarks To add a bookmark, press . The bookmark will be displayed as shown below. To delete the bookmark press the same button again. Figure 12.46.: A bookmark 12.3.14. Theme Remove This plugin offers a way to remove a theme. Open the Context Menu (see section 4.1.2 (page 24)) upon a theme.cfg file and select Open With... → theme_remove. Some files are not removed regardless of the Remove Options such as rockbox_default.wps and the font file currently in use.
Chapter 12. Plugins WPS. Specifies how the .wps file belonging to a theme .cfg file is handled. Statusbar Skin. Specifies how the .sbs file belonging to a theme .cfg file is handled. Backdrop. Specifies how the backdrop .bmp file belonging to a theme .cfg file is handled. Iconset. Specifies how the iconset .bmp file belonging to a theme .cfg file is handled. Viewers Iconset. Specifies how the viewers iconset .bmp file belonging to a theme .cfg file is handled. Filetype Colours.
Chapter 12. Plugins .sna in the file browser. Note: As ZXBox is a 48k emulator only loading of 48k z80 snapshots is possible. b Default keys The emulator is set up for 5 different buttons: Up, Down, Left, Right and Jump/Fire. Each one of these can be mapped to one key of the Spectrum Keyboard or they can be used like a “Kempston” joystick.
Chapter 12. Plugins Frameskip Sets the number of frames to skip before displaying one. With zero frameskip ZXBox tries to display 50 frames per second. Sound. Turns sound on or off. Volume. Controls volume of sound output. Predefined Keymap Select one of the predefined keymaps. For example 2w90z means: map ZXBox’s Up to 2, Down to w, Left to 9, Right to 0 and Jump/Fire to z. This example keymap is used in the “Chuckie Egg” game.
Chapter 12. Plugins 12.4.2. Battery Benchmark The Battery Benchmark plugin enables you to test your battery’s performance whilst using your player normally. Results can be submitted to the ZBatteryRuntime wiki page. How it works Once loaded, Battery Benchmark runs in the background recording various information about your battery to memory. A new point is written to memory every minute.
Chapter 12. Plugins Usage The log file can be used to tell you how long the battery lasted (with some limitations, see below), but it is most useful for graphing discharge curves in order to improve Rockbox’s estimation of battery level and time remaining. The battery log (battery_bench.txt) is in CSV format (comma separated variables) and thus can be easily imported into a spreadsheet or similar program.
Chapter 12. Plugins 12.4.4. Calendar Figure 12.49.: Calendar This is a small and simple calendar application with memo saving function. Dots indicate dates with memos. The available memo types are: one off, yearly, monthly, and weekly memos. You can select what day is first day of week by the setting First Day of Week in the menu. Key Action Prev / Next / Scroll Up / Scroll Down OK Menu / Play Rec Move the selector Show memos for the selected day Previous / Next month Quit 12.4.5.
Chapter 12. Plugins Setup Key Action Scroll Up / Scroll Down OK Cancel Increase / decrease displayed Value Move to next screen Move to previous screen • First enter the number of players (1–10) • Then set the total game time in mm:ss • 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. • Done. Player 1 starts in paused mode.
Chapter 12. Plugins 12.4.6. Clock Figure 12.51.: Clock This is a fully featured analogue and digital clock plugin. Key configuration Key Action Prev / Next Scroll Up / Scroll Down Menu OK Long OK Cycle through modes Cycle through skins Main Menu Start / Stop Counter Reset Counter Clock Menu View Clock Exits the menu and returns to the current clock mode display. Mode Selector Opens a menu from which you can select a clock mode to view.
Chapter 12. Plugins Backlight Choose whether to disable the backlight, use the user’s timeout setting, or keep the backlight on. Idle Poweroff Toggle Idle Poweroff. b Note: This setting is not saved to disk. Help Opens a brief help screen with key mappings and functionality. Credits Displays a credits roll. Analog mode Small, round, analog clock is displayed in the middle of the LCD. Time readout, if enabled, is displayed at the upper left.
Chapter 12. Plugins Binary mode This mode shows a Binary clock. The hour is displayed on the top line, the minute is displayed on the middle line, and the seconds are on the last line. Circle mode, if enabled, draws empty and full circles, instead of zeros and ones. For help on reading binary, please visit: http://en.wikipedia.org/wiki/Binary_numeral_system Plain mode This mode shows a “plain” clock in large text that takes up nearly the whole LCD. 12.4.7.
Chapter 12. Plugins 12.4.8. Keybox Keybox is an encrypted password storage using the “Tiny Encryption Algorithm” with a key derived using md5. Using Keybox To get started, start up the plugin and select Enter Keybox. The first time you enter Keybox you will be prompted for a master password and for confirmation of the master password. The master password is the password that you must use to access your stored passwords. Once inside, enter the context menu by pressing Long Menu.
Chapter 12. Plugins 5. id3v2 SYLT or USLT tags in mp3 files .lrc8 files are the same as .lrc files except that they are UTF8 encoded. The Lyrics3 tag is not supported. Supported tags and formats for .lrc files The following tags are supported: [ti:title] [ar:artist] [offset:offset (msec)] Each line should resemble one of the following: [time tag]line [time tag]...[time tag]line [time tag]word... The time tag must be in the form [mm:ss], [mm:ss.
Chapter 12. Plugins /Lyrics/Title.ext /Lyrics/Musics/Artist/Album/Title.ext /Lyrics/Musics/Artist/Title.ext /Lyrics/Musics/Title.ext /Lyrics/Title.ext Controls Key Action Scroll Up / Scroll Down Prev Volume up/down. Long Prev Next Long Next Play Long Play or OK Long Menu Menu Go to beginning of track, or if pressed while in the first seconds of a track, go to the previous track. Rewind in track. Go to the next track. Fast forward in track. Toggle play/pause. Exit the plugin. Enter timetag editor.
Chapter 12. Plugins Encoding. Sets the codepage used in the plugin. Read ID3 tag. Read lyrics from id3 tags in mp3 files. Lrc Directory. Set the directory where lyrics files are stored, must be a maximum of 63 bytes. Playback Control. Show the playback control menu. Time Offset. Set an offset for the time tags for the lyrics currently in use. Timetag Editor. Enter the timetag editor. Quit. Exit the plugin. Editing the time tags The display time for each line can be changed with the timetag editor.
Chapter 12. Plugins 12.4.13. Pitch Detector With the Pitch Detector, you can play a note on a musical instrument, and the plugin will tell you what note it is (e.g. A, A#, B, etc.) The frequency will also be displayed. This may be a great assistance when tuning a musical instrument. Key Action Menu Long Rec Open menu Exit 12.4.14. Random Folder Advance Configuration This plugin is used to configure the folders which will be considered when the AutoChange Directory feature is set to Random.
Chapter 12. Plugins Folder List Editor Keys Key Action Next or OK Long Menu Delete selected folder Bring up the context menu which allows you to remove the selected folder or its entire folder tree Exit Prev or Cancel 12.4.15. Resistor Calculator Figure 12.52.
Chapter 12. Plugins and, if selected, the custom forward current. This function produces safe estimates, but use your own judgement when using these output values. Power rating and displayed resistance are rounded up to the nearest common value. 12.4.16. Rockpaint Figure 12.53.: Rockpaint Rockpaint is a bitmap (.bmp) editor for Rockbox. It can open any .bmp file whose dimensions are the same size as your device’s screen or smaller; it can also create empty bitmaps for you to work with.
Chapter 12. Plugins Selection tool Allows you to select a rectangular region; once you do, you will be shown a menu of options (including “cancel” if you make a mistake). Line tool Draws a straight line. Curve tool Allows you to draw a line and curve it. Rectangle tool Draws an unfilled rectangle. Circle tool Draws an unfilled circle. Gradient fill To use this tool, click at the starting and ending points.
Chapter 12. Plugins Brush speed Changes the speed at which the selection cursor moves when you hold down a movement button. Brush size Allows you to adjust the drawing size of the pencil tool. Choose colour Allows you to manually edit the foreground colour. You can edit the RBG and/or the HSV values. Grid size Allows you to show or hide a grid over the canvas, and to specify its size. Exit Exits Rockpaint. Warning: BE CAREFUL.
Chapter 12. Plugins 12.4.18. Stopwatch Figure 12.55.: Stopwatch A simple stopwatch program with support for saving times. Key Action Rec Play OK Menu Scroll Up / Scroll Down Quit Plugin Start / stop Reset timer (only when timer is stopped) Take lap time Scroll through lap times 12.4.19. Text Editor This plugin allows you to view and edit simple text documents on your DAP. You can view files by using Open with from the Context Menu (see section 4.1.2 (page 24)).
Chapter 12. Plugins Key Action Next or OK Prev or Cancel Menu Long Menu Edit Line / Select Character Exit / Abort Editing Show Item Menu Delete Line The Rockbox manual (version 3.
Chapter 13. Advanced Topics 156 13. Advanced Topics 13.1. Customising the User Interface 13.1.1. Getting Extras Rockbox supports custom fonts. A collection of fonts is available for download in the font package at http://www.rockbox.org/daily.shtml. 13.1.2. Loading Fonts Rockbox can load fonts dynamically. Simply copy the .fnt file to the player and “play” it in the File Browser. If you want a font to be loaded automatically every time you start up, it must be located in the /.
Chapter 13. Advanced Topics Set-up There are two steps to changing the filetype colours – creating a file with the extension .colours and then activating it using a config file. The .colours files must be stored in the /.rockbox/themes/ directory. The .colours file is just a text file, and can be edited with your text editor of choice. Creating the .colours file The .
Chapter 13. Advanced Topics Editing The built-in Text Editor (see section 12.4.19 (page 154)) automatically understands the .colours file format, but an external text editor can also be used. To edit the .colours file using Rockbox, “play” it in the File Browser. The file will open in the Text Editor. Upon selecting a line, the following choices will appear: Extension Colour If Extension is selected, the virtual keyboard (see section 4.1.
Chapter 13. Advanced Topics 13.2. Configuring the Theme 13.2.1. Themeing – General Info There are various different aspects of the Rockbox interface that can be themed – the WPS or While Playing Screen, the FMS or FM Screen (if the player has a tuner), and the SBS or Base Skin.
Chapter 13. Advanced Topics Viewports By default, a viewport filling the whole screen contains all the elements defined in each theme file. The elements in this viewport are displayed with the same background/ foreground colours and the text is rendered in the same font as in the main menu. To change this behaviour a custom viewport can be defined. A viewport is a rectangular window on the screen with its own foreground/background colours. This window also has variable dimensions.
Chapter 13. Advanced Topics Viewport definition Default value width/height font foreground/background colours remaining part of screen user defined defined by theme Viewport Line Text Styles Tag Description %Vs(mode[,param]) Set the viewport text style to ‘mode’ from this point forward Mode can be the following: Mode Description clear invert color Restore the default style Draw lines inverted Draw the text coloured by the value given in ‘param’.
Chapter 13. Advanced Topics 162 %t(1)%acWarning:;%t(.1) %Vl(b,20,30,50,50,1) %Vf(000000) %Vb(ffffff) %sNo album art found %scheck your filenames. This example checks for album art. Album art will be displayed in viewport ‘a’, if it is found. Otherwise a red flashing warning will be displayed in viewport ‘b’. Note: The tag to display conditional viewports must come before the tag to preload the viewport in the .wps file. 13.2.3.
Chapter 13. Advanced Topics Conditional Tags If/else: Syntax: %?xx If the tag specified by “xx” has a value, the text between the “<” and the “|” is displayed (the true part), else the text between the “|” and the “>” is displayed (the false part). The else part is optional, so the “|” does not have to be specified if no else part is desired. The conditionals nest, so the text in the if and else part can contain all % commands, including conditionals.
Chapter 13. Advanced Topics %t Set the subline display time. The ‘%t’ is followed by either integer seconds (%t5), or seconds and tenths of a second within () e.g. (%t(3.5)). Each alternating subline can still be optionally scrolled while it is being displayed, and scrollable formats can be displayed on the same line with non-scrollable formats (such as track elapsed time) as long as they are separated into different sublines.
Chapter 13. Advanced Topics Example on background image use: Example %X(background.bmp) The image with filename background.bmp is loaded and used in the WPS. Example on bitmap preloading and use: Example %x(a,static_icon.bmp,50,50) %xl(b,rep_off.bmp,16,64) %xl(c,rep_all.bmp,16,64) %xl(d,rep_one.bmp,16,64) %xl(e,rep_shuffle.bmp,16,64) %?mm<%xd(b)|%xd(c)|%xd(d)|%xd(e)> Four images at the same x and y position are preloaded in the example.
Chapter 13. Advanced Topics 1. Each setting must be on a separate line. 2. Each line has the format “setting: value”. 3. Values must be within the ranges specified in this manual for each setting. 4. Lines starting with # are ignored. This lets you write comments into your configuration files. Example of a configuration file: Example volume: 70 bass: 11 treble: 12 balance: 0 time format: 12hour volume display: numeric show files: supported wps: /.rockbox/car.wps lang: /.rockbox/afrikaans.
Chapter 13. Advanced Topics 167 Reset Settings This wipes the saved settings in the player and resets all settings to their default values. Note: You can also reset all settings to their default values by turning off the player, turning it back on, and holding the Rec button immediately after the player turns on. Save .cfg File This option writes a .cfg file to your player’s disk. The configuration file has the .
Chapter 13. Advanced Topics 168 13.5.2. Display power-off Shutting down the display and the display controller saves a reasonable amount of power. Choose a setting that will put the display to sleep after timeout (for setting Sleep see section 8.4 (page 61)). Avoid to have the display enabled all the time – even, if the display is transflective and is readable without backlight.
Appendix A. File formats The Rockbox manual (version 3.
Appendix A. File formats A. File formats A.1. Supported file formats Icon File Type Extension Action when selected Directory Audio file Bookmark none various (see B.1) .bmark Game of Life .cells Configuration File .cfg Enter the directory Start playing the file and show the WPS Display all bookmarks for an audio file Show the configuration with the “Rocklife” plugin Load the settings file Chip8 game Colours .ch8 .colours Cuesheet Font .cue .fnt Image Link .jpg .
Appendix B. Audio and metadata formats B. Audio and metadata formats B.1. Supported audio formats B.1.1. Lossy Codecs Format Extension Notes ATSC A/52 (AC3) .a52, .ac3, .rm, .ra, .rmvb .adx Supports downmixing for playback of 5.1 streams in stereo ADX Advanced Audio Coding Musepack .m4a, .m4b, .mp4, .rm, .ra, .rmvb .mpa, .mp1, .mp2, .mp3 .mpc OGG/Vorbis .ogg, .oga Sony Audio .oma, .aa3, .rm, .ra, .rmvb .rm, .ra, .rmvb .spx .vox .wma, .wmv, .asf .wma, .wmv, .
Appendix B. Audio and metadata formats mance requirements. B.1.2. Lossless Codecs Format Extension Notes Audio Interchange File Format .aif, .aiff Monkey’s Audio .ape, .mac Sun Audio .au, .snd Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.711 alaw/µ-law, QuickTime IMA ADPCM Only -c1000 files decode fast enough to be useful. Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.711 alaw/µ-law Free Lossless Audio Apple Lossless Shorten True Audio Wave64 .flac .m4a, .mp4 .shn .
Appendix B. Audio and metadata formats B.1.3. Other Codecs Format Extension Atari Sound Format Synthetic music Mobile Application Format Game Boy Sound Format .cmc, .cmr, .dmc, .mpt, .mmf .gbs AY Sound Chip Music .ay Hudson Entertainment System Sound Format .hes MSX Konami Sound System .kss SMS/GG/CV Sound Format .sgc Video Game Music Format Gzipped Video Game Music Format MOD NES Sound Format .vgm .vgz .mod .nsf, .nsfe Atari SAP Sound Interface Device .sap .sid SPC700 .spc Notes .
Appendix B. Audio and metadata formats B.1.4.
Appendix B. Audio and metadata formats B.2. Supported metadata tags Rockbox supports different metadata formats. In general those tag formats are ID3 (v1.0, v1.1, v2.2, v2.3 and v2.4), APE (v1 and v2), Vorbis, MP4 and ASF. Few codecs use codec specific tags, several codecs do not use any tags yet. The following table gives an overview about what tag types rockbox supports for which audio file extension. Note: There is always only one tag type supported for each file extension.
Appendix B. Audio and metadata formats B.2.2. Featureset for codec specific metadata Feature Codec specific metadata (file extension) Embedded .bmp Embedded .jpg Embedded .png Replaygain Title None None None .mpc .tta, .spc, .mmf, .sid, .rm, .ra, .rmvb, .nsf, .nsfe, .mod, .sap, .gbs, .ay, .sgc, .vgm .tta, .spc, .mmf, .sid, .rm, .ra, .rmvb, .nsf, .nsfe, .sap, .gbs, .ay, .sgc, .vgm .spc, .sid, .nsf, .nsfe, .gbs, .ay, .sgc, .vgm .tta, .spc, .sap .tta .tta .spc, .sid, .sap .mmf .spc, .rm, .ra, .rmvb, .
Appendix C. Theme Tags C. Theme Tags Themeing is discussed in detail in section section 13.2 (page 159), what follows is a list of the available tags. Note: The “bar-type tags” (such as %pb, %pv, %bl etc.) can be further themed – see section C.27 (page 190). C.1. Status Bar Tag Description %we %wd %wi Display Status Bar Hide Status Bar Display the inbuilt Status Bar in the current viewport These tags override the player setting for the display of the status bar.
Appendix C. Theme Tags 178 C.3. Information from the track tags Tag Description %ia %ic %iA %id %iG %ig %in %it %iC %iv %iy %ik Artist Composer Album Artist Album Name Grouping Genre Name Track Number Track Title Comment ID3 version (1.0, 1.1, 2.2, 2.3, 2.4, or empty if not an ID3 tag) Year Disc Number Remember that this information is not always available, so use the conditionals to show alternate information in preference to assuming. These tags, when written with a capital “I” (e.g.
Appendix C. Theme Tags 179 C.5. Additional Fonts Tag Description %Fl(’id’,filename) See section 13.2.4. C.6. Power Related Information Tag Description %bl Numeric battery level in percents. Can also be used in a conditional: %?bl<-1|0|1|2|...|N>, where the value −1 is used when the battery level isn’t known (it usually is). The value N is only used when the battery level is exactly 100 percent.
Appendix C. Theme Tags 180 C.7. Information about the file Tag Description %fb %fc File Bitrate (in kbps) File Codec (e.g. “MP3” or “FLAC”). This tag can also be used in a conditional tag: %?fc.
Appendix C. Theme Tags C.8. Playlist/Song Info Tag Description %pb Progress Bar. This will replace the entire line with a progress bar. You can set the position, width and height of the progressbar (in pixels) and load a custom image for it: %pb(x,y,[width],[height],image.bmp) Percentage played in song Current time in song Total number of playlist entries Peak Meter. The entire line is used as volume peak meter. Peak meter for the left channel.
Appendix C. Theme Tags from (0 the current track, 1 is the next track, etc.). • ‘code to render’ is a line of skin code which will be displayed for each line in the viewer. All text tags are supported (including conditionals and sublines) The entire viewport will be used, so don’t expect other tags in the same viewport to work well. Supported tags are %pp, all tags starting with %i, most tags starting with %f, %pt and %s.
Appendix C. Theme Tags C.14. Repeat Mode Tag Description %mm Repeat mode, 0-4, in the order: Off, All, One, Shuffle, A-B Example: %?mm C.15. Playback Mode Tag Description %mp Play status, 0-4, in the order: Stop, Play, Pause, Fast Forward, Rewind, Recording, Recording paused, FM Radio playing, FM Radio muted Example: %?mp C.16.
Appendix C. Theme Tags 184 The tag can also be used as the switch in a conditional tag. For players without certain capabilities (e.g. no FM radio) some values will never be returned. Examples: You are in the %?cs %?if(%cs, =, 2) C.17. List Title (.sbs only) Tag Description %Lt Title text. Should be used in a conditional so that non-list screens don’t show a title when they shouldn’t Title icon.
Appendix C. Theme Tags Examples: 1. As a simple tag: %St(skip length) 2. As a conditional: %?St(eq enabled) C.20. Images Tag Description Load and set a backdrop image for the WPS. This image must be exactly the same size as your LCD. %x(n,filename,x,y) Load and display an image n: image ID (a-z and A-Z) for later referencing in %xd filename: file name relative to /.rockbox/ and including “.bmp” x: x coordinate y: y coordinate.
Appendix C. Theme Tags 186 2. Load a bitmap strip containing 5 volume icon images (all the same size) with image ID “M”, and then reference the individual sub-images in a conditional: %xl(M,volume.bmp,134,153,5) %?pv<%xd(Ma)|%xd(Mb)|%xd(Mc)|%xd(Md)|%xd(Me)> b Note: • The images must be in BMP format • The image tag must be on its own line • The ID is case sensitive, giving 52 different ID’s • The size of the LCD screen for each player varies. See table below for appropriate sizes of each device.
Appendix C. Theme Tags 2. ./filename.{jpeg,jpg,bmp} 3. ./albumtitle.{jpeg,jpg,bmp} 4. ./cover.{jpeg,jpg,bmp} 5. ./folder.jpg 6. /.rockbox/albumart/albumartist-albumtitle.{jpeg,jpg,bmp} 7. ../albumtitle.{jpeg,jpg,bmp} 8. ../cover.{jpeg,jpg,bmp} The following characters will be replaced with an underscore (_) when looking for albumtitle.bmp or albumartist-albumtitle.bmp: \ / : < > ? * |. Doublequotes will be replaced by single quotes. If no album artist is set, artist will be used instead.
Appendix C. Theme Tags 188 C.22. Alignment and language direction Tag Description %al %aL %ac %ar %aR %ax Align the text left Align the text left, or to the right if RTL language is in use Centre the text Align the text right Align the text right, or to the left if RTL language is in use The next tag should follow the set language direction. When prepended to a viewport declaration, the viewport will be horizontally mirrored if the user language is set to a RTL language.
Appendix C. Theme Tags work, and the comparison is not case sensitive. C.24. Subline Tags Tag Description %t(time) ; Set the subline display cycle time (%t(5) or %t(3.4) formats) Split items on a line into separate sublines Allows grouping of several items (sublines) onto one line, with the display cycling round the defined sublines. See section 13.2.4 (page 163) for details. C.25.
Appendix C. Theme Tags • It should match the Source: line in the language file. Note: checkwps cannot verify that the string is correct, so please check on either the simulator or on target. C.27. Bar Tags Some tags can be used to display a bar which draws according to the value of the tag. To use these tags like a bar you need to use the following parameters (%XX should be replaced with the actual tag).
Appendix C. Theme Tags 191 Note: If the slider option is used, the bar will be shrunk so that the slider fits inside the specified width and height. C.28. Other Tags Tag Description %( %) %, %% %< %| %> %; %# %s The character ‘(’ The character ‘)’ The character ‘,’ The character ‘%’ The character ‘<’ The character ‘|’ The character ‘>’ The character ‘;’ The character ‘#’ Indicate that the line should scroll. Can occur anywhere in a line (given that the text is displayed; see conditionals above).
Appendix D. Config file options D.
Appendix D. Config file options Setting Allowed Values Unit bidir limit scroll paginated hold_lr_for_scroll_in_list show path in browser contrast backlight timeout 0 to 200 on, off on, off off, current directory, full path 0 to 63 off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45, 60, 90, 120 off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45, 60, 90, 120 on, off % screen N/A N/A N/A N/A s normal, off, on on, off devise a way to get ranges from config-*.
Appendix D.
Appendix D.
Appendix D. Config file options Setting Allowed Values Unit scrollbar scrollbar width off, left, right 3 to LCD width / 10 (devise a way to get ranges from config-*.h) graphic, numeric graphic, numeric /path/filename.fnt /path/filename.kbd on, off on, off pointer, bar (inverse) , bar (color), bar (gradient) on, off /path/filename.bmp /path/filename.bmp /path/filename.bmp 000000 to FFFFFF 000000 to FFFFFF 000000 to FFFFFF 000000 to FFFFFF 000000 to FFFFFF /path/filename.
Appendix E. Menu Overview 197 E. Menu Overview include an overview of the menu structure here The Rockbox manual (version 3.
Appendix F. User feedback F. User feedback F.1. Bug reports 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 ideas (see below). For open bug reports refer to http://www.rockbox.org/tracker/index.php?type=2 F.1.1. Rules for submitting new bug reports 1. Check that the bug has not already been reported 2.
Appendix F. User feedback 199 F.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! • 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.
Appendix G. Credits G. Credits People that have contributed to the project, one way or another.
Appendix G. Credits Hand · Nick Lanham · Sebastian Henriksen · Martin Scarratt · Karl Kurbjun · Tomasz Malesinski · Andrew Pilley · Matt v.d. Westhuizen · Tim Crist · Jvo Studer · Dan Everton · Imre Herceg · Seven Le Mesle · Craig Bachelor · Nikolaj Christensen · Mikael Magnusson · Dominik Wenger · Henrico Witvliet · Andrew Scott · Miguel A. Arévalo · Aaron F.
Appendix G. Credits · Stepan Moskovchenko · John S. Gwynne · Brian J. Morey · Stijn Hisken · Bertrik Sikken · Karim Boucher · James Espinoza · Franz Rühmland · Jordan Anderson · Maurus Cuelenaere · Chris Allegretta · Alastair S · Martin Crkovský · Ariya Hidayat · Jonas Hurrelmann · Lee Kang Hyuk · Clemens Werther · Robert Menes · Henri Valta · Melba Sitjar · Mehmet Ş.
Appendix G.
Appendix H. Licenses H. Licenses H.1. GNU Free Documentation License Version 1.2, November 2002 Copyright c 2000,2001,2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
Appendix H. Licenses A “Modified Version” of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
Appendix H. Licenses ther is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as “Acknowledgements”, “Dedications”, “Endorsements”, or “History”.) To “Preserve the Title” of such a section when you modify the Document means that it remains a section “Entitled XYZ” according to this definition.
Appendix H. Licenses distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
Appendix H. Licenses on its Title Page, then add an item describing the Modified Version as stated in the previous sentence. 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.
Appendix H. Licenses 5. COMBINING DOCUMENTS 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.
Appendix H. Licenses 8. TRANSLATION 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.
Appendix H. Licenses Copyright c YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no BackCover 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.
Appendix H. Licenses H.2. The GNU General Public License Version 2, June 1991 Copyright c 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it.
Appendix H. Licenses Terms and Conditions For Copying, Distribution and Modification 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License.
Appendix H. Licenses such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works.
Appendix H. Licenses If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License.
Appendix H. Licenses reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8.
Appendix H. Licenses and/or redistribute the program as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages.
Appendix H. Licenses ‘show w’. This is free software, and you are welcome to redistribute it under certain conditions; type ‘show c’ for details. The hypothetical commands show w and show c should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than show w and show c; they could even be mouse-clicks or menu items— whatever suits your program.
