3.1.7. Basic concepts

Playlists Rockbox is playlist oriented. This means that every time you play an audio le, a socalled dynamic playlist is generated, unless you play a saved playlist. You can modify the dynamic playlist while playing and also save it to a le. If you do not want to use playlists you can simply play your les directory based. Playlists are covered in detail in section 4.4 (page 35). 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 le browser and the WPS have a context menu. From the le browser this can be accessed with Long Navi. The contents of the context menu vary, depending on the situation it gets called. The context menu itself presents you with some operations you can perform with the currently highlighted le. In the le browser this is the le (or directory) that is highlighted by the cursor. From the WPS this is
ID3 Tags, Vorbis comments, etc.
the currently playing le. Also there are some actions that do not apply to the current le but refer to the screen from which the context menu gets called. One example is the playback menu, which can be called using the context menu from within the WPS.

3.2. Customising Rockbox

Rockbox User Interface can be customised using Themes. Themes usually only aect the visual appearance, but an advanced user can create a theme that also changes various other settings like le view, LCD settings and all other settings that can be modied using.cfg les. This topic is discussed in more detail in section 12.3 (page 171). 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.

3.3. USB Charging

To charge your player over USB, hold any button while plugging it in. This will prevent it from connecting to your computer and let you continue to use it normally. Your player must already be in Rockbox for this to function. Note: Be aware that this button may still perform its normal function, so it is recommended to use a button without harmful side eects, such as A-B.

The Playback Settings menu allows you to congure settings related to audio playback. The details of this menu are covered in section 7 (page 56).

5.7.3. General Settings

The General Settings menu allows you to customise the way Rockbox looks and the way it plays music. The details of this menu are covered in section 8 (page 62).

5.7.4. Theme Settings

The Theme Settings menu contains options that control the visual appearance of Rockbox. The details of this menu are covered in section 9 (page 75).
5.7.5. Recording Settings
The Recording Settings menu allows you to congure settings related to recording. The details of this menu are covered in detail in section 10 (page 77).

5.7.6. Manage Settings

The Manage Settings option allows the saving and re-loading of user conguration settings, browsing the hard drive for alternate rmwares, and nally resetting your player back to initial conguration. The details of this menu are covered in section 12.3 (page 171).

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 Navi enters the Recording Settings (see section 10 (page 77)). The Recording Screen shows the time elapsed and the size of the le being recorded. A peak meter is present to allow you set gain correctly. There is also a volume setting, this will only aect the output level of the player and does not aect the recorded sound. If enabled in the peak meter settings, a counter in front of the peak meters shows the number of times the clip indicator was activated during recording. The counter is reset to zero when starting a new recording. Note: When you start a recording, the hard disk will spin up. This will cause the peak meters to freeze in the process. This is expected behaviour, and nothing to worry about. The recording continues during the spin up. The frequency and channels settings are shown in the status bar. The controls for this screen are:
Chapter 5. The Main Menu Key Up / Down Left / Right Play Action Select setting. 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 le and open a new one. Open Recording Settings (see section 10 (page 77)).

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 dierent 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. Maintain a constant volume level between albums, but keep any intentional volume variations between songs in an album. (If album gain value is not available, uses track gain information). Track Gain. Maintain a constant volume level between tracks. If track gain value is not available, no replaygain is applied. Track Gain If Shuing. Maintains a constant volume between tracks if Shuffle is set to Yes. Reverts to album mode if Shuffle is set to No. O. Do not process replaygain information, i.e. turn o the replaygain function. Prevent Clipping. Avoid clipping of a songs waveform. If a song would clip during playback, the volume is lowered for that song. Replaygain information is needed for this to work.
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. Track Skip Beep

Controls the volume of the beep that is heard when skipping forward or backward between tracks. The beep is disabled when set to Off.
7.11. Auto-Change Directory
Control what Rockbox does when it reaches the end of a directory. If Auto-Change Directory is set to Yes, Rockbox will continue to the next directory. If Auto-Change Directory is set to No, playback will stop at the end of the current playlist. Using the Random feature requires you to rst generate a folder list via the Random Folder Advance Conguration plugin (see section 11.4.14 (page 155)). Note: You must have the Repeat option set to No for Auto-Change Directory to function properly. Note: This feature only works when songs have been played from the le browser. Using it with the database may cause unexpected behaviour.

Only when viewing all types. Only show le extensions when Show Files is set to All. Follow Playlist. This option determines what directory the File Browser displays rst. If Follow Playlist is set to Yes, when you enter the File Browser from the WPS, you will nd yourself in the same directory as the currently playing le. If Follow Playlist is set to No, when you enter the File Browser from the WPS, you will nd 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 rst 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 eect on the Database browser. If set to Current Directory Only or Full Path, then the title of each menu will be displayed on the rst line in the Database Browser.

8.3. Database

This sub menu allows you to congure the database. See section 4.2 (page 27) for more information about using the database.

8.4. Display

LCD Settings. This sub menu contains settings that relate to the display of the player. Backlight. The amount of time the backlight shines after a key press. If set to Off, the backlight will not light when a button is pressed. If set to On, the backlight will never shut o. If set to a time (1 to 90 seconds), the backlight will stay lit for that amount of time after a button press. Backlight (While Plugged In). This setting is equivalent to the Backlight setting except it applies when the player is plugged into the charger. Backlight on Hold. This setting controls the behavior of the backlight when the Hold switch is toggled. If set to Normal the backlight will behave as usual. If set to Off the backlight will be turned o immediately when the Hold switch is engaged and if set to On the backlight will be turned on and stay on while the Hold switch is engaged. Caption Backlight. This option turns on the backlight a number of seconds before the start of a new track, and keeps it on for the same number of seconds after the beginning so that the display can be read to see song information. The amount of time is determined by the value of the backlight timeout setting, but is no less than 5 seconds.

