The Rockbox Manual for Sansa Clip+ 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.
Contents 4.1.3. Virtual Keyboard . . . . . 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.
Contents 6.3. Volume Limit . . . . . . . . . 6.4. Treble . . . . . . . . . . . . . 6.5. Balance . . . . . . . . . . . . 6.6. Channels . . . . . . . . . . . 6.7. Stereo Width . . . . . . . . . 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.
Contents 8.5.5. Keyclick . . . . . . . . . . 8.5.6. USB Hide Internal Drive . 8.6. Startup/Shutdown . . . . . . . . 8.6.1. Start Screen . . . . . . . . 8.6.2. Idle Poweroff . . . . . . . 8.6.3. Sleep Timer . . . . . . . . 8.7. Bookmarking . . . . . . . . . . . 8.8. Automatic resume . . . . . . . . 8.9. Language . . . . . . . . . . . . . 8.10. Voice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 12.1.15.Pegbox . . . . . . . . 12.1.16.Pong . . . . . . . . . . 12.1.17.Reversi . . . . . . . . 12.1.18.Robotfindskitten . . . 12.1.19.Rockblox . . . . . . . 12.1.20.Rockblox1d . . . . . . 12.1.21.Sliding Puzzle . . . . . 12.1.22.Snake . . . . . . . . . 12.1.23.Snake 2 . . . . . . . . 12.1.24.Sokoban . . . . . . . . 12.1.25.Solitaire . . . . . . . . 12.1.26.Spacerocks . . . . . . 12.1.27.Star . . . . . . . . . . 12.1.28.Sudoku . . . . . . . . 12.1.29.Wormlet . . . . . . . . 12.1.30.Xobox . . . .
Contents 12.3.11.Shopper . . . . . . . . . 12.3.12.Sort . . . . . . . . . . . 12.3.13.Text Viewer . . . . . . . 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 . . . . . .
Contents 13.4. Firmware Loading . . . . . . . . . . . . 13.4.1. Using ROLO (Rockbox Loader) . 13.5. Optimising battery runtime . . . . . . . 13.5.1. Display backlight . . . . . . . . . 13.5.2. Replaygain . . . . . . . . . . . . 13.5.3. Peak Meter . . . . . . . . . . . . 13.5.4. Audio format and bitrate . . . . 13.5.5. Sound settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents D.17.Current Screen . . . . . . . . . . . D.18.List Title (.sbs only) . . . . . . . D.19.Changing Volume . . . . . . . . . . D.20.Settings . . . . . . . . . . . . . . . D.21.Images . . . . . . . . . . . . . . . . D.22.FM Radio . . . . . . . . . . . . . . D.23.Alignment and language direction . D.24.Conditional Tags . . . . . . . . . . D.25.Subline Tags . . . . . . . . . . . . D.26.Time and Date . . . . . . . . . . . D.27.Text Translation . . . . . . . . . . D.28.Bar 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 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 DRM capability. It is possible that installation of the bootloader may lead to you permanently losing the ability to playback files with DRM. USB connection. To transfer Rockbox to your player you need to connect it to your computer.
Chapter 2. Installation directory called .rockbox which contains all of the Rockbox files, and is located in the root of your player’s drive. Apart from the required parts there are some addons you might be interested in installing. 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.
Chapter 2. Installation Release. The release version is the latest stable release, free of known critical bugs. For a manual install, the current stable release of Rockbox is available at http: //www.rockbox.org/download/. 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.
Chapter 2. Installation If the contents of the .zip file are extracted correctly, you will have a directory called .rockbox, which contains all the files needed by Rockbox, in the main directory of your player’s drive. Installing the bootloader In order to install the bootloader, you will need to download the following files: • An original firmware (OF) from http://forums.sandisk.com/t5/Clip-Clip/SansaClip-Firmware-Update-01-02-15/td-p/150227 • The bootloader: http://download.rockbox.
Chapter 2. Installation If mkamsboot does not report success, then retry or abort. 4. Copy the output file (“patched.bin” in the example given above) to the root of the device and rename it to the same name as the OF file you downloaded earlier (“clppa.bin” above). 2.2.5. Finishing the install Safely eject the device, unplug USB and wait for the firmware update to finish. Don’t try to power off the device, it will shutdown by itself after a minute. 2.2.6.
Chapter 2. Installation 18 2.5.1. Automatic Uninstallation You can uninstall Rockbox automatically by using Rockbox Utility. If you installed Rockbox manually you can still use Rockbox Utility for uninstallation but will not be able to do this selectively. 2.5.2. Manual Uninstallation Copy an unmodified original firmware to your player, and then reboot into the Sandisk firmware. See section 3.1.3 (page 20) for more information. If you wish to clean up your disk, you may also wish to delete the .
Chapter 3. Quick Start 19 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. The buttons are described in detail in the following paragraph. Additional information for blind users is available on the Rockbox website at ZBlindFAQ.
Chapter 3. Quick Start 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. 3.1.3. Starting the original firmware Rockbox has a dual-boot feature. To boot into the original firmware, press and hold the Left button while turning on the player. Note: Rockbox does not boot into the original firmware when powered by a USB connection.
Chapter 3. Quick Start 21 3.1.6. Basic controls When browsing files and moving through menus you usually get a list view presented. The navigation in these lists are usually the same and should be pretty intuitive. In the tree view use Submenu and Play to move around the selection. Use Select or Right to select an item. When browsing the file system selecting an audio file plays it. The view switches to the “While playing screen”, usually abbreviated as “WPS” (see section 4.3 (page 29).
Chapter 3. Quick Start 22 using .cfg files. This topic is discussed in more detail in section 13.3 (page 157). The Rockbox distribution comes with some themes that should look nice on your player. Note: Some of the themes shipped with Rockbox need additional fonts from the fonts package, so make sure you installed them. Also, if you downloaded additional themes from the Internet make sure you have the needed fonts installed as otherwise the theme may not display properly. b 3.3.
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 Play/Submenu 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 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. Only visible if a file or directory name is on the clipboard. When selected it will move or copy the clipboard to the current directory. Delete.
Chapter 4. Browsing and playing 4.1.3. Virtual Keyboard Figure 4.3.: The virtual keyboard This is the virtual keyboard that is used when entering text in Rockbox, for example when renaming a file or creating a new directory. The virtual keyboard can be easily changed by making a text file with the required layout. More information on how to achieve this can be found on the Rockbox website at ZLoadableKeyboardLayouts.
Chapter 4. Browsing and playing database uses to sort the songs can be completely customised. More information on how to achieve this can be found on the Rockbox website at ZDataBase. 4.2.2. Initializing the Database The first time you use the database, Rockbox will scan your disk for audio files. This can take quite a while depending on the number of files on your player. This scan happens in the background, so you can choose to return to the Main Menu and continue to listen to music.
Chapter 4. Browsing and playing 28 Export Modifications This allows for the runtime data to be exported to the file /.rockbox/database_changelog.txt, which backs up the runtime data in ASCII format. This is needed when database structures change, because new code cannot read old database code. But, all modifications exported to ASCII format should be readable by all database versions. Import Modifications. Allows the /.rockbox/database_changelog.txt backup to be conveniently loaded into the 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 151) for details of customising your WPS (While Playing Screen). 4.3.1. WPS Key Controls Key Action Volume Up / Volume Down Left 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 41). 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 32 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 33 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. read into the player’s memory) will be played. This may even be the whole track. Pitch The Pitch Screen allows you to change the rate of playback (i.e.
Chapter 4. Browsing and playing Key Action Home 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). Increase / Decrease pitch by 1% (in procentual mode) or a 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. Play / Submenu Long Play / Long Submenu Left / Right Select Power 4.4.
Chapter 4. Browsing and playing 35 By selecting (“playing”) a song from the File Browser Whenever a song is selected from the File Browser with Select or Right, 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 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 37 Note: To view, save or reshuffle the current dynamic playlist use the Playlist sub menu in the WPS context menu or in the Main Menu. 4.4.4. Modifying playlists Reshuffling Reshuffling the current playlist is easily done from the Playlist sub menu in the WPS, just select Reshuffle.
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 Home button. All settings are stored on the unit. However, Rockbox does not access the flash storage 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.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 29)). 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 player back to initial configuration. The details of this menu are covered in section 13.3 (page 157). 5.8. Recording 5.8.1. While Recording Screen Figure 5.3.: The while recording screen Selecting the Recording option in the Main Menu enters the Recording Screen, whilst pressing Long Select enters the Recording Settings (see section 10 (page 76)). The Recording Screen shows the time elapsed and the size of the file being recorded.
Chapter 5. The Main Menu 5.9. FM Radio Figure 5.4.: The FM radio screen This menu option switches to the radio screen. The FM radio has the ability to remember station frequency settings (presets). Since stations and their frequencies vary depending on location, it is possible to load these settings from a file. Such files should have the filename extension .fmr and reside in the directory /.
Chapter 5. The Main Menu 43 Saving a preset: Up to 64 of your favourite stations can be saved as presets. Long Select to go to the menu, then select Add preset. Enter the name (maximum number of characters is 32). Press Long Select to save. Selecting a preset: Select to go to the presets list. Use Volume Up and Volume Down to move the cursor and then press Select or Right to select. Use Left to leave the preset list without selecting anything. Removing a preset: Select to go to the presets list.
Chapter 5. The Main Menu 5.12. 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. Memory size and amount of free space on the two data volumes, this info is given separately for internal memory (Int) and for a plugged in memory card (MSD). Credits: Display the list of contributors. Running Time: Shows the runtime of your player in hours, minutes and seconds.
Chapter 5. The Main Menu 5.14. Shortcuts This menu item is a container for user defined shortcuts to files, folders or settings. With a shortcut, • A file can be “run” (i.e. a music file played, plugin started or a .
Chapter 5. The Main Menu separator data is ignored; name can be used to display text, or left blank to make the list more accessible with visual gaps 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.
Chapter 6. Sound Settings 47 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 48 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 49 6.8. 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 50 6.9. Equalizer Figure 6.2.: The graphical equalizer Rockbox features a parametric equalizer (EQ). In contrast to non-parametric equalizers, a parametric EQ enables adjusting the center frequency, gain, and width of EQ bands separately. The ability to adjust the frequency and width of bands enables more precise control of the EQ frequency response while avoiding the use of a large number of bands (often 12+) needed in a non-parametric EQ.
Chapter 6. Sound Settings certain frequency limit, much as the “bass” control found on ordinary stereo systems does. Adjust the “cutoff” frequency parameter to decide where the shelving starts to take effect. For example, a cutoff frequency of 50 Hz will adjust only very low frequencies. A cutoff frequency of 200 Hz, on the other hand, will adjust a much wider range of bass frequencies. The “gain” parameter controls how much the loudness of the band is adjusted.
Chapter 6. Sound Settings Pre-cut. If too much positive gain is added through the graphical EQ, your music may distort. The Precut setting allows you to apply a global negative gain to decoded audio, cancelling out positive gain from the EQ. This will prevent distortion when boosting certain frequency ranges, at the expense of making audio quieter. Alternatively, precut can be used with a flat EQ curve to implement a volume cap.
Chapter 6. Sound Settings 53 6.11. Timestretch Enabling Timestretch allows you to change the playback speed without it affecting the pitch of the recording. After enabling this feature and rebooting, you can access this via the Pitch Screen. This function is intended for speech playback and may significantly dilute your listening experience with more complex audio. See section 4.3.3 (page 33) for more details about how to use the feature. 6.12.
Chapter 6. Sound Settings 54 There are several settings associated with the compressor. The first, and most important, is the Threshold. The threshold is the audio input level at which the compressor begins to act. Any level louder than the threshold will be compressed to some extent. The maximum amount of compression, or the quietest level at which the compressor will operate, is -24 dB. The default of Off disables the compressor. The Makeup Gain setting has two options: Off and Auto.
Chapter 7. Playback Settings 55 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 34). Options: Yes/No. 7.2.
Chapter 7. Playback Settings 56 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 Fade In Delay. The “fade in delay” is the length of time between when the crossfade process begins and when the new track begins to fade in. Fade In Duration. The length of time, in seconds, that it takes your music to fade in once the Fade In Delay has ended. Fade Out Delay. The “fade out delay” is the length of time between when the crossfade process begins and when the old track begins to fade out. Fade Out Duration.
Chapter 7. Playback Settings 58 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). Options for replaygain are: Replaygain Type. Choose the type of replaygain to apply: Album Gain.
Chapter 7. Playback Settings 59 Note: This feature only works when songs have been played from the file browser. Using it with the database may cause unexpected behaviour. b 7.11. Constrain Auto-Change If enabled and you have set Start File Browser Here to a directory other than root, Auto-Change Directory will be constrained to the directory you have chosen and those below it. See section 4.1.2 (page 25). 7.12. Last.fm Log Enables logging of your played tracks for submittal to http://www.last.fm.
Chapter 7. Playback Settings 60 7.15. Prevent Track Skipping If this option is enabled, the ability to manually skip tracks is disabled in order to avoid accidental track skips. It does not prevent changing tracks if a track ends, which can be achieved by combining this option with Repeat set to One 7.16. Rewind Before Resume When restarting a track or a bookmark, a short rewind can be done before the playback is started.
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 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. Scrolling. This feature controls how text will scroll in Rockbox. You can configure the following parameters: Scroll Speed.
Chapter 8. General Settings 65 Peak Release. This determines how fast the bar shrinks when the music becomes softer. Lower values make the peak meter look smoother. Expressed in scale units per 10 ms. Peak Hold Time. Specifies the time after which the peak indicator will reset. For example, if you set this value to 5 s, the peak indicator displays the loudest volume value that occurred within the last 5 seconds.
Chapter 8. General Settings 66 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 set to On, Rockbox will pause playback when the external power off condition is detected. Rockbox will then shutdown the player after the length of time set in the Idle Poweroff setting (see section 8.6.2 (page 68)). If power to the DC in jack is turned back on before the Idle Poweroff function has shut the player off, playback will be resumed 5 seconds after the power is applied. This delay is to allow for the time while the car engine is being started.
Chapter 8. General Settings 68 Settings. Display the main settings menu. Recording. Start the player in the recording screen (recording does not start automatically). FM Radio. Go to the radio screen and start playing. Recent Bookmarks. Show the list of recent bookmarks as described in section 8.7 (page 68). 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.
Chapter 8. General Settings 69 same track. When there’s already a bookmark for a directory or playlist, new bookmarks are added before existing ones. 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.
Chapter 8. General Settings Maintain a list of Recent Bookmarks. If this option is enabled, a list of the most recently created bookmarks may be accessed through the Recent Bookmarks option in the Main Menu. This list contains up to ten entries. 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.
Chapter 8. General Settings 71 A track’s resume position is updated whenever playback of that track stops, including when explicitly stopping the track, powering off the player, or starting playback of another track. 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.
Chapter 8. General Settings • Plugins and the wake up alarm do not support voice features. 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.
Chapter 8. General Settings Announce Battery Level. When this option is enabled the battery level is announced when it falls under 50%, 30% and 15%. See ZVoiceHowto for more details on configuring speech support in Rockbox.
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 Select or Right 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 Battery Display. Controls whether the battery charge status is displayed as a graphic or numerical percentage value on the Status Bar. Line Selector Type. This option allows you to select which type of line selector to use. Pointer. A small arrow to the left of the menu text. Bar (inverse). A bar with inverted foreground and background colour.
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 77 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.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. The recording trigger provides you with a tool to automatically distinguish between sound and silence and record the sound only.
Chapter 10. Recording Settings 79 record via a digital input as even the noise of the device itself would exceed this threshold immediately. for at least. The start duration defines the minimal duration that a signal must exceed the start threshold to start the recording. Depending on your situation you may want to set this setting to 0 (e.g. when copying a song from a commercial medium) or to quite big values.
Chapter 11. Time and Date 80 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. Wake-Up Alarm: This option will make the player start up at the specified time. Use Right and Left to adjust the minutes setting, Left and Right to adjust the hours. Select confirms the alarm, and Power cancels setting an alarm. If the player is turned on again before the alarm occurs, the alarm will be cancelled.
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 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. Allows you to shoot bricks with paddle. Ball sticks to paddle each time it hits. Immediately fires another ball. Flip left / right movement. Key Action Left / Right Volume Down / Volume Up Select / Play Power Moves the paddle Release the ball / Fire Open menu / Quit 12.1.4. Bubbles Figure 12.3.
Chapter 12. Plugins Key Action Play Left / Right Select Power or Long Power Pause game Aim the bubble Fire bubble Exit to menu 12.1.5. 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.
Chapter 12. Plugins 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 Action Select Power Make chopper fly Enter menu 12.1.7. Dice Dice is a simple dice rolling simulator. Select number and type of dice to roll in a menu and start by choosing “Roll Dice”. The result is shown as individual numbers as well as the total of the rolled dice. Key Action Select Power Roll dice again Quit 12.
Chapter 12. Plugins 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. Place wad files in this directory.
Chapter 12. Plugins New Game. Start a new game Options. In game options Load Game. Load a saved game Save Game. Save the current game Quit. Quit the game InGame Options Menu. This menu has the following options: End Game. Ends the current game Messages. Enable or Disable in game messages Screen Size. Shrink or Enlarge the displayed portion of the game Gamma. Change the brightness (Gamma) of the game Sound Volume.
Chapter 12. Plugins 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. Key Action Play / Submenu / Left / Right Home Home+Left Home+Right Move the cursor Home+Select Solve step by step Power Quit the game Flip Shuffle Solve 12.1.10. Goban Figure 12.8.
Chapter 12. Plugins are rare, but if you have one don’t even try it (the file will most likely be corrupted if you save over it). You have been warned. The file /sgf/gbn_def.sgf is used by the plugin to store any unsaved changes in the most recently loaded game. This means that if you forget to save your changes, you should load /sgf/gbn_def.sgf immediately to offload the changes to another file. If you load another file first then your changes will be lost permanently. The /sgf/gbn_def.
Chapter 12. Plugins Save. Save the current state of the game. It will be saved to /sgf/gbn_def.sgf unless otherwise set. Save As. Save to a specified file. Game Info. View and modify the metadata of the current game. Playback Control. Control the playback of the current playlist and modify the volume of your player. Zoom Level. Zoom in or out on the board. If you set the zoom level, it will be saved and used again the next time you open this plugin. Options. Open the Options Menu. Context Menu.
Chapter 12. Plugins Event. The name of the event which this game was a part of, if any. Place. The place that this game took place. Round. If part of a tournament, the round number for this game. Done. Return to the previous menu. Options. Customize the behavior of the plugin in certain ways. Show Child Variations? Enable this to mark child variations on he board if there are more than one. Note: variations which don’t start with a move are not visible in this way.
Chapter 12. Plugins Mark Mode. Add generic marks to the board, or remove them. Circle Mode. Add circle marks to the board, or remove them. Square Mode. Add square marks to the board, or remove them. Triangle Mode. Add triangle marks to the board, or remove them. Label Mode. Add one character labels to the board. Each label starts at the letter ‘a’ and each subsequent application of a label will increment the letter.
Chapter 12. Plugins 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. In puzzle mode the aim of the game is to connect the puzzles, by skilful swapping pairs of jewels. Key Action Left/Right/ Play/Submenu Move the cursor around the jewels Select Power Select a jewel Menu 12.1.13. MazezaM Figure 12.11.
Chapter 12. Plugins 12.1.14. Minesweeper Figure 12.12.: Minesweeper plugin The classic game of minesweeper. The aim of the game is to uncover all of the squares on the board. If a mine is uncovered then the game is over. If a mine is not uncovered, 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.
Chapter 12. Plugins Key Action Play, Submenu, Left, Right Select Home Volume Up Volume Down Power to move around to to to to to choose peg restart level go up a level go down a level quit 12.1.16. Pong Figure 12.14.: 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 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.18. Robotfindskitten Figure 12.15.: 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.
Chapter 12. Plugins Key Action Home Left Right Submenu Volume Down Restart game Move left Move right Move down Rotate anticlockwise Volume Up/Play Select Power Rotate clockwise Drop Quit 12.1.20. Rockblox1d Rockblox1d is a game for people who find rockblox too hard. In this version the second dimension is missing so the user only has to move the bricks down. No horizontal moving anymore and no need to rotate the brick! Key Action Submenu Power or Long Power Move down faster Quit 12.1.21.
Chapter 12. Plugins Key Action Left, Right, Play and Submenu Home Select Move Tile Power Shuffle Switch between pictures (default puzzle, and your own image if launched via Open With), and numbered tiles Stop the game 12.1.22. Snake Figure 12.18.: 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 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. Key Action Play / Submenu / Left / Right Select Power Steer the snake Pause and resume the game Quit In game A, the maze stays the same, in game B after an increasing number of apples eaten the maze is replaced by a new one. 12.1.24. Sokoban Figure 12.20.
Chapter 12. Plugins Key Action Play, Submenu, Left, Right Power Volume Down In game Move the “sokoban” up, down, left, or right Menu Back to previous level Select+Right Volume Up Select Home Select Play/Submenu Left/Right Power Restart level Go to next level Undo last movement Redo previously undone move Solution playback Pause/resume Increase/decrease playback speed Go backward/forward (while paused) Quit Some places where can you can find level sets: • http://www.sourcecode.se/sokoban/levels.
Chapter 12. Plugins Key Action Play / Submenu / Left / Right Select Move Cursor around. Volume Down Home Long Select Volume Up Power Select cards, move cards, reveal hidden cards... If a card was selected – unselect it, else Draw 3 new cards from the remains stack Put the card from the top of the remains stack on top of the cursor Put the card under the cursor on one of the 4 final colour stacks. Put the card on top of the remains stack on one of the final colour stacks. Show menu 12.1.26.
Chapter 12. Plugins 12.1.27. Star Figure 12.23.: 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. 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 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. The selected Sudoku will get loaded and you can start solving it. The sudoku games need to be stored as text files with the extension .ss as single file per game.
Chapter 12. Plugins 12.1.29. Wormlet Figure 12.25.: Wormlet game 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 Left Right Play Submenu 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 Walls. Don’t crash into the walls. Walls are not edible. Crashing a worm against a wall causes it a headache it doesn’t survive. Game over. The game is over when all worms are dead. The longest worm wins the game. Pause the game. Press to pause the game. Press it again to resume the game. Stop the game. There are two ways to stop a running game. • If you want to quit Wormlet entirely simply hit . The game will stop immediately and you will return to the game menu.
Chapter 12. Plugins Hints • Initially you will be busy with controlling your worm. Try to avoid other worms and crawl far away from them. Wait until they curl up themselves and collect the food afterwards. Don’t worry if the other worms grow longer than yours - you can catch up after they’ve died. • When you are more experienced watch the tactics of other worms. Those worms controlled by artificial stupidity head straight for the nearest piece of food.
Chapter 12. Plugins XWorld requires the data files, BANK* and MEMLIST.BIN, from the original “Another World” PC game to be copied into the .rockbox/xworld/ directory before the game can be played. Additionally, “extra” data files that modify the in-game strings and font can be placed in the .rockbox/xworld/ directory with the names xworld.strings and xworld.font, respectively. Key Action Play Submenu Left / Right Select Power Up and Jump Down and Crouch Move Left and Right Action and Fire Menu 12.
Chapter 12. Plugins Xadd/Yadd. How fast the code moves on the sine curve on each axis Xsane/Ysane. Changes the appearance of the bouncing. 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. 12.2.3. Cube Figure 12.28.: Cube This is a rotating cube screen saver in 3D.
Chapter 12. Plugins Demystify is a screen saver like demo. Key Action Left / Right Play / Submenu Power Increase / decrease speed Add / remove polygon Quit 12.2.5. Fire Figure 12.30.: Fire Fire is a demo displaying a fire effect. Key Action Play / Submenu Left Right Power Increase / decrease number of flames Toggle flame type Toggle moving flames Quit 12.2.6. Fractals Figure 12.31.
Chapter 12. Plugins Key Action Direction keys Volume Up Volume Down Move about the image Zoom in Zoom out Select+Left Decrease iteration depth (less detail) Select+Right Increase iteration depth (more detail) Home Power Reset and return to the default image Quit 12.2.7. Logo Demo showing the Rockbox logo bouncing around the screen. Key Action Right / Left Play / Submenu Power or Long Power Increase / decrease speed on the x-axis Increase / decrease speed on the y-axis Quit 12.2.8.
Chapter 12. Plugins 12.2.9. Oscilloscope Figure 12.33.: 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.
Chapter 12. Plugins Requirements PictureFlow uses both the album art (see section C (page 169)) and database (see section 4.2 (page 26)) features of Rockbox. It is therefore important that these are working correctly before attempting to use PictureFlow. In addition, there are some other points of which to be aware: • PictureFlow will accept album art larger than the dimensions of the screen, but the larger the dimensions, the longer they will take to scale.
Chapter 12. Plugins 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. Allows setting the album title to be shown above or below the cover art, or not at all. Resize Covers. Set whether to automatically resize the covers or to leave them at their original size.
Chapter 12. Plugins Key Action Select Submenu Right Left Power Play/pause Change growth mode Next generation Status (only when paused) Exit 12.2.13. Snow Figure 12.36.: 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 Power or Long Power to quit. 12.2.14. Starfield Figure 12.37.: Starfield Starfield simulation (like the classic screensaver).
Chapter 12. Plugins 12.2.15. VU meter Figure 12.38.: 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 Home. 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.
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 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 .gif Note: When an audio file is playing the size of the image is limited as the decoding process needs to share memory with audio tracks. To be able to view a bigger file you may need to stop playback.
Chapter 12. Plugins 12.3.5. Lua scripting language To quote from the Lua website (http://www.lua.org), Lua is a “powerful, fast, lightweight, embeddable scripting language”. Select a .lua file in the File Browser to run it. For more information on programming in Lua, please see http://www.lua.org/manual/5.1/ and http://www.lua.org/pil/. There are a few exceptions/additions to the Lua support in Rockbox: No floating point support.
Chapter 12. Plugins 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 .mpg extension but is encoded in the supported format, you will need to use the Open With... context menu option and choose mpegplayer.
Chapter 12. Plugins 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. Display Options Menu Dithering (default: off) Prevent banding effects in gradients by blending of colours.
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 Action Play / Submenu Left / Right Select Home Volume Down Direction keys Volume Up Power Select Open Rockboy menu A button B button Start 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. Set Keys (BUGGY) Select this option to set a new keymapping. Reset.
Chapter 12. Plugins 12.3.13. Text Viewer Figure 12.40.: 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 24)). You can also bookmark pages.
Chapter 12. Plugins UTF-8 (Unicode), This setting only applies to the plugin and is independent from the Default Codepage setting (see section 8.4 (page 65)). Word Wrap Toggle word wrap mode. On Break lines at the maximum column limit. Off (Chop Words) Break lines at white space or hyphen. Line Mode Change how lines are displayed. Normal Break lines at newline characters. Join Join lines together. Expand Add a blank line at newlines. Useful for making paragraphs clearer in some book style text files.
Chapter 12. Plugins 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. Scrollbar Toggle the vertical scrollbar for the current mode. If the file fits on one screen, there is no scrollbar and this setting has no effect.
Chapter 12. Plugins Figure 12.41.: 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 Submenu+Select. The bookmark will be displayed as shown below.
Chapter 12. Plugins 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. Selecting this option will remove the file automatically, if it is not used by another theme in the theme directory and not currently used. Never Remove. Selecting this option will always skip deleting the file. Always Remove.
Chapter 12. Plugins ZXBox is a port of the “Spectemu” ZX Spectrum 48k emulator for Rockbox (Zproject’s homepage). To start a game open a tape file or snapshot saved as .tap, .tzx, .z80 or .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.
Chapter 12. Plugins Invert Colours. Inverts the Spectrum colour palette, sometimes helps visibility. 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.
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.45.: 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 Left / Right / Play / Submenu Move the selector Select Volume Up / Volume Down Show memos for the selected day Previous / Next month Power Quit 12.4.5.
Chapter 12. Plugins Setup Key Action Right / Left Select Power 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.47.: Clock This is a fully featured analogue and digital clock plugin. Key configuration Key Action Left / Right Play / Submenu Power Select Long Select 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 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. If Time readout is in 12-hour (“12h”) mode, AM or PM will be displayed at the upper right. The Date readout, if enabled, is displayed at the lower left. The Counter, if enabled, is displayed at the lower right.
Chapter 12. Plugins Plain mode This mode shows a “plain” clock in large text that takes up nearly the whole LCD. 12.4.7. Disk Tidy Disk Tidy deletes junk files commonly left behind by Windows, Linux and OS X after connecting your player over USB. Select the files you want to delete in the “Files to Clean” menu and select “Start Cleaning” to begin the process. The settings are stored in the plain text file .rockbox/rocks/apps/disktidy.config that is user-modifiable to allow custom entries to be added.
Chapter 12. Plugins 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 Select. From the context menu you can create new entries, delete entries and edit entries. Each entry has a “title”, a “user name” and a “password”.
Chapter 12. Plugins 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.xx], or [mm:ss.xxx] where mm is minutes, ss is seconds, xx is tenth of milliseconds, and xxx is milliseconds.
Chapter 12. Plugins Controls Key Action Volume Up / Volume Down Left Volume up/down. Long Left Right Long Right Play Power or Select Long Select Home 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. Enter Lrcplayer Menu. Lrcplayer Menu Theme settings. Change theme related settings. Show Statusbar.
Chapter 12. Plugins 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. Changes will be saved automatically when the song is changed.
Chapter 12. Plugins 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. In contrast to the simple mode, there exists the notion of meter and bars, along with emphasis on certain beats.
Chapter 12. Plugins The syntax of programmed tracks in tempomap files follows the format defined by http://das.nasophon.de/klick/. Actually, the goal is to keep compatibility between klick and this Rockbox metronome. The parts of a track are specified one line each in this scheme (pieces in [] optional): [name:] bars [meter ]tempo[-tempo2[*accel|/accel] [pattern] [volume] The bar count and tempo always have to be specified, the rest is optional.
Chapter 12. Plugins 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. The UI is developed so that it fits into the display of a Sansa Clip+ and that is the hardware device it is tested on. It seems to work reasonably on some other models in the simulator.
Chapter 12. Plugins 12.4.15. 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. Menu Generate Folder List Generates a list of all folders found on the player. You can filter the directories which are scanned by creating a file called /.rockbox/folder_advance_dir.txt. Only the directories in this file and any contained directories will be scanned.
Chapter 12. Plugins 12.4.16. Resistor Calculator Figure 12.48.: Resistor calculator The resistor calculator is a plugin that works in 3 modes: Colour to Resistance In Colour to Resistance mode, use the menus to select the colours of the bands of a resistor which you would like to know the resistance of.
Chapter 12. Plugins The stats plugin counts the directories and files (the total number as well as the number of audio, playlist, image and video files) on your player. Press Power or Long Power to abort counting and exit the plugin. Press it again to quit after counting has finished. 12.4.18. Stopwatch Figure 12.50.: Stopwatch A simple stopwatch program with support for saving times.
Chapter 12. Plugins Note: When you have not changed the file the Text Editor will quit immediately.
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 152 and the SBS or Base Skin. The WPS is the name used to describe the information displayed on the player’s screen whilst an audio track is being played, the FMS is the screen shown while listening to the radio, and the SBS lets you specify a base skin that is shown in the menus and browsers, as well as the WPS and FMS. The SBS also allows you to control certain aspects of the appearance of the menus/browsers.
Chapter 13. Advanced Topics this section. All elements placed before the line defining a viewport are displayed in the default viewport. Elements defined after a viewport declaration are drawn within that viewport. Loading images (see Appendix section D.21 (page 180)) should be done within the default viewport. A viewport ends either with the end of the file, or with the next viewport declaration line. Viewports sharing the same coordinates and dimensions cannot be displayed at the same time.
Chapter 13. Advanced Topics 154 Example %?mh<%Vd(a)|%Vd(b)> %Vl(a,10,10,50,50,-) %sYou could now show a hold icon using the %%xl and %%xd tags. %Vl(a,0,70,70,14,1) %s%acYour DAP is locked. %Vl(b,20,14,50,14,1) %t(1)%acWarning:;%t(.1) %Vl(b,20,30,50,50,0) %sYou’ve unlocked your player. This example checks for hold. Viewport ‘a’ will be displayed if it is on, otherwise viewport ‘b’ will display a flashing warning.
Chapter 13. Advanced Topics An example would be: %Fl(2,12-Nimbus.fnt,100) 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.
Chapter 13. Advanced Topics 156 %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 159 Reset Settings This wipes the saved settings in the player and resets all settings to their default values. Save .cfg File This option writes a .cfg file to your player’s disk. The configuration file has the .cfg extension and is used to store all of the user settings that are described throughout this manual. Hint: Use the Save .cfg File feature (Main Menu → Manage Settings) to save the current settings, then use a text editor to customize the settings file.
Chapter 13. Advanced Topics 160 sample and is therefore consuming additional CPU time. If you want to achieve some (minor) savings in runtime, switch this feature off (see section 7.8 (page 57)). 13.5.3. Peak Meter The peak meter is a feature of the While Playing Screen and will be updated with a high framerate. Depending on your player this might result in a high CPU load. To save battery runtime you should switch this feature off (see section 4.3.2 (page 31)). 13.5.4.
Appendix A.
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 FM Presets .ch8 .cue .fmr Font .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 Linear PCM 8/16/24/32 bit, IEEE float 32/64 bit, ITU-T G.711 alaw/µ-law, QuickTime IMA ADPCM Monkey’s Audio Sun Audio .ape, .mac .au, .snd Free Lossless Audio .flac Apple Lossless Shorten True Audio Wave64 .m4a, .mp4 .shn .tta .w64 Waveform audio format .wav Wavpack .wv 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. Note: There is always only one tag type supported for each file extension.
Appendix B. Audio and metadata formats 168 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 169 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. For this feature to work, there are a few requirements. C.1. Limitations Rockbox currently only supports loading images located on the flash storage for use in PictureFlow. The image files must be in either BMP or JPEG format.
Appendix C. Album Art 170 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 151), 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.28 (page 184). 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 172 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 173 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. Can also be used in a conditional: %?bl<-1|0|1|2|...
Appendix D. Theme Tags 174 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 176 • ‘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 flash storage 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 178 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 180 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 182 D.23. 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 D. Theme Tags %?if(%pv, >=, 0) will display “Clipping possible” if the volume is higher than or equal to 0 dB, “Volume OK” if it is lower. %?if(%ia, =, %Ia) – this artist and the next artist are the same. Note: When performing a comparison against a string tag such as %ia, only = and != work, and the comparison is not case sensitive. D.25. Subline Tags Tag Description %t(time) ; Set the subline display cycle time (%t(5) or %t(3.
Appendix D. Theme Tags 184 D.27. Text Translation Tag Description %Sx(English) Display the translation of “English” in the current language • “English” must be a phrase used in the language file. • 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. D.28. Bar Tags Some tags can be used to display a bar which draws according to the value of the tag.
Appendix D. Theme Tags nofill – don’t draw the bar, only its frame (for use with the “slider” option). noborder – don’t draw the border for image-less bars, instead maximise the filling over the specified area. This doesn’t work for bars which specify an image. nobar – don’t draw the bar or its frame (for use with the “slider” option). setting – Specify the setting name to draw the bar from (bar must be %St type), the next param is the settings config name.
Appendix D. Theme Tags 186 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). You can specify up to ten scrolling lines. Scrolling lines can not contain dynamic content such as timers, peak meters or progress bars.
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 rewind duration on pause disable autoresume if phones not present Last.
Appendix E.
Appendix E. Config file options Setting Allowed Values Unit peak meter busy peak meter dbfs on, off on, off peak meter min peak meter max statusbar scrollbar scrollbar width 0 to 89 (dB) or 0 to 100 (%) 0 to 89 /(dB) or 0 to 100 (%) 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 F. Menu Overview 192 F.
Appendix G. User feedback 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 194 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.
