The Rockbox Manual for Iaudio M5 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-2013 The Rockbox Team and its contributors, c 2004 Christi Alice Scarborough, c 2003 José Maria Garcia-Valdecasas Bernal & Peter Schlenker. Version rUnversioned. 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.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. Saving playlists . . . . . . 4.4.6. Loading saved playlists . 5. The 5.1. 5.2. 5.3. 5.4. 5.5. 5.6. 5.7.
Contents 6.8. Crossfeed . . . . . . . . . . . 6.9. Equalizer . . . . . . . . . . . 6.10. Dithering . . . . . . . . . . . 6.11. Timestretch . . . . . . . . . . 6.12. Haas Surround . . . . . . . . 6.13. Perceptual Bass Enhancement 6.14. Auditory Fatigue Reduction . 6.15. 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.
Contents 8.6.3. Sleep Timer 8.7. Bookmarking . . . 8.8. Automatic resume 8.9. Language . . . . . 8.10. Voice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 69 71 72 72 9. Theme Settings 75 10.
Contents 12.1.20.Robotfindskitten . . . 12.1.21.Rockblox . . . . . . . 12.1.22.Rockblox1d . . . . . . 12.1.23.Sliding Puzzle . . . . . 12.1.24.Snake . . . . . . . . . 12.1.25.Snake 2 . . . . . . . . 12.1.26.Sokoban . . . . . . . . 12.1.27.Solitaire . . . . . . . . 12.1.28.Spacerocks . . . . . . 12.1.29.Star . . . . . . . . . . 12.1.30.Sudoku . . . . . . . . 12.1.31.Wormlet . . . . . . . . 12.1.32.Xobox . . . . . . . . . 12.1.33.XWorld . . . . . . . . 12.2. Demos . . . . . . . . . . . . . 12.2.1. Bounce .
Contents 12.3.14.Theme Remove . . . . . 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 . . . . . . .
Contents 13.5. Optimising battery runtime . . . 13.5.1. Display backlight . . . . . 13.5.2. Anti-Skip Buffer . . . . . 13.5.3. Replaygain . . . . . . . . 13.5.4. Peak Meter . . . . . . . . 13.5.5. Audio format and bitrate 13.5.6. Sound settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents D.18.List Title (.sbs only) . . . . . . . . D.19.Changing Volume . . . . . . . . . . . D.20.Settings . . . . . . . . . . . . . . . . D.21.Images . . . . . . . . . . . . . . . . . D.21.1. How to display the album art D.22.Alignment and language direction . . D.23.Conditional Tags . . . . . . . . . . . D.24.Subline Tags . . . . . . . . . . . . . D.25.Time and Date . . . . . . . . . . . . D.26.Text Translation . . . . . . . . . . . D.27.Bar Tags . . . . . . . . . . . . . . . . D.27.1. Options . .
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 13 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 Fonts. Rockbox can load custom fonts. The fonts are distributed as a separate package and thus need to be installed separately. They are not required to run Rockbox itself but a lot of themes require the fonts package to be installed. Themes. The appearance of Rockbox can be customised by themes. Depending on your taste you might want to install additional themes to change the look of Rockbox. 2.2.1.
Chapter 2. Installation Development Build. The development build is built at each change to the Rockbox source code repository and represents the current state of Rockbox development. This means that the build could contain bugs but most of the time is safe to use. For a manual install, you can download the current build from http://build.rockbox. org/. Archived Build. In addition to the release version and the current build, there is also an archive of daily builds available for download.
Chapter 2. Installation Installing the bootloader The Iaudio M5 has a built-in bootloader which performs the firmware update and can also access the hard drive via USB. The Rockbox bootloader can therefore be very minimalistic, as it does not require its own USB mode. This makes it less dangerous to install the Rockbox bootloader as you can always restore it using the Iaudio bootloader. Note: The Rockbox bootloader overwrites the original firmware, making it impossible to dual-boot.
Chapter 2. Installation 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. The bootloader only changes rarely, and should not normally need to be updated. Note: If you use Rockbox Utility be aware that it cannot detect manually installed components. 2.5. Uninstalling Rockbox 2.5.1.
Chapter 3. Quick Start 18 3. Quick Start 3.1. Basic Overview 3.1.1. The player’s controls 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.
Chapter 3. Quick Start detail in the following paragraph. Additional information for blind users is available on the Rockbox website at ZBlindFAQ. The player is curved so that the end with the screen on it is thicker than the other end. Hold the player wih the thick end towards the top and the screen facing towards you. Half way up the front of the unit on the right hand side is a four way joystick which is the Up, Down, Left, and Right buttons. When pressed it serves as Select.
Chapter 3. Quick Start 20 directory structure that is assumed by some parts of Rockbox (album art searching, and missing-tag fallback in some WPSes) uses the parent directory of a song as the Album name, and the parent directory of that folder as the Artist name. WPSes may display information incorrectly if your files are not properly tagged, and you have your music organized in a way different than they assume when attempting to guess the Artist and Album names from your filetree.
Chapter 3. Quick Start 21 Menu From the menu you can customise Rockbox. Rockbox itself is very customisable. Also there are some special menus for quick access to frequently used functions. Context Menu Some views, especially the file browser and the WPS have a context menu. From the file browser this can be accessed with Long Select. The contents of the context menu vary, depending on the situation it gets called.
Chapter 4. Browsing and playing 22 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 Remote Key Action Up/Down Play Volume Up/Volume Down Rewind Play or Forward Play Long Play Long Select Rec Long Rec Long Play Long Mode Menu Long Menu 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.
Chapter 4. Browsing and playing Playlist. Enters the Playlist Submenu (see section 4.4.3 (page 35)). Playlist Catalogue. Enters the Playlist Catalogue Submenu (see section 4.4.2 (page 34)). 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. Copies the name of the currently selected file or directory to the clipboard and marks it to be ‘copied’. Paste.
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 Remote Key Action Left / Right Rewind / Forward Up / Down Volume Up / Volume Down 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. Flip to the next page of characters (if there is more than one).
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 Note: You may need to increase the value of the Max Entries in File Browser setting (Settings → General Settings → System → Limits) in order to view long lists of tracks in the ID3 database browser. There is no option to turn off database completely. If you do not want to use it just do not do the initial build of the database and do not load it to RAM.
Chapter 4. Browsing and playing 29 change the display of the WPS. • Status bar: The Status bar shows Battery level, charger status, volume, play mode, repeat mode, shuffle mode and clock. In contrast to all other items, the status bar is always at the top of the screen. • (Scrolling) path and filename of the current song. • The ID3 track name. • The ID3 album name. • The ID3 artist name. • Bit rate. VBR files display average bitrate and “(avg)” • Elapsed and total time.
Chapter 4. Browsing and playing 4.3.1. WPS Key Controls Key Remote Key Action Up / Down Volume up/down.
Chapter 4. Browsing and playing without being indicated. The scale: Between the indicators of the right and left channel there are little dots. These dots represent important volume values. In linear mode each dot is a 10% mark. In dBFS mode the dots represent the following values (from right to left): 0 dB, -3 dB, -6 dB, -9 dB, -12 dB, -18 dB, -24 dB, -30 dB, -40 dB, -50 dB, -60 dB. 4.3.3.
Chapter 4. Browsing and playing 32 Playback Settings This is a shortcut to the Playback Settings Menu, where you can configure shuffle, repeat, party mode, skip length and other settings affecting the playback of your music. Rating The menu entry is only shown if Gather Runtime Information is enabled. It allows the assignment of a personal rating value (0 – 10) to a track which can be displayed in the WPS and used in the Database browser. The value wraps at 10.
Chapter 4. Browsing and playing Pitch The Pitch Screen allows you to change the rate of playback (i.e. the playback speed and at the same time the pitch) of your player. The rate value can be adjusted between 50% and 200%. 50% means half the normal playback speed and a pitch that is an octave lower than the normal pitch. 200% means double playback speed and a pitch that is an octave higher than the normal pitch. The rate can be changed in two modes: procentual and semitone.
Chapter 4. Browsing and playing 34 Directory. A playlist! One of the keys to getting the most out of Rockbox is understanding that Rockbox always considers the song that it is playing to be part of a playlist, and in some situations, Rockbox will create a playlist automatically. For example, if you are playing the contents of a directory, Rockbox will automatically create a playlist containing all songs in it.
Chapter 4. Browsing and playing 35 to an existing playlist and Add to a new playlist creates a new playlist containing the selected track or directory. Note: All playlists in the Playlist catalogue are stored by default in the /Playlists directory in the root of your player’s disk and playlists stored in other locations are not included in the catalogue. It is however possible to move existing playlists there (see section 4.1.2 (page 23)).
Chapter 4. Browsing and playing Insert Shuffled. Add track(s) to the playlist in a random order. Insert Last Shuffled. Add tracks in a random order to the end of the playlist. Queue. Queue is the same as Insert except queued tracks are deleted immediately from the playlist after they have been played. Also, queued tracks are not saved to the playlist file (see section 5.9 (page 42)). Queue Next. Queue track(s) immediately after current playing track. Queue Last. Queue track(s) at end of playlist.
Chapter 4. Browsing and playing 37 the context menu and then move the blinking cursor to the place where you want the track to be moved and confirm with Select, Right or Play. To remove a track, simply select Remove in the context menu. 4.4.5. Saving playlists To save the current playlist either enter the Playlist submenu in the WPS Context Menu (see section 4.3.3 (page 31)) and select Save Current Playlist or enter the Playlist Options menu in the Main Menu and select Save Current Playlist.
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 Rec 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 40 5.5. Database Browse by the meta-data in your audio files (see section 4.2 (page 26)). 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 28)). 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 41 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 Remote Key Action Up / Down Select setting. Play Volume Up / Volume Down Rewind / Right Play Long Play Long Play Rec Rec Long Rec Menu Left / Right 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 77)). 5.9.
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 5. The Main Menu • A file can be “run” (i.e. a music file played, plugin started or a .
Chapter 5. The Main Menu 45 time data needs to be either “talk” to talk the time, or “sleep X” where X is the number of minutes to run the sleep timer for (0 to disable). name is required for this shortcut type. shutdown data is ignored; name can be used to display text If the name/icon items are not specified, a sensible default will be used. Note: For the “browse” type, if you want the file browser to start inside a folder, make sure the data has the trailing slash (i.e /Music/ instead of /Music).
Chapter 6. Sound Settings 46 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 47 from the list and the maximum volume will be limited to the selected value all over the system. 6.4. Treble This setting emphasises or suppresses the higher (treble) frequencies in the sound. A value of 0 dB means that treble sounds are unaltered (flat response). The minimum setting is -24 dB and the maximum is 24 dB. 6.5. 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.
Chapter 6. Sound Settings 48 of one channel into the other. This has the effect of gradually centering the stereo image, until you have monophonic sound at 0%. Values above 100% will progressively remove components in one channel that is also present in the other. This has the effect of widening the stereo field. A value of 100% will leave the stereo field unaltered. 6.8.
Chapter 6. Sound Settings 49 Most users will find the default settings to yield satisfactory results, but for the more adventurous user the settings can be fine-tuned to provide a virtual speaker placement suited to ones preference. Beware that the crossfeed function is capable of making the audio distort if you choose settings which result in a too high output level. 6.9. Equalizer Figure 6.2.: The graphical equalizer Rockbox features a parametric equalizer (EQ).
Chapter 6. Sound Settings 50 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. Note that the parameteric EQ bands will be applied in addition to any bass or treble tone controls. Note: A maximum of 10 EQ bands are possible on most devices, but using more than are required will waste battery and introduce additional rounding noise. For best results, use the fewest number of bands required.
Chapter 6. Sound Settings Key Remote Key Action Right Left Up Down Select Forward Rewind Volume Up Volume Down Play Power/Rec Rec Raises the highlighted parameter. Lowers the highlighted parameter. Moves to the previous EQ band. Moves to the next EQ band. Toggles the cursor among the three parameters (gain, centre frequency, Q) for the selected EQ band Exits the graphic EQ screen. Pre-cut. If too much positive gain is added through the graphical EQ, your music may distort.
Chapter 6. Sound Settings 52 Dithering adds low-level noise to the signal prior to throwing away the surplus bits, which gives the resulting signal a uniform noise floor which is independent of the signal. Most people find this noise preferable to the time-varying noise heard when not performing dithering. After dithering, noise shaping is performed. This basically just pushes the dithering noise to the parts of the frequency spectrum humans cannot hear so easily.
Chapter 6. Sound Settings 53 6.14. Auditory Fatigue Reduction Human hearing is more senstive to some frequency bands. This setting applies additional equalization and bi-shelf filtering to reduce signals in these bands to minimize the chance that temporary threshold shift (auditory fatigue) occurs. 6.15. Compressor The Compressor reduces, or compresses, the dynamic range of the audio signal.
Chapter 7. Playback Settings 54 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 33). Options: Yes/No. 7.2.
Chapter 7. Playback Settings 55 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 56 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 57 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 58 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 59 7.14. Cuesheet Support Enables reading of cuesheet files for played tracks. If a cuesheet is found for a track, track markers are displayed on the progressbar and it is possible to skip between the tracks within the cuesheet. Also the information found in the cuesheet file will replace the information from the ID3 tags. When you enable this option, you’ll have to reboot for it to come into effect.
Chapter 7. Playback Settings 60 7.18. Rewind on Pause This option rewinds the current track by a small amount whenever it is paused (not stopped). The amount to rewind can be set between 0 and 15 seconds.
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 63 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 64 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. This is sometimes useful when carrying the player in a pocket for easy access to the headphone socket. Remote-LCD Settings. This sub menu contains settings that relate to the display of the remote. Backlight.
Chapter 8. General Settings Remote Scrolling Options. The options here have the same effect on the remote LCD as the options mentioned above have on the main LCD. Bidirectional Scroll Limit. Rockbox has two different automatic horizontal scrolling methods: 1) always scrolling the text to the left until the line has ended and then beginning again at the start, and 2) moving to the left until you can read the end of the line and then scrolling right until you see the beginning again.
Chapter 8. General Settings 66 Scale. Select whether the peak meter displays linear or logarithmic values. The human ear perceives loudness on a logarithmic scale. If the Scale setting is set to Logarithmic (dB) scale, the volume values are scaled logarithmically. The volume meters of digital audio devices usually are scaled this way. On the other hand, if you are interested in the power level that is applied to your headphones you should choose Linear display.
Chapter 8. General Settings 67 Disk Spindown. Rockbox has a timer that makes it spin down the hard disk after it is idle for a certain amount of time. This setting controls the amount of time between the last user activity and the time that the disk spins down. This idle time is only affected by user activity, like navigating through the File Browser. When the hard disk spins up to fill the audio buffer, it automatically spins down afterwards. Directory Cache.
Chapter 8. General Settings 8.5.5. Car Adapter Mode This option turns On and Off the car ignition auto stop function. Car Adapter Mode. When using the player in a car, Car Adapter Mode automatically stops playback on the player when power (i.e. from cigarette lighter power adapter) to the external DC in jack is turned off. If the Car Adapter Mode is set to On, Rockbox will pause playback when the external power off condition is detected.
Chapter 8. General Settings 69 Settings. Display the main settings menu. Recording. Start the player in the recording screen (recording does not start automatically). Recent Bookmarks. Show the list of recent bookmarks as described in section 8.7 (page 69). Bookmarking needs to be enabled. 8.6.2. Idle Poweroff Rockbox can be configured to turn off power after the unit has been idle for a defined number of minutes. The player is idle when playback is stopped or paused.
Chapter 8. General Settings 70 Bookmarks are stored next to the directory or playlist they reference, in a file with the same name as the directory or playlist and a “.bmark” extension. To load a bookmark, select the bookmark file and then select the bookmark to load. There are other ways to load a bookmarks mentioned below. Note: Bookmarking only works when tracks are launched from the file browser, and does not work for tracks launched via the database.
Chapter 8. General Settings No Do not keep a list of recently used bookmarks. This also removes the Recent Bookmarks from the Main Menu. Yes Keep a list of recently used bookmarks. Each new bookmark is added to the list of recent bookmarks. Unique Only Add each new bookmark to the list of recently used bookmarks, but only keep one bookmark from the current directory or playlist; any previous entries are removed. The following keys can be used to navigate in any bookmark list.
Chapter 8. General Settings 72 If you intend to start a track from its beginning but notice that it was resumed, you can press Left in the WPS to skip back to its beginning. When pressing Left again in the first few seconds of a track to go to the previous track, the previously (on first button press) saved resume position is retained. Therefore, you can also use Left and Right to skip across tracks in a playlist without losing their resume position. Automatic resume.
Chapter 8. General Settings Voice Directories. This option controls voicing of directory names. A voice file must be present for this to work. Several options are available. Spell. Speak the directory name by spelling it out letter by letter. Support is provided only for the most common letters, numbers and punctuation. Numbers. Each directory is assigned a number based upon its position in the file list. They are then announced as “Directory 1”, “Directory 2” etc. Off.
Chapter 8. General Settings See ZVoiceHowto for more details on configuring speech support in Rockbox.
Chapter 9. Theme Settings 75 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 Select or Right to load the chosen theme and apply it.
Chapter 9. Theme Settings Status/Scrollbar. Settings related to on screen status display and the scrollbar. Scroll Bar. Allows you to choose where the vertical scroll bar should appear. Scroll Bar Width. Allows you to choose the width of the scroll bar (in pixels). Default value is 6. Status Bar. Allows you to choose where to display the statusbar on the main display. Remote Status Bar. Allows you to choose where to display the statusbar on the remote display. Volume Display.
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 23)) 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 80 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 81 11. Time and Date Time related menu options. Pressing Long Select will voice the current time if voice support is enabled. Set Time/Date: Set current time and date. Time Format: Choose 12 or 24 hour clock.
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 12.1.2. Blackjack Figure 12.1.: Blackjack Blackjack, a game played in casinos around the world, is now available in the palm of your hand! The rules are simple: try to get as close to 21 without going over or simply beat out the dealer for the best hand. Although this may not seem difficult, blackjack is a game renowned for the strategy involved. This version includes the ability to split, buy insurance, and double down.
Chapter 12. Plugins 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. For a special item to take effect, you must catch it with the paddle. Look out for the bad ones. Special items Displayed Name Description N D L F G B FL Normal Die Life Fire Glue Ball Flip Returns paddle to normal. Ball dies; lose a life. Gain a life.
Chapter 12. Plugins the bottom line. To make things more difficult, the entire board is shifted down every time a certain number of shots have been fired. Points are awarded depending on how quickly the level was completed. Key Remote Key Action Up Left / Right Forward Volume Down / Volume Up Mode Rec Pause game Aim the bubble Select Rec or Power Fire bubble Exit to menu 12.1.5. Chessbox Figure 12.4.: Chessbox Chessbox is a one-person chess game with computer artificial intelligence.
Chapter 12. Plugins Keys Key Remote Key Direction keys Select Rec Play Power Action Move the cursor Pick up / Drop piece Change level Force play Show the menu 12.1.6. Chopper Figure 12.5.: Chopper Navigate a cavernous maze without banging into walls, the ceiling, or the floor. How long can you fly your chopper? Key Remote Key Select / Up Power Action Make chopper fly Enter menu 12.1.7. Dice Dice is a simple dice rolling simulator.
Chapter 12. Plugins 12.1.8. Doom Figure 12.6.: 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.9. Flipit Figure 12.7.: 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.10. Goban Figure 12.8.: 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. 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 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. The time limit of the current game. Overtime. The overtime settings of the current game. Result. The result of the current game.
Chapter 12. Plugins 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. Automatically Show Comments? If this is enabled and you navigate to a node containing game comments, they will automatically be displayed. Context Menu.
Chapter 12. Plugins 12.1.11. Invadrox Figure 12.9.: 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 Remote Key Left Right Select Power Action Move left Move right Fire Quit 12.1.12. Jackpot Figure 12.10.: Jackpot This is a jackpot slot machine game. At the beginning of the game you have 20$.
Chapter 12. Plugins Key Remote Key Action Select Rec Mode Rec Play Exit the game 12.1.13. Jewels Figure 12.11.: 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.
Chapter 12. Plugins 12.1.14. MazezaM Figure 12.12.: 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 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. The MAME project itself can be found at http://www.mame.net. Keys Key Remote Key Right Left Up Down Rec Select Power Play Action Move Up Move Down Move Left Move Right Insert Coin 1-Player Start 2-Player Start Menu 12.1.17. Pegbox Figure 12.15.: pegbox To beat each level, you must destroy all of the pegs.
Chapter 12. Plugins 12.1.18. Pong Figure 12.16.: 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. As soon as a button to control one of the paddles is pressed, control of that paddle passes to the player, so for a single player game, just press the appropriate buttons to control the side you want to play.
Chapter 12. Plugins 12.1.20. Robotfindskitten Figure 12.17.: Robotfindskitten In this game, you are robot (#). Your job is to find kitten. This task is complicated by the existence of various things which are not kitten. Robot must touch items to determine if they are kitten or not. The game ends when robotfindskitten. Key Remote Key Action Up, Down, Left, Right Forward, Rewind, Volume Down, Volume Up Rec Move robot Rec Quit 12.1.21. Rockblox Figure 12.18.
Chapter 12. Plugins completed, the game level increases, making the blocks fall faster. If the pile of blocks reaches the ceiling, the game is over. Key Remote Key Action Play Left Right Down Select Power Restart game Move left Move right Move down Rotate anticlockwise Up Rec Hold switch Power Rotate clockwise Drop Pause Quit 12.1.22. Rockblox1d Rockblox1d is a game for people who find rockblox too hard.
Chapter 12. Plugins The classic sliding puzzle game. Rearrange the pieces so that you can see the whole picture, or switch to number tiles if you like it a little easier Includes one picture puzzle, but you can switch the puzzle picture to be the album art of the currently playing music track, if one exists (see section C (page 176)). You can also use the sliding puzzle plugin as a viewer for supported image types, to turn your own pictures into a puzzle.
Chapter 12. Plugins 12.1.25. Snake 2 Figure 12.21.: 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 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). For more information about the level format, see http://sokobano.de/wiki/index.
Chapter 12. Plugins the name may not be familiar, the game itself certainly is. This is due in no small part to Microsoft’s inclusion of the the game in every version of Windows. Though popular, the odds of winning are rather low, perhaps one in thirty hands. For the full set of rules to the game, and other interesting information visit http: //www.solitairecentral.com/rules/klondike.html Key Remote Key Up / Down / Left / Right Select Play Long Play Long Select Rec Power Action Move Cursor around.
Chapter 12. Plugins Key Remote Key Select Up Left/ Right Down Play Power Action Shoot Thrust Turn left/right Teleport Pause game Quit 12.1.29. Star Figure 12.25.: Star game This is a puzzle game. It is actually a rewrite of Star, a game written by CDK designed for the hp48 calculator. Rules: Take all of the “o”s to go to the next level.
Chapter 12. Plugins 12.1.30. Sudoku Figure 12.26.: Sudoku Sudoku in Rockbox can act as both a plugin and a viewer. When starting Sudoku from the Browse Plugins menu, a random game will be generated automatically, and an estimate of its difficulty (very easy, easy, medium, hard or fiendish) will be displayed on the screen. New games can be generated from the Generate menu option. When “playing” an existing Sudoku game file from Rockbox’ file browser the plugin is invoked as viewer.
Chapter 12. Plugins Key Remote Key Up / Down / Left / Right Select Long Select Action Move the cursor Change number under the cursor Constantly changing the number under the cursor Open Menu Add/Remove number to scratchpad Quit Play Rec Power Some places where can you can find .ss files: • Simple Sudoku (Advanced Puzzle Packs 1 and 2 located near the bottom of that page): http://www.angusj.com/sudoku/ • Kjell’s Sudoku generator/solver: http://kjell.haxx.se/sudoku/ 12.1.31. Wormlet Figure 12.27.
Chapter 12. Plugins The game Use the control keys of your worm to navigate around obstacles and find food. Worms do not stop moving except when dead. Dead worms are no fun. Be careful as your worm will try to eat anything that you steer it across. It won’t distinguish whether it is edible or not. Food. The small square hollow pieces are food. Move the worm over a food tile to eat it. After eating the worm grows. Each time a piece of food has been eaten a new piece of food will pop up somewhere.
Chapter 12. Plugins Hungry: That’s the normal state of a worm. Worms are always hungry and want to eat. It is good to have a hungry worm since it means that your worm is alive. But it is better to get your worm growing. Growing: When a worm has eaten a piece of food it starts growing. For each step it moves over food it can grow by one pixel. One piece of food lasts for 7 steps. After your worm has moved 7 steps the food is used up.
Chapter 12. Plugins 12.1.32. Xobox Figure 12.28.: 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 Remote Key Up, Down, Left, Right Play Power Action Move around the arena Pause Open menu 12.1.33.
Chapter 12. Plugins Key Remote Key Up Down Left / Right Action Up and Jump Down and Crouch Move Left and Right Action and Fire Menu 12.2. Demos 12.2.1. Bounce Figure 12.29.: Bounce 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.
Chapter 12. Plugins 12.2.2. Credits The credits plugin scrolls the entire list of the names of all the Rockbox contributors after displaying the Rockbox logo and version. This plugin is called when selecting Version from the System section of the Rockbox main menu. Exit at any time by pressing Left or Power. 12.2.3. Cube Figure 12.30.: Cube This is a rotating cube screen saver in 3D.
Chapter 12. Plugins 12.2.4. Demystify Figure 12.31.: Demystify Demystify is a screen saver like demo. Key Remote Key Action Left / Right Volume Down / Volume Up Forward / Rewind Rec Increase / decrease speed Up / Down Rec Add / remove polygon Quit 12.2.5. Fire Figure 12.32.: Fire Fire is a demo displaying a fire effect.
Chapter 12. Plugins Key Remote Key Action Up / Down Forward / Rewind Volume Down Volume Up Rec Increase / decrease number of flames Left Right Rec Toggle flame type Toggle moving flames Quit 12.2.6. Fractals Figure 12.33.: Fractals: Mandelbrot set This demonstration draws fractal images from the Mandelbrot set using the greyscale engine.
Chapter 12. Plugins 12.2.8. Mosaique Figure 12.34.: Mosaique This simple graphics demo draws a mosaic picture on the screen of the player. Key Remote Key Up Change the gap between the drawing lines. Restart the drawing process. Exits Mosaique demo Select Rec or Power Action 12.2.9. Oscilloscope Figure 12.35.: Oscilloscope This demo shows the shape of the sound samples that make up the music being played.
Chapter 12. Plugins Keys Key Remote Key Action Select Rec Long Select Toggle filled / curve / plot Toggle whether to scroll or not Toggle drawing orientation Play Up / Down Right / Left Power Pause the demo Increase / decrease volume Increase / decrease speed Exit demo 12.2.10. PictureFlow Figure 12.36.: PictureFlow PictureFlow provides a visualisation of your albums with their associated cover art. It is possible to start playback of the selected album from PictureFlow.
Chapter 12. Plugins Keys Key Remote Key Left / Right Up / Down Select Action Scroll through albums Scroll through track list Enter track list / Play album from selected track Exit track list Enter menu Exit PictureFlow Left Rec Power Main Menu Go to WPS. Leave PictureFlow and enter the while playing screen. Playback Control. Control music playback from within the plugin. Settings. Enter the settings menu. Return. Exit menu. Quit. Exit PictureFlow plugin. Settings Menu Show FPS.
Chapter 12. Plugins Rebuild cache. Rebuild the PictureFlow cache. This is needed in order for PictureFlow to pick up new albums, and may occasionally be needed if albums are removed. 12.2.11. Plasma Figure 12.37.: Plasma Plasma is a demo displaying a 80’s style retro plasma effect. Key Remote Key Action Up / Down Forward / Rewind Rec / Long Rec Increase / decrease Frequency Rec / Power Exit 12.2.12. Rocklife This an implementation of J. H. Conway’s Game of Life (see http://en.wikipedia.
Chapter 12. Plugins 12.2.13. Snow Figure 12.38.: 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 or Power to quit. 12.2.14. Starfield Figure 12.39.: Starfield Starfield simulation (like the classic screensaver).
Chapter 12. Plugins 12.2.15. VU meter Figure 12.40.: 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 Plugin Associated filetype(s) Shortcuts Chip-8 Emulator Frotz Image Viewer Lua scripting language Midiplay MPEG Player MP3 Encoder Rockboy Search Sort Text Viewer VBRfix ZXBox Shopping list .link .ch8 .z1 - .z8 .bmp, .jpg, .jpeg, .png .lua .mid, .midi .mpg, .mpeg, .mpv, .m2v .wav .gb, .gbc .m3u, .m3u8 .* .txt,.nfo, .* .mp3 .tap, .tax, .sna, .z80 .shopper Context Menu only x x x x 12.3.1.
Chapter 12. Plugins “playing” it, the list will be shown even if the file contains just one entry. If the list you are seeing is from shortcuts.link in the root directory, you can delete the selected entry by pressing Rec. Deleting entries from other .link files is not possible. Advanced Usage Placing the line “#Display last path segments=n” (where n is a number) in the beginning of a .link file will leave just the last n segments of the entries when they are shown.
3 4 5 6 7 8 9 A B C D E F Down 2 Right 1 Select Power 0 Left Off 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 Key Remote Key Action Up Select Rec Forward Mode Rec Display keyboard to enter text Press enter Open Frotz menu (not available at MORE prompts) Quit Power 12.3.4. Image Viewer This plugin opens image files from the File Browser to display them using Rockbox’s greyscale library. Supported formats are as follows. Format File-extension(s) BMP JPEG PNG GIF .bmp .jpg, .jpe, .jpeg .png .
Chapter 12. Plugins Show Playback Menu. From the playback menu you can control the playback of the currently loaded playlist and change the volume of your player. Quit. Quits the viewer and returns to the File Browser. Note: Progressive scan and other unusual JPEG files are not supported, and will result in various “unsupported xx” messages. Processing could also fail if the image is too big to decode which will be explained by a respective message. b 12.3.5.
Chapter 12. Plugins Key Remote Key Up/ Down Right/ Left Play Power Action Volume up/ Volume down Skip 3 seconds forward/ backward Pause/Resume playback Stop playback and quit 12.3.7. MPEG Player The Mpeg Player is a video player plugin capable of playing back MPEG-1 and MPEG-2 video streams with MPEG audio multiplexed into .mpg files. To play a video file, you just select it in the Rockbox File Browser. If your file does not have the .
Chapter 12. Plugins Settings Open Settings submenu – see below. Resume playback Return to playback screen. Quit mpegplayer Exit the plugin. Settings Menu Display Options Open Display Options submenu – see below. Audio Options Open Audio Options submenu – see below. Resume Options (default: Start menu) Enable/disable the start menu. Play Mode (default: Single) Set to All to play multiple .mpg files in the directory continuously. Clear all resumes: x Discard all x resume points.
Chapter 12. Plugins 12.3.8. MP3 Encoder This plugin encodes a .wav file to MP3 format. The supported input format is uncompressed, linear PCM with 16 bit per sample and a maximum of 2 channels. Allowed sample rates are 16, 22.05, 24, 32, 44.1 and 48 kHz. The user will be asked to select the desired output bitrate of the compressed MP3 file. Select Bitrate The following bitrates can be selected: 64, 80, 96, 112, 128, 160, 192, 224, 256, 320 kbps.
Chapter 12. Plugins Default keys Key Remote Key Up / Down Left / Right Play Rec Select Hold switch Power Action Direction keys A button B button Start Cycle display scaling modes Open Rockboy menu Rockboy menu Load Game. . . Loads a previously saved game. Save Game. . . Saves your current state. Options. . . Max Frameskip. Change frameskip setting to improve speed. Sound. Toggle sound on or off. Stats. Toggle showing fps and current frameskip.
Chapter 12. Plugins 12.3.13. Text Viewer Figure 12.42.: Text Viewer This is a Viewer for text files with word wrap. Just open a .txt or .nfo file to display it. The text viewer features controls to handle various styles of text formatting and has top-of-file and bottom-of-file buttons. You can view files without a .txt or .nfo extension by using Open with from the Context Menu (see section 4.1.2 (page 23)). You can also bookmark pages.
Chapter 12. Plugins ISO-8859-11 (Thai), CP1256 (Arabic), ISO-8859-9 (Turkish), ISO-88592 (Latin Extended), CP1250 (Central European), SJIS (Japanese), GB2312 (Simple Chinese), KSX-1001 (Korean), BIG5 (Traditional Chinese), UTF-8 (Unicode), This setting only applies to the plugin and is independent from the Default Codepage setting (see section 8.4 (page 66)). Word Wrap Toggle word wrap mode. On Break lines at the maximum column limit. Off (Chop Words) Break lines at white space or hyphen.
Chapter 12. Plugins Scrollbar Toggle the horizontal scrollbar for the current mode. If the file fits on one screen, there is no scrollbar and this setting has no effect. No Do not display the horizontal scroll bar. Yes Display the horizontal scroll bar. Scroll Mode Change the function of the “Left” and “Right” buttons. Scroll by Screen Move to the previous/next screen. Scroll by Column Move to the previous/next column. Vertical Submenu for vertical scrolling settings.
Chapter 12. Plugins Figure 12.43.: The select bookmark menu Global Settings Set the default settings for the text viewer. The setting items are the same as Viewer Options. The global settings are stored in .rockbox/rocks/viewers/viewer.dat. Quit Exits the plugin. The text viewer automatically stores its settings, the current position and bookmarks in .rockbox/rocks/viewers/viewer_file.dat. Bookmarks To add a bookmark, press Rec. The bookmark will be displayed as shown below.
Chapter 12. Plugins pressing any key. A file called theme_remove_log.txt is created in the root directory of your player listing all the changes. Remove Options. This menu specifies which items are removed if Remove Theme is selected in the menu. One of the following options can be chosen for each setting. Ask for Removal. Selecting this option brings up a dialogue with two options: press Select to confirm deletion or any other key to cancel. Remove if not Used.
Chapter 12. Plugins 12.3.15. VBRfix This function scans a VBR (Variable Bitrate) MP3 file and updates/creates the Xing VBR header. The Xing header contains information about the VBR stream used to calculate average bit rate, time information and to more accurately fwd/rew in the stream. This function is especially useful when the playback of a file skips, fwd/rew does not work correctly or the time display is incorrect. To use this plugin, open the Context Menu (see section 4.1.2 (page 23)) upon a .
Chapter 12. Plugins ZXBox menu Vkeyboard. This is a virtual keyboard representing the Spectrum keyboard. Controls are the same as in standard Rockbox, but you just press one key instead of entering a phrase. Play/Pause Tape. Toggles playing of the tape (if it is loaded). Save Quick Snapshot. Saves snapshot into /.rockbox/zxboxq.z80. Load Quick Snapshot. Loads snapshot from /.rockbox/zxboxq.z80. Save Snapshot. Saves a snapshot of the current state.
Chapter 12. Plugins 12.4. Applications 12.4.1. Alarm Clock This plugin is an alarm clock, which resumes a paused song at a given time. Key configuration Key Remote Key Action Left / Right Volume Down / Volume Up Forward / Rewind Mode Rec Switch between hours/minutes selection Up / Down Select Rec Increase/Decrease hours/minutes Set the alarm Exit Setting an alarm First select a track and play it, then launch the “alarmclock” plugin. The plugin pauses the playback. Enter a 24h-time (e.g.
Chapter 12. Plugins Benchmarks can be resumed if you accidentally load a plugin, or turn off your player, so long as the log file battery_bench.txt is not deleted. Information explained At the top of the battery_bench.txt file is various information on how to use the plugin, followed by the data themselves. Time This column reports the total time of operation of the player. It is not the time that you started the plug-in.
Chapter 12. Plugins 12.4.3. Calculator Figure 12.46.: Calculator This is a simple scientific calculator for use on the player. It works like a standard calculator. Pressing the “1st” and “2nd” buttons will toggle between other available math functions. Key Remote Key Left / Right / Up / Down Select Rec Play Power Action Move around the keypad Select a button Delete last entered digit or clear after calculation Calculate Quit 12.4.4. Calendar Figure 12.47.
Chapter 12. Plugins You can select what day is first day of week by the setting First Day of Week in the menu. Key Remote Key Left / Right / Up / Down Select Rec / Play Power Action Move the selector Show memos for the selected day Previous / Next month Quit 12.4.5. Chess Clock Figure 12.48.: Chess Clock The chess clock plugin is designed to simulate a chess clock, but it can be used in any kind of game with up to ten players.
Chapter 12. Plugins • Done. Player 1 starts in paused mode. While playing The number of the current player is displayed on the top line. The time below is the time remaining for that round (and possibly also the total time left if different). Keys are as follows: Key Remote Key Rec Power Play Right Left Select Action Exit plugin Restart round for the current player Pause the time (press again to continue) Switch to next player Switch to previous player Open menu (press again to select.
Chapter 12. Plugins Key configuration Key Remote Key Action Left / Right Volume Down / Volume Up Forward / Rewind Rec Mode Long Mode Cycle through modes Up / Down Rec Select Long Select 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 at the lower left. The Counter, if enabled, is displayed at the lower right. The second hand, if enabled, is displayed along with the hour and minute hands. Digit display, if enabled, places “12”, “3”, “6”, and “9” around the face of the clock in their respective positions. Digital mode An imitation of an LCD, this mode shows a Clock comprised of digital “segments”. The Date readout, if enabled, is displayed at the bottom, center.
Chapter 12. Plugins in the plain text file .rockbox/rocks/apps/disktidy.config that is user-modifiable to allow custom entries to be added. The asterisk character (“*”) can be used as a wild-card which will match any string; however only the first asterisk will be recognised as a wild-card with any additional uses being taken as literal. Warning: Be careful when you use custom entries as you could accidentally delete important files.
Chapter 12. Plugins Selecting Reset Keybox from the main menu will delete the current list of passwords and a new, empty list will be created the next time you select Enter Keybox after prompting for a new master password. Entries are automatically saved when the plugin is exited. 12.4.9. Lamp Lamp is a simple plugin to use your player as a lamp (flashlight, torch). You get an empty screen with maximum brightness. Key Remote Key Rec or Power Exit to menu Action 12.4.10.
Chapter 12. Plugins The time tag must be in the form [mm:ss], [mm:ss.xx], or [mm:ss.xxx] where mm is minutes, ss is seconds, xx is tenth of milliseconds, and xxx is milliseconds. Any other tags and lines without time tags are ignored. Location of lyrics files The plugin checks the following directories for lyrics files. If no lyrics file is found and the audio file is a .mp3, it also checks for SYLT and USLT tags in the id3v2 tags. 1. The directory containing the audio file and its parent directories.
Chapter 12. Plugins Controls Key Remote Key Action Up / Down Volume up/down. Left Volume Up / Volume Down Rewind Long Left Right Long Right Play Long Play or Select Long Select Rec Long Rewind Forward Long Forward Play Long Play or Mode Long Mode 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 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. Selecting a line changes its time to the current position of the track. To set a specific time or to adjust the time, press Long Select to bring up a screen to adjust the time.
Chapter 12. Plugins Key Remote Key Power Rec Long Select Select Left / Right Up / Down Rec Rec Mode Volume Down / Volume Up Forward / Rewind Action Exit plugin Stop Start Tap tempo Adjust tempo Adjust volume Programmed Track Mode When starting the plugin as a viewer for tempomap files (ending in .tempo), it starts in the track mode that offers playback of a preprogrammed metronome track consisting out of multiple parts, each with possibly different properties.
Chapter 12. Plugins Navigation The display indicates the part properties and position in track as such: Metronome Track --------------"Interlude" 3/4@120 V-25 P2/13: B1/5+2 In this example, the part label is “Interlude”, the meter is 3/4 and the tempo 120 quarter beats per minute (bpm). The volume setting is at -25 and this is the second part of a track with 13 total. In that part, the position is at the second beat of the first bar of five.
Chapter 12. Plugins Symbol X x . Meaning emphasized beat (Tick) normal beat (Tock) silent beat Some examples: default: rockon2: solea: shuffle: funky: 0 0 0 0 0 4/4 120 Xxxx 4/4 120 xXxX 12/4 180 xxXxxXxXxXxX 12/12 120 x.xX.xx.xX.. 16/16 120 x.x.X..X.Xx.X..X The 12/12 for the shuffle create 1/4 triplets. Just do a bit of math;-) This is still a metronome, not a drum machine, but it can act like a basic one, helping you to figure out a certain rhythm within the meter.
Chapter 12. Plugins 12.4.14. 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 Remote Key Action Rec Power Rec Open menu Exit 12.4.15.
Chapter 12. Plugins Folder List Editor Keys Key Remote Key Action Select, Right or Play Long Select Forward Delete selected folder Long Mode Left or Power Left Bring up the context menu which allows you to remove the selected folder or its entire folder tree Exit 12.4.16. Resistor Calculator Figure 12.50.
Chapter 12. Plugins with the first option). Then, use the onscreen keyboard to type in the supply voltage 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.17. Stats Figure 12.51.
Chapter 12. Plugins 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 23)). Usage If you start the Text Editor from the plugin browser you will be greeted with a blank screen. When started from the Open with menu item your file should be shown on the screen. You can now edit the file. The Text Editor is line based.
Chapter 13. Advanced Topics 13. Advanced Topics 13.1. Customising the User Interface 13.1.1. Customising The Main Menu It is possible to customise the main menu, i.e. to reorder or to hide some of its items (only the main menu can be customised, submenus can not). To accomplish this, load a .cfg file (as described in section 13.
Chapter 13. Advanced Topics Note: Advanced Users Only: Any BDF font should be usable with Rockbox. To convert from .bdf to .fnt, use the convbdf tool. This tool can be found in the tools directory of the Rockbox source code. See ZCreateFonts#ConvBdf for more details. Or just run convbdf without any parameters to see the possible options. b 13.1.4. Loading Languages Rockbox can load language files at runtime. Simply copy the .lng file (do not use the .
Chapter 13. Advanced Topics • ‘fgshade’ and ‘bgshade’ are numbers in the range 0 (= black) to 3 (= white). • ‘font’ is a number: 0 is the built-in system font, 1 is the user-selected font. Example ui viewport: 15,20,100,150,-,-,- This displays the menu starting at 15px from the left of the screen and 20px from the top of the screen. It is 100px wide and 150px high. The font and the foreground/background shades are defined in the theme .cfg file or in the Theme Settings menu. 13.2.
Chapter 13. Advanced Topics • All characters not preceded by % are displayed as typed. • Lines beginning with # are comments and will be ignored. Note: Keep in mind that your player’s resolution is 160×128×2 (with the last number giving the colour depth in bits) when designing your own WPS, or if you use a WPS designed for another target. The resolution of the remote is 128×96×2 pixels. b Viewports By default, a viewport filling the whole screen contains all the elements defined in each theme file.
Chapter 13. Advanced Topics %sthat point. The lines will scroll if this text does not fit in the viewport. %sThe user font is used, the foreground colour is set to black and the %sbackground is set to white.
Chapter 13. Advanced Topics 162 %t(1)%acWarning:;%t(.1) %Vl(b,20,30,50,50,1) %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 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. Info Viewport (SBS only) As mentioned above, it is possible to set a UI viewport via the theme .
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 164 %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. Anti-Skip Buffer Having a large anti-skip buffer tends to use more power, and may reduce your battery life. It is recommended to always use the lowest possible setting that allows correct and continuous playback (see section 7.5 (page 55)). 13.5.3. Replaygain Replaygain is a post processing that equalises the playback volume of audio files to the same perceived loudness.
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 Cuesheet Font .ch8 .cue .fnt Rockbox firmware .iaudio 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 Free Lossless Audio .flac Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.711 alaw/µ-law, QuickTime IMA ADPCM -c1000 to -c3000 files decode fast enough to be useful. Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.
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. b Note: There is always only one tag type supported for each file extension.
Appendix B. Audio and metadata formats 175 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. Album Art 176 C. Album Art Rockbox allows you to put the album art, or another image related to the music on your player to display it in the PictureFlow plugin or in the theme. For this feature to work, there are a few requirements. C.1. Limitations Rockbox supports embedded album art only for some specific formats, see section B.2.1 (page 174) for full details. It additionally supports loading images located on the hard disk. PictureFlow is currently unable to use embedded album art.
Appendix C. Album Art 177 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. See ZAlbumArt in the wiki for programs that will help you automate the process of putting album art on your player.
Appendix D. Theme Tags D. 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 D.27 (page 191). D.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 D. Theme Tags 179 D.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 D. Theme Tags 180 D.5. Additional Fonts Tag Description %Fl(’id’,filename) See section 13.2.4. D.6. Misc Coloring Tags Tag Description %dr(x,y,width,height,[color1,color2]) Color a rectangle. width and height can be - to fill the viewport. If no color is specified the viewports foreground color will be used. If two colors are specified it will do a gradient fill. D.7. Power Related Information Tag Description %bl Numeric battery level in percents.
Appendix D. Theme Tags 181 D.8. 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 D. Theme Tags D.9. 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 D. Theme Tags 183 • ‘start’ is the offset relative to the currently playing track for the playlist to display 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.
Appendix D. Theme Tags D.14. Virtual LED Tag Description %lh “h” if the hard disk is accessed D.15. Repeat Mode Tag Description %mm Repeat mode, 0-4, in the order: Off, All, One, Shuffle, A-B Example: %?mm D.16. 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 D.17.
Appendix D. Theme Tags Number Screen 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 Menus WPS Recording screen FM Radio screen Current Playlist screen Settings menus File browser Database browser Plugin browser Quickscreen Pitchscreen Setting chooser Playlist Catalogue Viewer Plugin Context menu System Info screen Time and Date Screen Bookmark browser Shortcuts menu Track Info screen 185 The tag can also be used as the switch in a conditional tag. For players without certain capabilities (e.g.
Appendix D. Theme Tags D.19. Changing Volume Tag Description %mv(t) “v” if the volume is being changed The tag produces the letter “v” while the volume is being changed and some amount of time after that, i.e. after the volume button has been released. The optional parameter t specifies that amount of time, in seconds. If it is not specified, 1 second is assumed. The tag can be used as the switch in a conditional tag to display different things depending on whether the volume is being changed.
Appendix D. Theme Tags 187 D.21. 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 for later referencing in %xd filename: file name relative to /.rockbox/ and including “.bmp” x: x coordinate (defaults to 0 if both x and y are not specified) y: y coordinate.
Appendix D. Theme Tags 1. Load and display the image /.rockbox/bg.bmp with ID “a” at 37, 109: %x(a,bg.bmp,37,109) 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.
Appendix D. Theme Tags 2. Load albumart at position 0,20 and resize it to be at most 100×100 pixels. If the image isn’t square, align it to the bottom-right corner: %Cl(0,20,100,100,r,b) For general information where to put album art see section C (page 176). D.22.
Appendix D. Theme Tags 190 D.23. Conditional Tags Tag Description %?xx %?xx %if(tag, operator, operand, [option count]) %and(tag1, tag2, ..., tagN) If / Else: Evaluate for true or false case Enumerations: Evaluate for first / second / third / . . . / last condition Allows very simple comparisons with other tags. tag: the tag to check against.
Appendix D. Theme Tags 191 D.25. Time and Date Tag Description %cd %ce %cf Day of month from 01 to 31 Zero padded day of month from 1 to 31 A conditional for 12/24 hour format.
Appendix D. Theme Tags Tag Description %XX(x, y, width, height, [options]) Draw the specified tag as a bar x: x co-ordinate at which to start drawing the bar. y: y co-ordinate at which to start drawing the bar (- to make the bar appear on the line of the tag, as if it was a text tag) . width: width of the bar (- for the full viewport width). height: height of the bar (- to set to the font height for horizontal bars and to the viewport height for vertical bars).
Appendix D. Theme Tags 193 D.28. Other Tags Tag Description %ss(start, length, tag [,number] Get a substring from another tag. Use this tag to get a substring from another tag. start – first character to take (0 being the start of the string, negative means from the end of the string) length – length of the substring to return (- for the rest of the string) tag – tag to get number – OPTIONAL. if this is present it will assume the substring is a number so it can be used with conditionals. (i.e %cM).
Appendix E. Config file options E.
Appendix E. 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 from config-*.
Appendix E. Config file options Setting Allowed Values Unit disable autoresume if phones not present Last.
Appendix E.
Appendix E. Config file options Setting Allowed Values Unit peak meter dbfs on, off peak meter min peak meter max statusbar remote statusbar scrollbar scrollbar width 0 to 89 (dB) or 0 to 100 (%) 0 to 89 /(dB) or 0 to 100 (%) off, top, bottom off, top, bottom 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) on, off /path/filename.bmp /path/filename.
Appendix E.
Appendix F. Menu Overview 200 F.
Appendix G. User feedback 201 G. User feedback G.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 G.1.1. Rules for submitting new bug reports 1. Check that the bug has not already been reported 2.
Appendix G. User feedback 202 G.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 H. Credits H. Credits People that have contributed to the project, one way or another.
Appendix H. 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 H. 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 H.
Appendix I. Licenses I. Licenses I.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 I. 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 I. 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 I. 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 I. 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 I. 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 I. 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 I. 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 I. Licenses I.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 I. 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 I. 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 I. 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 I. 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 I. 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 I. 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.