Backlight Fade In. This options turns on smooth backlight fading when the backlight is turning on. The fading time is dependent on the brightness level you have chosen. If it is turned o, the backlight will turn on immediately. Backlight Fade Out. This options turns on smooth backlight fading when the backlight is turning o. The fading time is dependent on the brightness level you have chosen. If it is turned o, the backlight will turn o immediately. First Keypress Enables Backlight Only. With this option enabled the rst keypress while the backlight is turned o will only turn the backlight on without having any other eect. When disabled the rst keypress will also perform its appropriate action. Brightness. Changes the brightness of your LCD 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. Similar to the main unit backlight this option controls the backlight timeout for the remote control. The remote backlight is independent from the main unit backlight. Backlight on When Plugged. This controls the backlight when the player is plugged into the charger. Caption Backlight. This option turns on the backlight a number of seconds before the start of a new track, and keeps it on for the same number of seconds after the beginning so that the display can be read to see song information. The amount of time is determined by the value of the backlight timeout setting, but is no less than 5 seconds. First Keypress Enables Backlight Only. This controls what happens when you press a button on your remote while the backlight is turned o. Like for the main unit, if this setting is set to Yes, the rst keypress will light up the remote backlight, but have no other eect. If set to No, the rst keypress will light up the remote backlight and engage the function of the key that is pressed. Contrast. Changes the contrast of your remotes LCD display. Warning: Setting the contrast too dark or too light can make it hard to nd this menu option again! LCD Mode. This setting lets you invert the whole screen, so now you get a black background and light text and graphics. 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.

Chapter 10. Recording Settings Note: The 11.025 kHz setting is not available when using MPEG Layer 3 format.

10.4. Source

Choose the source of the recording. The options are: Microphone, Line In and FM Radio. For more information on recording from the radio see section 5.9 (page 45).

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 congured to record to mono and the source is a stereo signal, use this setting to congure how the mono signal is created. Options are L, R and L+R.

10.7. File Split Options

This sub menu contains options for le splitting, which can be used to split up long recordings into manageable pieces. The splits are seamless (frame accurate), no audio is lost at the split point. The break between recordings is only the time required to stop and restart the recording, on the order of seconds. Split Measure. This option controls wether to split the recording when the Split Filesize is reached or when the Split Time has elapsed. What to do when Splitting. This controls what will happend when the splitting condition is fulllled the two available options here are Start a new file or Stop recording. Split Time. Set the time to record between each split, if time is used as Split Measure. Options (hours:minutes between splits): O, 00:05, 00:10, 00:15, 00:30, 1:00, 1:14 (74 minute CD), 1:20 (80 minute CD), 2:00, 4:00, 8:00, 10:00, 12:00, 18:00, 24:00. Split Filesize. Set the lesize to record between each split, if lesize is used as Split Measure.

10.8. Prerecord Time

This setting buers a small amount of audio so that when the record button is pressed, the recording will begin from that number of seconds earlier. This is useful for ensuring that a recording begins before a cue that is being waited for.
10.9. Clear Recording Directory
Resets the location where the recorded les are saved to the root of your players drive.

10.12. Automatic Gain Control
The Automatic Gain Control has ve dierent presets for automatically controlling the gain while recording. Safety (clip). This preset will lower the gain when the levels get too high (-1 dB) and will never increase gain.
Live (slow). This preset is designed to be used for recording of live shows and has quite large headroom for loud parts. It heads for a nominal target peak level of -9 dB and will slowly increase or decrease gain to reach it. DJ-Set (slow). This preset heads for a nominal target peak level of -5 dB and will slowly increase or decrease gain to reach it. Medium. This preset heads for a nominal target peak level of -6 dB and will increase or decrease gain to reach it. Voice (fast). This preset is designed to be used for voice recording and heads for a nominal target peak level of -7 dB and will quickly increase or decrease gain to reach it.

10.13. AGC clip time

This setting controls how long the level is too loud or soft before the Automatic Gain Control kicks in.

Chapter 11. Plugins

11. 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 le extension.rock. Most of them can be started from Browse Plugins in the Main Menu. Viewer plugins get started automatically by opening an associated le (i.e. text les, chip8 games), or from the Open with option on the Context Menu.

11.1. Games

See also the Chip-8 emulator in section 11.3.2 (page 127) and Rockboy in section 11.3.9 (page 134).

11.1.1. Blackjack

Figure 11.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 dicult, blackjack is a game renowned for the strategy involved. This version includes the ability to split, buy insurance, and double down.
Chapter 11. Plugins For the full set of rules to the game, and other facinating information visit http://www.blackjackinfo.com/blackjack-rules.php
Key Left / Right / Up / Down Play Rec Navi Stop

Chapter 11. Plugins Mark + * C Meaning
There are nodes after the current node in the SGF tree. There are sibling variations which can be navigated to using the Next Variation menu option of the Context Menu or the Rec button. There is a comment at the current node. It can be viewed/edited using the Add/Edit Comment menu option of the Context Menu.
Controls Key Up Down Left Right Navi Stop Play A-B Long Navi Rec Action Move cursor up Move cursor down Move cursor left Move cursor right Play a move (or use a tool if play-mode has been changed). Retreat one node in the game tree Advance one node in the game tree Main Menu Context Menu Go to the next variation when at the rst node in a branch
Menus Main Menu. The main menu for game setup and access to other menus. New. Create a new game with your choice of board size and handicaps. 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 specied le. 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. Open the Context Menu which allows you to set play modes and other tools. Quit. Leave the plugin. Any unsaved changes are saved to /sgf/gbn_def.sgf. Game Info. The menu for modifying game info (metadata) of the current game. This information will be saved to the SGF le 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. This text must follow the format specied at http://www.red-bean.com/sgf/properties.html#RE to be read by other SGF readers. Some examples are B+R (Black wins by resignation), B+5.5 (Black wins by 5.5 points), W+T (White wins on Time). Handicap. The handicap of the current game. Komi. The komi of the current game (compensation to the white player for black having the rst move). Ruleset. The name of the ruleset in use for this game. The NZ and GOE rulesets include suicide as a legal move (for multi-stone suicide only); the rest do not. Black Player. The name of the black player. Black Rank. Blacks rank, in dan or kyu. Black Team. The name of blacks team, if any. White Player. The name of the white player. White Rank. Whites rank, in dan or kyu. White Team. The name of whites team, if any. Date. The date that this game took place. This text must follow the format specied at http://www.red-bean.com/sgf/properties.html#DT to be read by other SGF readers. 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 dont start with a move are not visible in this way.

11.1.22. Rockblox

Figure 11.20.: Rockblox

Rockblox is a Rockbox version of the classic falling blocks game from Russia. The aim of the game is to make the falling blocks of dierent shapes form full rows. Whenever a row is completed, it will be cleared away, and you gain points. For every ten lines completed, the game level increases, making the blocks fall faster. If the pile of blocks reaches the ceiling, the game is over.
Key Play Left Right Down Navi Up A-B Hold switch Stop
Action Restart game Move left Move right Move down Rotate anticlockwise Rotate clockwise Drop Pause Quit

11.1.23. Rockblox1d

Rockblox1d is a game for people who nd 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 Navi Stop

Action Move down faster Quit

11.1.24. Rocklife

This an implementation of J. H. Conways Game of Life (see http://en.wikipedia.org/ wiki/Conway%27s_Game_of_Life for a detailed description). Rockbox can open les with a conguration description (.cells les). Just play such le and the game conguration stored in it will be loaded into this plugin. A.cells le is a text le. A capital O marks a live cell, a dot marks a dead cell, all other characters are ignored. Everything on a line starting with an exclamation sign (and including it) is a comment and is ignored.
Chapter 11. Plugins Key Navi Down Right Left Stop Action Play/pause Change growth mode Next generation Status (only when paused) Exit

11.1.25. Sliding Puzzle

Figure 11.21.: Sliding puzzle
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.21 (page 191)). You can also use the sliding puzzle plugin as a viewer for supported image types, to turn your own pictures into a puzzle. Key controls: Key Left, Right, Up and Down Navi Play Action Move Tile Shue Switch between pictures (default puzzle, album art, and your own image if launched via Open With), and numbered tiles Stop the game

the directory selected, or with the le selected in the le browser. You can then play the le or do with it whatever you want. The le will not be played automatically. If the.link le contains only one entry no list will be shown, you will directly jump to that location. The le shortcuts.link in the root directory is an exception. After playing it, the list will be shown even if the le 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 A-B. Deleting entries from other.link les is not possible. Advanced Usage Placing the line #Display last path segments=n (where n is a number) in the beginning of a.link le will leave just the last n segments of the entries when they are shown. For example, if n is chosen to be 1, then the entry /MyMusic/collection/song.mp3 will be shown as song.mp3. This allows you to hide common path prexes. You can also provide a custom display name for each entry individually. To do so, append a tabulator character after the entrys path followed by your custom name. That name will then be used for showing the entry. For example:
Example /MyMusic/collection/song.mp3<TAB>My favourite song!

11.3.2. Chip-8 Emulator

Chip8 is a kind of assembly language for a long-gone architecture. This plugin runs games written using the chip8 instructions. To start a game open a.ch8 le in the File Browser There are lots of tiny Chip8 games (usually only about 256 bytes to a couple of KB) which were made popular by the HP48 calculators emulator for them. The original Chip8 had 6432 pixel graphics, and the new superchip emulator supports 12864 graphics. The only problem is that they are based on a 44 keyboard, but since most games do not use all of the buttons, this can easily be worked around. To do this, one may put a.c8k le with the same name as the original program which contains new key mappings (for BLINKY.ch8, one writes a BLINKY.c8k le). That.c8k le contains 16 characters describing the mapping from the Chip8 keyboard to the default key mapping (that way, several Chip8 keys can be pressed using only one Rockbox key). For example, a le containing the single line:

Code 0122458469ABCDEF

would correspond to the following non-default mappings: 3 2, 6 8, 7 4, 8 6. The default keymappings are:
Chapter 11. Plugins Chip8 O Stop Navi 6 Right Down 9 A B C D E F
Some places where can you can nd.ch8 les: 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

11.3.3. Frotz

Frotz is a Z-Machine interpreter for playing Infocoms interactive ction games, and newer games using the same format. To start a game open a.z1 -.z8 le in the File Browser. Most modern games are in the.z5 or.z8 format but the older formats used by Infocom are supported. Z-Machine games are text based and most depend heavily on typed commands. The virtual keyboard is used for text entry, both for typing entire lines and for typing single characters when the game requires single character input. Sounds, pictures, colour and Unicode are not currently supported, but the interpreter informs the game of this and almost all games will adapt so that they are still playable. This port of Frotz attempts to be compliant with the Z-Machine Specication version 1.0. Some places where you can nd Z-Machine games, and information about interactive ction: The Interactive Fiction Archive, where many free modern works can be downloaded: http://www.ifarchive.org/ The specic folder on the if-archive containing Z-Machine games: http://www. ifarchive.org/indexes/if-archiveXgamesXzcode.html The Infocom homepage, with information about how to get the classic commercial Infocom games: http://www.csd.uwo.ca/Infocom/ The Frotz homepage (for the original Unix port): http://frotz.sourceforge.net/ A Beginners Guide to Playing Interactive Fiction: http://www.microheaven.com/ IFGuide/

Play Mode (default: Single) Set to All to play multiple.mpg les in the directory continuously. Clear all resumes: x Discard all x resume points. Display Options Menu Dithering (default: o) Prevent banding eects in gradients by blending of colours. (only available on Sansa e200, Sansa c200 and Gigabeat F/X) Display FPS (default: o) This option displays (once a second - if your video is fullscreen this means it will get overwritten by the video and appear to ash once per second) the average number of frames decoded per second, the total number of frames skipped (see the Skip Frames option), the current time (in 100 Hz ticks) and the time the current frame is due to be displayed. Limit FPS (default: on) With this option disabled, mpegplayer will display the video as fast as it can. Useful for benchmarking. Skip frames (default: on) This option causes mpegplayer to attempt to maintain realtime playback by skipping the display of frames - but these frames are still decoded. Disabling this option can cause loss of A/V sync. Backlight Brightness (default: Use setting) Choose brightness to use during video playback. Set to Use setting to use the Brightness setting. Audio Options Menu Tone Controls (default: force o) Use the bass and treble control settings or force them o.
Channel Modes (default: force o) Use the channel conguration setting or force Stereo mode. Crossfeed (default: force o) Use the Crossfeed setting or force crossfeed o. Equalizer (default: force o) Use the Equalizer setting or force the equalizer o. Dithering (default: force o) Use the Dithering setting or force audio dithering o. See this page in the Rockbox wiki for information on how to encode your videos to the supported format. ZPluginMpegplayer

11.3.8. MP3 Encoder

This plugin encodes a.wav le 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 le. Select Bitrate The following bitrates can be selected: 64, 80, 96, 112, 128, 160, 192, 224, 256, 320 kbps. Remark: Bitrates above 160 kbps cannot be used in MPEG 2 Layer 3 bitstreams. The encoder plugin automatically limits the output bitrate to 160 kbps for input les with a sample rate of 16, 22.05 or 24 kHz. The same limitation is valid for mono les. The output.mp3 le is written to the same path as the.wav le using the same lename. To use this plugin, open the Context Menu (see section 4.1.2 (page 24)) on a.wav le and select Open With. mp3_encoder. Note: The encoder will choose the appropriate bitstream format from the sample rate of the input le. The output bitstream format is MPEG 1 Layer 3 for 32, 44.1 and 48 kHz, and MPEG 2 Layer 3 for 16, 22.05 and 24 kHz. MPEG 2.5 Layer 3 is not supported.

Example %?mp<Stop|%Play|Pause|Ffwd|Rew>
The last else part is optional, and will be displayed if the tag has no value. The WPS parser will always display the last part if the tag has no value, or if the list of alternatives is too short.
Chapter 12. Advanced Topics Next Song Info
You can display information about the next song the song that is about to play after the one currently playing (unless you change the plan). If you use the upper-case versions of the three tags: F, I and D, they will instead refer to the next song instead of the current one. Example: %Ig is the genre name used in the next song and %Ff is the mp3 frequency. Note: The next song information will not be available at all times, but will most likely be available at the end of a song. We suggest you use the conditional display tag a lot when displaying information about the next song! Alternating Sublines It is possible to group items on each line into 2 or more groups or sublines. Each subline will be displayed in succession on the line for a specied time, alternating continuously through each dened subline. Items on a line are broken into sublines with the semicolon ; character. The display time for each subline defaults to 2 seconds unless modied by using the %t tag to specify an alternate time (in seconds and optional tenths of a second) for the subline to be displayed. Subline related special characters and tags: ; Split items on a line into separate sublines %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 dierent sublines. Example subline denition:
Example %s%t(4)%ia;%s%it;%t(3)%pc %pr : Display id3 artist for 4 seconds, Display id3 title for 2 seconds, Display current and remaining track time for 3 seconds, repeat.
Conditionals can be used with sublines to display a dierent set and/or number of sublines on the line depending on the evaluation of the conditional. Example subline with conditionals:
Example %?it<%t(8)%s%it|%s%fn>;%?ia<%t(3)%s%ia|%t(0)>
The format above will do two dierent things depending if ID3 tags are present. If the ID3 artist and title are present: Display id3 title for 8 seconds, Display id3 artist for 3 seconds, repeat. If the ID3 artist and title are not present: Display the lename continuously. Note that by using a subline display time of 0 in one branch of a conditional, a subline can be skipped (not displayed) when that condition is met. Using Images You can have as many as 52 images in your WPS. There are various ways of displaying images: 1. Load and always show the image, using the %x tag 2. Preload the image with %xl and show it with %xd. This way you can have your images displayed conditionally. 3. Load an image and show as backdrop using the %X tag. The image must be of the same exact dimensions as your display. Example on background image use:

12.3.3. The Manage Settings menu
The Manage Settings menu can be found in the Main Menu. The Manage Settings menu allows you to save and load.cfg les. Browse.cfg Files Opens the File Browser in the /.rockbox directory and displays all.cfg (conguration) les. Selecting a.cfg le will cause Rockbox to load the settings contained in that le. Pressing Left or Stop will exit back to the Manage Settings menu. See the Write.cfg files option on the Manage Settings menu for details of how to save and edit a conguration le. 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 o 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 le to your players disk. The conguration le 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 le. See Appendix section D (page 198) for the full reference of available options.
Save Sound Settings This option writes a.cfg le to your players disk. The conguration le has the.cfg extension and is used to store all of the sound related settings. Save Theme Settings This option writes a.cfg le to your players disk. The conguration le has the.cfg extension and is used to store all of the theme related settings.

12.4. Firmware Loading

12.4.1. Using ROLO (Rockbox Loader)
Rockbox is able to load and start another rmware le without rebooting. You just play a le with the extension.iriver. This can be used to test new rmware versions without deleting your current version.
12.5. Optimising battery runtime
Rockbox oers a lot of settings that have high impact on the battery runtime of your player. The largest power savings can be achieved through disabling unneeded hardware components for some of those there are settings available. Another area of savings is avoiding or reducing CPU boosting through disabling computing intense features (e.g. sound processing) or using eective audio codecs. The following provides a short overview of the most relevant settings and rules of thumb.

C HAPTER 2. I NSTALLATION

2 Installation

2.1 Overview
There are two ways of installing Rockbox: automated and manual. While the manual way is older, more tested and proven to work correctly, the automated installation is based on a nice graphical application that does almost everything for you. It is still important that you have an overview of the installation process to be able to select the correct installation options. There are two separate components of Rockbox that need to be installed in order to run Rockbox. The Rockbox bootloader. The bootloader is the program that tells your player how to load and start other components of Rockbox. This is the component of Rockbox that is installed to the ash memory of your Iriver. The Rockbox rmware. Unlike the Iriver rmware, which runs entirely from ash memory, most of the Rockbox code is contained in a build that resides on your players drive. This makes it easy to update Rockbox. The build consists of a directory called.rockbox which contains all of the Rockbox les, and is located in the root of your players 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. The view of Rockbox can be customized by themes. Depending on your taste you might want to install additional themes to change the look of Rockbox.

2.2 Prerequisites

Before installing Rockbox you should make sure you meet the prerequisites. You may need some additional tools for installation. In most cases these will already be available on your computer, but if not, installing some additional software might be necessary. 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. On Windows this means you need to gure out the drive letter associated with the player. On Linux you need to know the mount point of your player. For manual installation and customization additional software is required. ZIP utility. Rockbox is distributed as a compressed archive using the.zip format. Your computer will normally already have a means of handling such archive les. Windows XP has built-in support for.zip les and presents them to you as directories unless you have installed a third party program that handles compressed les. For other operating systems this may vary. If the.zip le format is not recognised on your computer you can nd a program to handle them at http://www.info-zip.org/ or http://sevenzip.sf.net/, both of which can be downloaded and used free of charge. Text editor. As you will see in the following chapters, Rockbox is highly congurable. In addition to saving congurations, Rockbox also allows you to create customised conguration les. If you would like to edit custom conguration les on your computer, you will need a text editor like Windows Wordpad.

2.3.3 Enabling Speech Support (optional)
If you wish to use speech support you will also need a voice le, English ones are available from http://www.rockbox.org/daily.shtml. Download the voice package for your player and unzip it directly to the root of your player. You should now nd an english.voice in the /.rockbox/langs directory on your player. Voice menus are enabled by default and will come into effect after a reboot. See section 7.9 (page 64) for details on voice settings.

2.4 Running Rockbox

Remove your player from the computers USB port. Unplug any connected power supply and turn the unit off. When you next turn the unit on, Rockbox should load. When you see the Rockbox splash screen, Rockbox is loaded and ready for use.

2.5 Updating Rockbox

Updating Rockbox is easy even if you do not use the Rockbox Utility. Download a Rockbox build. (The latest release of the Rockbox software will always be available from http://www.rockbox.org/download/). Unzip the build to the root directory of your player like you did in the installation stage. If your unzip program asks you whether to overwrite les, choose the Yes to all option. The new build will be installed over your current build. Note: If you use Rockbox Utility be aware that it cannot detect manually installed components.

2.6 Uninstalling Rockbox

Note: The Rockbox bootloader allows you to choose between Rockbox and the original
C HAPTER 2. I NSTALLATION rmware. (See section 3.1.3 (page 19) for more information.)
2.6.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. Note: Rockbox Utility cannot uninstall the bootloader due to the fact that it requires a ashing procedure. To uninstall the bootloader completely follow the manual uninstallation instructions below.
2.6.2 Manual Uninstallation
Note: If you want to remove the Rockbox bootloader, simply ash an unpatched Iriver rmware. Be aware that doing so will also remove the bootloader USB mode. As that mode can come in quite handy (especially when having disk errors) it is recommended to keep the bootloader. It also gives you the possibility of trying Rockbox anytime later by simply installing the distribution les. Although if you retain the Rockbox bootloader, you will need to hold the Rec button each time you want to start the original rmware. If you wish to clean up your disk, you may also wish to delete the.rockbox directory and its contents. Turn the Iriver off. Turn the player back on and the original Iriver software will load.

5.13 Quick Screen

Whilst not strictly part of the M AIN M ENU, it is worth noting that a few of the more commonly used settings are available from the Q UICK S CREEN. The Q UICK S CREEN screen is accessed with Long A-B and exited with A-B. It allows rapid access to the S HUFFLE and R EPEAT modes (section 7.1 (page 52)) and the S HOW F ILES option (section 7.3 (page 57)).
C HAPTER 6. S OUND S ETTINGS

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). All values lower than this reference will be negative and yield a progressively softer volume. The volume can be adjusted from a minimum of -84 dB to a maximum of 0 dB.

6.2 Bass

This setting emphasises the lower (bass) frequencies in the sound. A value of 0 dB means that bass sounds are unaltered (at response). The minimum setting is 0 dB and the maximum is 24 dB.

6.3 Treble

This setting emphasises the higher (treble) frequencies in the sound. A value of 0 dB means that treble sounds are unaltered (at response). The minimum setting is 0 dB and the maximum is 6 dB.

6.4 Balance

This setting controls the balance between the left and right channels. The default, 0, means that the left and right outputs are equal in volume. Negative numbers increase the volume of the left channel relative to the right, positive numbers increase the volume of the right channel relative to the left.

6.5 Channels

A stereo audio signal consists of two channels, left and right. The C HANNELS setting determines if these channels are to be combined in any way, and if so, in what manner they will be combined. Available options are: Setting Stereo Mono Custom Mono Left Mono Right Karaoke Description Leave the audio signal unmodied. Combine both channels and send the resulting signal to both stereo channels, resulting in a monophonic output. Allows you to manually specify a stereo width with the S TEREO W IDTH setting described later in this chapter. Plays the left channel in both stereo channels. Plays the right channel in both stereo channels. Removes all sound that is common to both channels. Since most music is recorded with vocals being equally present in both channels to make the singer sound centrally placed, this often (but not always) has the effect of removing the voice track from a song. This setting also very often has other undesirable effects on the sound.

Pre-cut: If too much gain is added through the graphical EQ, your music may distort. The P RECUT setting allows you to adjust the overall gain of the EQ. If your music distorts when using the EQ, trying changing this setting to a negative value. Simple EQ: This option provides an easier alternative for those who are daunted by all of the parameters that can be adjusted using the graphical EQ. With the S IMPLE EQ, the only parameter that can be adjusted is the gain. Advanced EQ: This sub menu provides options for adjusting the same parameters as the G RAPHICAL EQ. The only difference is that the parameters are adjusted through textual menus rather than through a graphic interface. Save EQ Preset: This option saves the current EQ conguration in a.cfg le. Browse EQ Presets: This menu displays a list of EQ presets, as well as any EQ congurations saved using the S AVE EQ P RESET option. Users unfamiliar with the operation of a parametric EQ may wish to use the presets instead of trying to congure the EQ, or use the presets for designing their own custom EQ settings.

6.9 Dithering

This setting controls the dithering and noise shaping functionality of Rockbox. Most of Rockbox audio le decoders work at a higher bit depth than the 16 bits used for output on the players audio connectors. The simplest way to convert from one bit depth to another is simply discarding all the surplus bits. This is the default behaviour, and adds distortion to the signal that will vary in character along with the desired sound. Dithering adds low-level noise to the signal prior to throwing away the surplus bits, which gives the resulting signal a uniform noise oor which is independent of the signal. Most people nd 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. In Rockbox case, some of the noise is pushed up to above 10 kHz. This setting will be put to its best use when listening to dynamic music with frequently occuring quiet parts, classical music being a typical example. It is worth noting that the effects of dithering and noise shaping are very subtle, and not easily noticable. Rockbox uses highpass triangular distribution noise as the dithering noise source, and a third order noise shaper.

set to L OGARITHMIC (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 L INEAR display. This setting cannot be displayed in units like volts or watts because such units depend on your headphones. Minimum and maximum range: These two options dene the full value range that the peak meter displays. Recommended values for the L OGARITHMIC (dB) setting are -40 dB for minimum and 0 dB for maximum. Recommended values for L INEAR display are 0 and 100%. Note that -40 dB is approximately 1% in linear value, but if you change the minimum setting in linear mode slightly and then change to the dB scale, there will be a large change. You can use these values for zooming into the peak meter. Default Codepage: A codepage describes the way extended characters that are not available within the ASCII character set are encoded. ID3v1 tags do not have a codepage encoding contained so Rockbox needs to know what encoding has been used when generating these tags. This should be ISO-8859-1 but to support languages outside Western Europe most applications use the setting of your operating system instead. If your operating system uses a different codepage and you are getting garbled extended characters you should adjust this settings. In most cases sticking to ISO-8859-1 would be sufcient.

7.6 System

7.6.1 Start Screen
Set the screen that Rockbox will start in. Selecting R ESUME P LAYBACK will resume playback where it was when the player was shut off if there is a playlist to resume and will then end up in the WPS. Selecting P REVIOUS S CREEN will make Rockbox start in the screen it was when the player was shut off.

7.6.2 Battery

Options relating to the battery in the player. Battery Capacity: This setting can be used to tell Rockbox what capacity (in mAh) the battery being used has. The default is 1300mAh, which is the capacity value for the standard battery shipped with the player. Rockbox uses this value to estimate remaining battery life for the info screen and WPS. Changing this setting has no effect whatsoever on actual battery life. This setting only affects the accuracy of the battery life estimation as shown on screen. Charge During USB Connection: This option lets you control whether the player should charge during the USB connection and hence draw the full 500mA. Turn-
ing it O FF is recommended if the dap is connected through an unpowered USB hub or a laptop port.

7.6.3 Disk

Options relating to the hard disk. 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 F ILE B ROWSER. When the hard disk spins up to ll the audio buffer, it automatically spins down afterwards. Directory Cache: Rockbox has the ability to cache the contents of your drive in RAM. The D IRECTORY C ACHE takes a small amount of memory away from Rockbox that would otherwise be used to buffer music, but it speeds up navigation in the le 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. Note: The rst time you enable the directory cache, Rockbox will request a reboot of the player and upon restarting take a few minutes to scan the drive. After this, the directory cache will work in the background.

7.6.4 Time and Date

Time related menu options. Set Time/Date: Set current time and date. Time Format: Choose 12 or 24 hour clock.

7.6.5 Idle Poweroff

Rockbox can be congured to turn off power after the unit has been idle for a dened number of minutes. The player is idle when playback is stopped or paused. It is not idle while the USB or charger is connected , or while recording. Settings are either O FF or 1 to 10 minutes in 1 minute steps. Then 15,30,45 and 60 minutes are available.

7.6.6 Limits

This sub menu relates to limits in the Rockbox operating system. Max Entries in File Browser: This setting controls the limit on the number of les that you can put in any particular directory in the le browser. You can congure the size to be between 50 and 10,000 les in steps of 50. The default is 400. Higher
values will shorten the music buffer, so you should increase this setting only if you have directories with a large number of les. Max Playlist Size: This setting controls the maximum size of a playlist. The playlist size can be between 1,000 and 32,000 les, in steps of 1,000 (default is 10,000). Higher values will shorten the music buffer, so you should increase this setting only if you have very large playlists.

7.8 Language

This setting controls the language of the Rockbox user interface. Selecting a language will activate it. The language les must be in the /.rockbox/langs/ directory. See section 11.1.3 (page 131) for further details about languages.

7.9 Voice

Voice Menus. This option controls the voicing of menus/settings as they are selected by the cursor. In order for this to work, a voice le must be present in the /.rockbox/langs/ directory on the player. Voice les are large and are not shipped with Rockbox by default. The voice le is the name of the language for which it is made, followed
by the extension.voice. So for English, the le name would be english.voice. This option is on by default, but will do nothing unless the appropriate voice le is installed in the correct place on the player. The Voice Menus have several limitations: Setting the Sound Option C HANNELS to K ARAOKE may disable voice menus. Plugins and the wake up alarm do not support voice features. Voice Directories. This option controls voicing of directory names. A voice le 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 le list. They are then announced as Directory 1, Directory 2 etc. Off. No attempt will be made to speak directory names. You can use pre-generated.talk clips to have directory names spoken properly, but you must enable this explicitly (see below). Use Directory.talk Clips. This option turns on the use of.talk clips for directories. On. Use special pre-recorded MP3 les ( dirname.talk) in each directory. These must be generated in advance, and are typically produced synthetically using a text-to-speech engine on a PC. Off. No checking is made for directory.talk clips; they are not used even if present. This can reduce disk activity. Use of a.talk clip takes precedence over other directory name voicing. Otherwise (e.g. if a.talk clip is not available), voicing uses the method set under V OICE D IRECTORIES above. Voice Filenames. This option controls voicing of lenames. Again, a voice le must be present for this to work. The options provided are S PELL, N UMBERS, and O FF which function the same as for V OICE D IRECTORIES. You can use pre-generated.talk clips to have lenames spoken properly, but you must enable this explicitly (see below). Use File.talk Clips. This option turns on the use of.talk clips for les. On. Use special pre-recorded MP3 les for each le. This functions the same as for directories except that the.talk clip le must have the same name as the described le with an extra.talk extension (e.g. Punkadiddle.mp3 would require a le called Punkadiddle.mp3.talk). Off. No checking is made for le.talk clips; they are not used even if present. This can reduce disk activity. Use of a.talk clip takes precedence over other lename voicing. Otherwise (e.g. if a.talk clip is not available), voicing uses the method set under V OICE F ILENAMES above.

9.11 Automatic Gain Control
The A UTOMATIC G AIN C ONTROL has ve different presets for automatically controlling the gain while recording. Safety (clip): This preset will lower the gain when the levels get too high (-1dB) and will never increase gain. Live (slow): This preset is designed to be used for recording of live shows and has quite large headroom for loud parts. It heads for a nominal target peak level of -9dB and will slowly increase or decrease gain to reach it.
DJ-Set (slow): This preset heads for a nominal target peak level of -5dB and will slowly increase or decrease gain to reach it. Medium: This preset heads for a nominal target peak level of -6dB and will increase or decrease gain to reach it. Voice (fast): This preset is designed to be used for voice recording and heads for a nominal target peak level of -7dB and will quickly increase or decrease gain to reach it.

9.12 AGC clip time

This setting controls how long the level is too loud or soft before the A UTOMATIC G AIN C ONTROL kicks in.

C HAPTER 10. P LUGINS

10 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 le extension.rock. Most of them can be started from B ROWSE P LUGINS in the M AIN M ENU. Viewer plugins get started automatically by opening an associated le (i.e. text les, chip8 games), or from the O PEN WITH option on the C ONTEXT M ENU.

10.1 Games

See also the Chip-8 emulator in section 10.3.2 (page 110) and Rockboy in section 10.3.7 (page 114).

10.1.1 Blackjack

Figure 10.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 difcult, blackjack is a game renowned for the strategy involved. This version includes the ability to split, buy insurance, and double down.
C HAPTER 10. P LUGINS For the full set of rules to the game, and other facinating information visit http://www.blackjackinfo.com/blackjack-rules.php Key Play A-B Navi Stop Left / Right / Up / Down Play Rec Navi A-B Stop Action In menu Start new game Resume saved game Show high scores Quit In game Enter betting amount Hit (Draw new card) Stay (End hand) Double down Save game Return to menu or cancel

10.1.12 Pacbox

Figure 10.10: Pacbox
Pacbox is an emulator of the Pacman arcade machine hardware. It is a port of PIE Pacman Instructional Emulator (http://www.ascotti.org/programming/pie/pie.htm). ROMs To use the emulator to play Pacman, you need a copy of ROMs for Midway Pacman. Filename pacman.5e pacman.5f pacman.6e pacman.6f pacman.6h pacman.6j MD5 checksum 2791455babaf26e0b396c78d2b45f8f6 9240f35d1d2beee0ff17195653b5e405 290aa5eae9e2f63587b5dd5a7da932da 19a886fcd8b5e88b0ed1b97f9d8659c0 d7cce8bffd9563b133ec17ebbb6373d4 33c0e197be4c787142af6c3be0d8f6b0
These need to be stored in the /.rockbox/pacman/ directory on your player. In the MAME ROMs collection the necessary les can be found in pacman.zip and puckman.zip. The MAME project itself can be found at http://www.mame.net.
C HAPTER 10. P LUGINS Keys Key Right Left Up Down Rec Navi Play A-B Action Move Up Move Down Move Left Move Right Insert Coin 1-Player Start 2-Player Start Menu

10.1.13 Pegbox

Figure 10.11: pegbox
To beat each level, you must destroy all of the pegs. If two like pegs are pushed into each other they disappear except for triangles which form a solid block and crosses which allow you to choose a replacement block.
C HAPTER 10. P LUGINS Key Up, Down, Left, Right Navi Play A-B Rec Stop Action In game to move around to select/save to restart level to go up a level to go down a level to quit

10.1.14 Pong

Figure 10.12: Pong
Pong is a simple two player tennis game. Whenever a player misses the ball the other scores. Key Up Down Play A-B Stop Action Left player up Left player down Right player up Right player down Quit

10.1.15 Robotndskitten

Figure 10.13: Robotndskitten
In this game, you are robot (#). Your job is to nd 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 robotndskitten. Key Up, Down, Left, Right Stop Action Move robot Quit

10.1.16 Rockblox

Figure 10.14: Rockblox
Rockblox is a rockbox version of the classic falling blocks game. The aim of the game is to make the falling blocks of different shapes form full rows. Whenever a row is complete it will be cleared and the game score will increase. For every ten lines completed the game level increases, making the blocks fall faster. If the pile of blocks reach the ceiling the game is over. Key Play Left Right Down Navi Up A-B Hold switch Stop Action Restart game Move left Move right Move down Rotate left Rotate right Drop Pause Quit

%bv %bt %bp %bc %bs

B.4 File Info
Tag %fb %fc Description File Bitrate (in kbps) File Codec (e.g. MP3 or FLAC). This tag can also be used in a conditional tag, %?fc<mp1|mp2|mp3|aiff|wav|vorbis|flac|mpc|a52|wavpack|alac|aac|shn|sid|adx|unknown>. The codec order is as follows: MP1, MP2, MP3, AIFF, WAV,Ogg Vorbis (OGG), FLAC, MPC, AC3, WavPack (WV), ALAC, AAC,Shorten (SHN), SID, ADX, NSF, Speex, SPC, APE. File Frequency (in Hz) File Name File Name (without extension) File Path File Size (In Kilobytes) (avg) if variable bit rate or if constant bit rate First directory from end of le path. Second directory from end of le path. Third directory from end of le path.
%ff %fm %fn %fp %fs %fv %d1 %d2 %d3
Example for the %dN commands: If the path is /Rock/Kent/Isola/11 - 747.mp3, %d1 is Isola, %d2 is Kent. You get the picture.

B.5 Playlist/Song Info

Tag %pb Description Progress Bar This will replace the entire line with a progress bar. You can set the height, position and width of the progressbar (in pixels): %pb|height|leftpos|rightpos|toppos| Percentage Played In Song Current Time In Song Total Number of Playlist Entries Peak Meter. The entire line is used as volume peak meter. Playlist Name (Without path or extension) Playlist Position Remaining Time In Song Shufe. Shows s if shufe mode is enabled. Total Track Time Current volume (x dB). Can also be used in a conditional: %?pv<0|1|2|.|N>
%px %pc %pe %pm %pn %pp %pr %ps %pt %pv

B.6 Runtime Database

Tag %rp %rr Description Song playcount Song rating (0-10). This tag can also be used in a conditional tag, %?rr<0|1|2|3|4|5|6|7|8|9|10>

B.7 Sound (DSP) settings

Tag %Sp %xf %rg Description Display current playback pitch Crossfade setting, in the order: Off, Shufe, Skip, Always ReplayGain value in use (x.y dB). If used as a conditional, Replaygain type in use: %?rg<Off|Track|Album|TrackShuffle|AlbumShuffle|No tag>

B.8 Hold Switches

Tag %mh %mr Description h if the main unit hold switch is on r if the remote hold switch is on

B.9 Virtual LED

Tag %lh Description h if the hard disk is accessed

B.10 Repeat Mode

Tag %mm Description Repeat mode, 0-4, in the order: Off, All, One, Shufe
Example: %?mm<Off|All|One|Shuffle|A-B>

B.11 Playback Mode Tags

Tag %mp Description Play status, 0-4, in the order: Stop, Play, Pause, Fast forward, Rewind
Example: %?mp<Stop|Play|Pause|Ffwd|Rew>

B.12 Images

N/A N/A N/A N/A 0: small size, 7: high quality 48, 44, 32, 24, 22, 16 kHz mic, line, spdif N/A mono, stereo N/A 0 to 15 N/A 0 to 15 N/A 0 to 15 N/A off,on N/A off, 0:05, 0:10, 0:15, 0:30, 1:00, 2:00, h:mm 4:00, 6:00, 8:00, 16:00, 24:00 off, 1 to 30 seconds /path/to/dir N/A off, on N/A
A PPENDIX D. U SER FEEDBACK

D User feedback

D.1 Bug reports
If you experience inappropriate performance from any supported feature, please le a bug report on our web page. Do not report missing features as bugs, instead le them as feature ideas (see below). For open bug reports refer to http://www.rockbox.org/tracker/index.php?type=2
D.1.1 Rules for submitting new bug reports
1. Check that the bug has not already been reported 2. Always include the following information in your bug report: Which exact player you have. Which exact Rockbox version you are using (Menu->Info -> Version) A step-by-step description of what you did and what happened Whether the problem is repeatable or a one-time occurrence All relevant data regarding the problem, such as playlists, MP3 les etc. (IMPORTANT!)

D.2 Feature ideas

To suggest an idea for a feature or to read those made by others, see http://forums. rockbox.org/index.php?board=49.0. Please keep in mind that this forum is for the discussion of feature ideas - they are not requests and there is no guarantee they will be acted upon.
D.2.1 Rules for submitting a new feature idea
1. Check that the feature has not already been suggested. Duplicates are really boring! 2. Check that the feature has not already been implemented. Download the latest current/daily build and/or search the mail list archive. 3. Check that the feature is possible to implement (see section D.2.2 (page 153)).
D.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! Support other le systems than FAT32 (like NTFS or ext2 or whatever)! No. support for more le systems will just take away valuable ram for unnecessary features. You can partition your player ne, just make sure the rst one is FAT32 and then make the other ones whatever le system you want. Just do not expect Rockbox to understand them. Add scandisk-like features! It would be a very slow operation that would drain the batteries and take a lot of useful ram for something that is much better and faster done when connected to a host computer.

A PPENDIX E. C HANGELOG

E Changelog
E.1 What is new since v2.5?

E.1.1 New features

2008-07-07: 2008-05-04: 2008-04-23: 2008-03-23: 2008-03-21: 2008-03-18: 2007-12-09: 2007-11-26: 2007-11-11: 2007-09-06: 2007-09-04: 2007-08-06: 2007-08-03: 2007-08-02: 2007-07-27: 2007-07-25: 2007-06-30: 2007-06-29: 2007-06-28: 2007-06-17: 2007-05-23: 2007-04-09: 2007-03-11: 2007-03-04: 2007-03-01: 2007-02-16: 2007-02-14: 2007-02-14: 2007-02-10: 2007-02-09: 2007-01-31: 2007-01-16: 2007-01-02: Added keybox plugin Added study mode Lamp (originally ashlight) plugin New bitmap strips feature in the WPS Viewport tag added for WPS The Olympus m:robe 100 is now a supported target PictureFlow: A nice animated visualization for album art Matrix Demo Rockbox can now display album art Sound on Sansa c200 The SanDisk Sansa e200R models are now Rockboxed! Make several splashes and conrmation screens speak iPod 3rd gen is now ofcially a supported target Superdom game Sound on iPod 2nd Gen Jackpot support for bitmap targets Reversi game Rocklife plugin Maze game Custom letype colour feature introduced The 80GB Ipod Video is now supported by Rockbox WAV le viewer Sound on the Sansa e200 Rockbox runs and plays music on the iAudio M5 Add the Rockbox Menu Chopper game Cuesheet support Icons in the menus Album Artist and Comment Tag Support Speex Codec Support Invadrox, a Space Invaders clone BlackJack plugin Mazezam, a puzzle game for all bitmap lcd targets

is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specic 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 denition. The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.

2. VERBATIM COPYING

You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3. You may also lend copies, under the same conditions stated above, and you may publicly display copies.

3. COPYING IN QUANTITY

If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Documents license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects. If the required texts for either cover are too voluminous to t legibly, you should put the rst ones listed (as many as t reasonably) on the actual cover, and continue the rest onto adjacent pages. If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you

GNU G ENERAL P UBLIC L ICENSE T ERMS AND C ONDITIONS F OR C OPYING , D ISTRIBUTION AND M ODIFICATION
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. The Program, below, refers to any such program or work, and a work based on the Program means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modications and/or translated into another language. (Hereinafter, translation is included without limitation in the term modication.) Each licensee is addressed as you. Activities other than copying, distribution and modication are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Programs source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modied les to carry prominent notices stating that you changed the les and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modied program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License.