10.4.18.Text Editor. 162 11.Advanced Topics 11.1. Customising the User Interface. 11.1.1. Getting Extras. 11.1.2. Loading Fonts. 11.1.3. Loading Languages. 11.1.4. Changing Filetype Colours. 11.1.5. Loading Backdrops. 11.1.6. UI Viewport. 11.2. Conguring the Theme. 11.2.1. Themeing General Info. 11.2.2. Themes Create Your Own. 11.2.3. Info Viewport (SBS only). 11.2.4. Additional Fonts. 11.3. Managing Rockbox Settings. 11.3.1. Introduction to.cfg Files. 11.3.2. Specications for.cfg Files. 11.3.3. The Manage Settings menu. 11.4. Firmware Loading. 11.4.1. Using ROLO (Rockbox Loader). 11.5. Optimising battery runtime. 11.5.1. Display backlight. 11.5.2. Replaygain. 11.5.3. Audio format and bitrate. 11.5.4. Sound settings. 174 174
A. File formats 175 A.1. Supported le formats. 176 B. Audio and metadata formats B.1. Supported audio formats. B.1.1. Lossy Codecs. B.1.2. Lossless Codecs. B.1.3. Other Codecs. B.1.4. Codec featureset. B.2. Supported metadata tags. B.2.1. Featureset for generic metadata tags. B.2.2. Featureset for codec specic metadata B.2.3. Limitations of metadata handling. 177. 177. 177. 178. 178. 179. 179. 180. 181. 181
C. Theme Tags 182 C.1. Status Bar. 182 C.2. Hardware Capabilities. 182
Contents C.3. Information from the track tags. C.4. Viewports. C.5. Additional Fonts. C.6. Power Related Information. C.7. Information about the le. C.8. Playlist/Song Info. C.9. Playlist Viewer. C.10.Runtime Database. C.11.Sound (DSP) settings. C.12.Hold. C.13.Virtual LED. C.14.Repeat Mode. C.15.Playback Mode. C.16.Current Screen. C.17.List Title (.sbs only). C.18.Changing Volume. C.19.Settings. C.20.Images. C.21.Album Art. C.21.1. Limitations. C.21.2. Where to put album art. C.21.3. How to display the album art C.22.FM Radio. C.23.Alignment and language direction. C.24.Conditional Tags. C.25.Subline Tags. C.26.Time and Date. C.27.Text Translation. C.28.Touchscreen Areas. C.29.Last Touchscreen Press. C.30.Bar Tags. C.30.1. Options. C.31.Other Tags. D. Cong le options E. Menu Overview F. User feedback F.1. Bug reports. F.1.1. Rules for submitting new bug reports. F.2. Feature ideas. F.2.1. Rules for submitting a new feature idea F.2.2. Features we will not implement..
204. 204. 204. 204. 204. 205

Contents G. Credits

10 206
H. Licenses 210 H.1. GNU Free Documentation License. 210 H.2. The GNU General Public License. 218

Chapter 1. Introduction

1. Introduction

1.1. Welcome

This is the manual for Rockbox. Rockbox is an open source rmware replacement for a growing number of digital audio players. Rockbox aims to be considerably more functional and ecient than your devices stock rmware while remaining easy to use and customisable. Rockbox is written by users, for users. Not only is it free to use, it is also released under the GNU General Public License (GPL), which means that it will always remain free both to use and to change. Rockbox has been in development since 2001, and receives new features, tweaks and xes each day to provide you with the best possible experience on your digital audio player. A major goal of Rockbox is to be simple and easy to use, yet remain very customisable and congurable. We believe that you should never need to go through a series of menus for an action you perform frequently. We also believe that you should be able to congure almost anything about Rockbox you could want, pertaining to functionality. Another top priority of Rockbox is audio playback quality Rockbox, for most models, includes a wider range of sound settings than the devices original rmware. A lot of work has been put into making Rockbox sound the best it can, and improvements are constantly being made. All models have access to a large number of plugins, including many games, applications, and graphical demos. You can load dierent congurations quickly for dierent purposes (e.g. a large font for in your car, dierent sound settings for at home). Rockbox features a very wide range of languages, and all supported models also have the ability to talk to you menus can be voiced and lenames spelled out or spoken.

1.2. Getting more help

This manual is intended to be a comprehensive introduction to the Rockbox rmware. There is, however, more help available. The Rockbox website at http://www.rockbox.org/ contains very extensive documentation and guides written by members of the Rockbox community and this should be your rst port of call when looking for further help. If you cannot nd the information you are searching for on the Rockbox website there are a number of support channels you should have a look at. You can try the Rockbox forums located at http://forums.rockbox.org/. The mailing lists are another option, and can be found at http://www.rockbox.org/mail/. From that page you can subscribe to the lists and browse the archives. To search the list archives simply use the search eld that is located on the left side of the website. Furthermore, you can ask on IRC. The
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 (dont ask to ask!) if someone knows the answer youll 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. If you think you have found a bug please make sure it actually is a bug and is still present in the most recent version of Rockbox. You should try to conrm that by using the above mentioned support channels rst. After that you can submit that issue to our tracker. Refer to section F (page 204) for details on how to use the tracker.
1.3. Naming conventions and marks
We have some conventions (especially for naming) that are intended to be consistent throughout this manual. Manufacturer and product names are formatted in accordance with the standard rules of English grammar, e.g. Cowon playback is currently unsupported. Manufacturer and model names are proper nouns, and thus are written beginning with a capital letter. This manual has some parts that are marked with icons on the margin to help you nding important parts or parts you could skip. The following icons are used: Note: This indicates a note. A note starts always with the text Note. In order to make nding notes easier each one is accompanied by an icon in the margin as here. Notes are used to mark useful information that may help you to get the most out of Rockbox. Warning: This is a warning. In contrast to notes mentioned above, a warning should be taken more seriously. Whereas ignoring notes will not cause any serious damage, ignoring warnings could cause serious damage to your player. You really should read the warnings, especially if you are new to Rockbox. This icon marks a section that is intended especially for the blind and visually impaired. As they cannot read the manual in the same way sighted people do we have added some additional descriptions. If you are not blind or visually impaired you can probably completely skip these blocks. To make this easier, there is an icon shown in the margin on the right. Links to the wiki are abbreviated by the name of the wiki page. Those names are still linked so you can simply follow them like any other link in this manual. If you want to access a wiki page manually go to Z http://www.rockbox.org/wiki/ and type the page name in the Go box at the top of the page. Links to wiki pages are also indicated by the symbol Z in front of the page name.

of one channel into the other. This has the eect of gradually centering the stereo image, until you have monophonic sound at 0%. Values above 100% will progressively remove components in one channel that is also present in the other. This has the eect of widening the stereo eld. A value of 100% will leave the stereo eld unaltered.

6.7. Crossfeed

Crossfeed attempts to make the experience of listening to music on headphones more similar to listening to music with stereo speakers. When you listen to music through speakers, each ear will hear sound originating from both speakers. However, the sound from the left speaker reaches your right ear slightly later than it does your left ear, and vice versa. The human ear and brain together are very good at interpreting the time dierences between direct sounds and reected sounds and using that information to identify the direction that the sound is coming from. On the other hand, when listening to headphones, each ear hears only the stereo channel corresponding to it. The left ear hears only the left channel and the right ear hears only the right channel. The result is that sound from headphones does not provide the same spatial cues to your ear and brain as speakers, and might for that reason sound unnatural to some listeners. The crossfeed function uses an algorithm to feed a delayed and ltered portion of the signal from the right channel into the left channel and vice versa in order to simulate the spatial cues that the ear and brain receive when listening to a set of loudspeakers placed in front of the listener. The result is a more natural stereo image that can be especially appreciated in older rock and jazz records, where one instrument is often hard-panned to just one of the speakers. Many people will nd such records tiring to listen to using earphones and no crossfeed eect. Crossfeed has the following settings: Crossfeed. Selects whether the crossfeed eect is to be enabled or not. Direct Gain. How much the level of the audio that travels the direct path from a speaker to the corresponding ear is supposed to be decreased. Cross Gain. How much the level of the audio that travels the cross path from a speaker to the opposite ear is to be decreased. High-Frequency Attenuation. How much the upper frequencies of the cross path audio will be dampened. Note that the total level of the higher frequencies will be a combination of both this setting and the Cross Gain setting. High-Frequency Cuto. Decides at which frequency the cross path audio will start to be cut by the amount described by the High-Frequency Attenuation setting.

Chapter 9. Theme Settings Status Bar. Allows you to choose where to display the statusbar.
Volume Display. Controls whether the volume is displayed as a graphic or a numeric value on the Status Bar. If you select a numeric display, volume is displayed in decibels. See section 6.1 (page 48) for more on the volume setting. Battery Display. Controls whether the battery charge status is displayed as a graphic or numerical percentage value on the Status Bar. Line Selector Type. 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. Bar (Solid Colour). A bar with a solid colour, the colour is set in the Colours submenu. Bar (Gradient Colour). A bar with a colour gradient, the colours are set in the Colours submenu. Colours. The options in this menu sets the colours for visual elements in Rockbox. Line Selector Colours. These options sets the colours for the line selector bars. Primary Colour. Set the primary colour used for the gradient line selector bar and the colour used for the solid color line selector bar. Secondary Colour. Set the secondary colour used for the gradient line selector bar. Text Colour. Set the colour of the selected text when using the solid colour or the gradient colour line selection bars. Background Colour. Sets the background colour for the display. Foreground Colour. Sets the colour used for text and icons. Reset Colours. Resets the LCD display to Rockboxs default colours.

Chapter 10. Plugins

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 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.

10.1. Games

See also the Chip-8 emulator in section 10.3.2 (page 126) and Rockboy in section 10.3.9 (page 133).

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 dicult, blackjack is a game renowned for the strategy involved. This version includes the ability to split, buy insurance, and double down. For the full set of rules to the game, and other facinating information visit http://www.blackjackinfo.com/blackjack-rules.php

Key Middle-Right / Middle-Left Top-Right Bottom-Left Minus Power
Action Enter betting amount Hit (Draw new card) / Select Stay (End hand) Double down Pause game and go to menu / Cancel

10.1.2. BrickMania

Figure 10.2.: BrickMania
BrickMania is a clone of the classic game Breakout. The aim of the game is to destroy all the bricks by hitting them with the ball once or more. Sometimes a special item falls down when you destroy a brick. For a special item to take eect, you must catch it with the paddle. Look out for the bad ones.
Chapter 10. Plugins Special items Displayed N D L F G B FL Name Normal Die Life Fire Glue Ball Flip Description 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 res another ball. Flip left / right movement.
Key Minus or Bottom-Left / Plus or Bottom-Right Menu or Centre Power

Action Moves the paddle

Release the ball / Fire Open menu / Quit

10.1.3. Bubbles

Figure 10.3.: Bubbles
The goal of the game is to beat each level as quickly as possible by clearing the board of all bubbles. Bubbles are removed from the board when a cluster of three of more of the same type is formed. The game is over when any bubbles on the board extend below the bottom line. To make things more dicult, the entire board is shifted down every time a certain number of shots have been red. Points are awarded depending on how quickly the level was completed.
Key Top-Middle Middle-Left / Middle-Right Minus or Centre Power or Bottom-Right
Action Pause game Aim the bubble Fire bubble Exit to menu

10.1.4. Chessbox

Figure 10.4.: Chessbox
Chessbox is a one-person chess game with computer articial intelligence. The chess engine is a port of GNU Chess 2 by John Stanback. It also works as a PGN le viewer. Instead of executing the game from the plugin menu, look for any le with.pgn extension in the le browser and execute it. Chessbox will show the list of matches included in the le and allow you to select the one you want to watch. After that, you can scroll back and forth through the moves of the game. If

Force Play Mode. The same as Play Mode except that this mode will allow you to play illegal moves such as retaking a ko immediately without a ko threat, suicide on rulesets which dont allow it (including single stone suicide), and playing a move where there is already a stone. 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. To remove a label, click on it until it cycles through the allowed letters and disappears. Add/Edit Comment. Add or edit a comment at the current node. Done. Go back to the previous screen.

10.1.12. Invadrox

Figure 10.11.: Invadrox
Invadrox is a clone of the classic arcade game Space Invaders. Kill those pesky aliens before they get to you. Remember, they increase speed, drop down and reverse direction after every pass!
Chapter 10. Plugins Key Middle-Left, Bottom-Left or Minus Middle-Right, Bottom-Right or Plus Bottom-Middle, Centre or Menu Top-Left or Power Action Move left

Move right

Fire Quit

10.1.13. Jackpot

Figure 10.12.: Jackpot
This is a jackpot slot machine game. At the beginning of the game you have 20$. Payouts are given when three matching symbols come up.
Key Minus or Centre Power or Bottom-Right
Action Play Exit the game

10.1.14. Jewels

Figure 10.13.: Jewels
Jewels is a simple yet addicting game which involves swapping pairs of jewels in order to form connected segments of three or more of the same type. The goal of the game is to score as many points as possible before running out of available moves. Higher points are awarded to larger combos. The game advances to the next level after every one hundred points and randomly clears several jewels. In puzzle mode the aim of the game is to connect the puzzles, by skilful swapping pairs of jewels.
Key MiddleLeft/MiddleRight/TopMiddle/BottomMiddle Centre Power
Action Move the cursor around the jewels

Select a jewel Menu

10.1.15. MazezaM

Figure 10.14.: MazezaM

The goal of this puzzle game is to escape a dungeon consisting of ten mazezams. These are rooms containing rows of blocks which can be shifted left or right. You can move the rows only by pushing them and if you move the rows carelessly, you will get stuck. You can have another go by selecting retry level from the menu, but this will cost you a life. You start the game with three lives. Luckily, there are checkpoints at levels four and eight.

10.1.25. Sliding Puzzle

Figure 10.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 190)). 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 Middle-Left / Middle-Right / Top-Middle / Bottom-Middle Bottom-Left Centre

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

10.1.26. Snake

Figure 10.22.: Snake
This is the popular snake game. The aim is to grow your snake as large as possible by eating the dots that appear on the screen. The game will end when the snake touches either the borders of the screen or itself. Key TopMiddle/BottomMiddle Centre Action Change levels (1 is slowest, 9 is fastest)

Toggle Play/Pause

10.1.27. Snake 2
Figure 10.23.: Snake 2 The Snake Strikes Back
Another version of the Snake game. Move the snake around, and eat the apples that pop up on the screen. Each time an apple is eaten, the snake gets longer. The game ends when the snake hits a wall, or runs into itself.
Key Top-Middle / Bottom-Middle Middle-Right / Middle-Left Centre Top-Middle / Bottom-Middle/ Middle-Left / Middle-Right Centre Power
Action In menu Set game speed Select starting maze Select game type (A or B) Start the game In game 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.

10.1.28. Sokoban

Figure 10.24.: Sokoban
The object of the game is to push boxes into their correct position in a crowded warehouse with a minimal number of pushes and moves. The boxes can only be pushed, never pulled, and only one can be pushed at a time. Sokoban may be used as a viewer for viewing saved solutions and playing external level sets with the.sok extension. Level sets should be in the standard Sokoban text format or RLE (Run Length Encoded). For more information about the level format, see http://sokobano.de/wiki/index.php?title=Level_format

Chapter 10. Plugins Key Top-Middle, Bottom-Middle, Middle-Left, Middle-Right Menu Minus Top-Right Plus Top-Right Bottom-Left Centre TopMiddle/BottomMiddle MiddleLeft/MiddleRight Menu Action In game Move the sokoban up, down, left, or right
Menu Back to previous level 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)
Some places where can you can nd level sets: http://www.sourcecode.se/sokoban/levels.php http://sokobano.de/en/levels.php Note that some level sets may contain levels that are too large for this version of Sokoban and are unplayable as a result.

10.1.29. Solitaire

Figure 10.25.: Klondike solitaire
This is the classic Klondike solitaire game for Rockbox. This is probably the best-known solitaire in the world. Many people do not even realize that other games exist. Though the name may not be familiar, the game itself certainly is. This is due in no small part to Microsofts inclusion of the the game in every version of Windows. Though popular, the odds of winning are rather low, perhaps one in thirty hands. For the full set of rules to the game, and other interesting information visit http: //www.solitairecentral.com/rules/klondike.html
Key Top-Middle / Bottom-Middle / Middle-Left / Middle-Right Centre Top-Left Top-Right Bottom-Left Bottom-Right Power
Action Move Cursor around.
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 nal colour stacks. Put the card on top of the remains stack on one of the nal colour stacks. Show menu

10.1.30. Spacerocks

Figure 10.26.: Spacerocks
Spacerocks is a clone of the old arcade game Asteroids. The goal of the game is to blow up the asteroids and avoid being hit by them. Once in a while, a UFO will appear shoot this for extra points.
Key Bottom-Middle Top-Middle Middle-Left/ Middle-Right Top-Right Centre Power
Action Shoot Thrust Turn left/right Teleport Pause game Quit

10.1.31. Star

Figure 10.27.: 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 os to go to the next level. You can switch control between the lled circle, which can take os, and the lled square, which is used as a mobile wall to allow your lled circle to get to places on the screen it could not otherwise reach. The block cannot take os. Key Middle-Left Middle-Right Top-Middle Bottom-Middle Centre Bottom-Left Bottom-Right Top-Left Power Action Move Left Move Right Move Up Move Down Switch between circle and square Previous level Reset level Next level Exit the game

10.2.7. Logo

Demo showing the Rockbox logo bouncing around the screen. Key Middle-Right / Middle-Left Bottom-Middle / Top-Middle Power Action Increase / decrease speed on the x-axis Increase / decrease speed on the y-axis Quit

10.2.8. Mosaique

Figure 10.36.: Mosaique
This simple graphics demo draws a mosaic picture on the screen of the player. Press Power to quit.

10.2.9. Oscilloscope

Figure 10.37.: Oscilloscope
This demo shows the shape of the sound samples that make up the music being played. At faster speed rates, the player is less responsive to user input and music may start to skip.
Chapter 10. Plugins Keys Key Top-Middle Bottom-Middle Bottom-Left Centre Plus / Minus Middle-Right / Middle-Left Power Action Toggle lled / curve / plot Toggle whether to scroll or not Toggle drawing orientation Pause the demo Increase / decrease volume Increase / decrease speed Exit demo

10.2.10. PictureFlow

Figure 10.38.: PictureFlow
PictureFlow provides a visualisation of your albums with their associated cover art. It is possible to start playback of the selected album from PictureFlow. Playback will start from the selected track. The PictureFlow plugin will continue to run while your tracks are played. Requirements PictureFlow uses both the album art (see section C.21 (page 190)) and database (see section 4.2 (page 27)) 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. Keys Key Middle-Left / Middle-Right Minus or Top-Middle / Plus or Bottom-Middle Centre Power or Bottom-Right Top-Left Long Power or Bottom-Right (in album view) Action Scroll through albums Scroll through track list
Enter track list / Play album from selected track Exit track list Enter menu Exit PictureFlow
Main Menu Go to WPS. Leave PictureFlow and enter the while playing screen. Playback Control. Control music playback from within the plugin. Settings. Enter the settings menu. Return. Exit menu. Quit. Exit PictureFlow plugin. Settings Menu Show FPS. Displays frames per second on screen. Spacing. The distance between the front edges of the side slides, i.e. changes the degree of overlap of the side slides. A larger number means less overlap. Scales with zoom. Centre margin. The distance, in screen pixels, with zoom at 100, between the centre and side slides. Scales with zoom.
Number of slides. Sets the number of slides at each side, including the centre slide. Therefore if set to 4, there will be 3 slides on the left, the centre slide, and then 3 slides on the right. Zoom. Changes the distance at which slides are rendered from the camera. Show album title. 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. Rebuild cache. Rebuild the PictureFlow cache. This is needed in order for PictureFlow to pick up new albums, and may occasionally be needed if albums are removed.

Note: The direction keys are set for the normal screen orientation, not the rotated orientation. Screen Size. Choose whether the original aspect ratio should be kept when scaling the picture to the screen. Screen Rotate. Rotate the displayed picture and direction keys by 90 degrees. Set Palette. Pick one of a few predened colour palettes. Reset. Resets the Emulator. Quit RockBoy. Quits the Rockboy plugin.

10.3.10. Search

This plugin can be used on playlists. It searches through the playlist that it opened on looking for any occurrences of the string entered by the user. The results of this search are saved to a new playlist, search_results.m3u, within the same directory as the original playlist.

10.3.11. Shopper

Shopper is a shopping list plugin which allows you to maintain reusable shopping lists.

10.3.12. Sort

This plugin takes a le and sorts it in ascending alphabetical order. Case is ignored. This is useful for ordering playlists generated by the Create Playlist menu option (see section 5.9 (page 46)).

10.3.13. Text Viewer

Figure 10.44.: Text Viewer
This is a Viewer for text les with word wrap. Just open a.txt or.nfo le to display it. The text viewer features controls to handle various styles of text formatting and has top-of-le and bottom-of-le buttons. You can view les 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. Default keys Key Minus / Top-Middle Plus / Bottom-Middle Middle-Left Middle-Right Centre Menu+Plus Menu / Top-Right Power / Top-Left Action Scroll-up Scroll-down Top of le (Narrow mode) / One screen left (Wide mode) Bottom of le (Narrow mode) / One screen right (Wide mode) Toggle autoscroll Set/Reset bookmarks Enter menu Exit text viewer
Chapter 10. Plugins Menu Return Return to the le being viewed. Viewer Options Change settings for the current le.
Encoding Set the codepage in the text viewer. Available settings: ISO-8859-1 (Latin 1). ISO-8859-7 (Greek), ISO-8859-8 (Hebrew), CP1251 (Cyrillic), ISO-8859-11 (Thai), CP1256 (Arabic), ISO-8859-9 (Turkish), ISO-88592 (Latin Extended), CP1250 (Central European), SJIS (Japanese), GB2312 (Simple Chinese), KSX-1001 (Korean), BIG5 (Traditional Chinese), UTF-8 (Unicode), This setting only applies to the plugin and is independent from the Default Codepage setting (see section 8.4 (page 65)). Word Wrap Toggle word wrap mode. On Break lines at the maximum column limit. O (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 les. Reow Lines Justify the text. Screens Per Page Set the number of screens per page. Available options are 1 to 5 screens per page. Alignment Set the text alignment. Right Set the text alignment to the right. (Useful for displaying right-to-left languages, such as Arabic or Hebrew) Left Set the text alignment to the left. Show Header Select whether to show the header. The header displays the le path. No Do not display the header. Yes Display the header. Show Footer Select whether to show the footer. The footer dispays the page number. No Do not display the footer. Yes Display the footer. Font Select the font to be used by the Text Viewer.

Counter Settings Opens a menu from which you can adjust settings pertaining to the counter. Mode Settings Opens a menu from which you can adjust settings pertaining to the current clock mode (analog, digital, binary). General Settings Reset Settings Reset all settings to their default values. Save Settings Save all settings to disk. Show Counter Toggle Counter display. Save Choose whether to disable automatic saving, saving to disk on exit, or saving to disk every settings change. Backlight Choose whether to disable the backlight, use the users timeout setting, or keep the backlight on. Idle Powero Toggle Idle Powero. Note: This setting is not saved to disk. Help Opens a brief help screen with key mappings and functionality. Credits Displays a credits roll.
Chapter 10. Plugins 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. The second hand, if enabled, is displayed along with the hour and minute hands. Digit display, if enabled, places 12, 3, 6, and 9 around the face of the clock in their respective positions. Digital mode An imitation of an LCD, this mode shows a Clock comprised of digital segments. The Date readout, if enabled, is displayed at the bottom, center. The Second readout, if in Text mode, is displayed at the top, center; if in Bar mode, is displayed as a progress bar at the top of the LCD; if in Invert mode, will invert the LCD left-to-right as the seconds pass (a fully-inverted LCD means the entire minute has passed). The Counter, if displayed, is shown at the upper left. The Blinking Colon, if enabled, blinks the colon once every second. 12-hour mode, if enabled, will display the time in a 12-hour format. LCD mode Based on the Digital Mode, the LCD mode is another imitation of an LCD. The settings available in this mode are exactly the same as Digital Mode, but they are independent of Digital Mode. For example, you can have the Date Readout enabled in Digital Mode and disabled in LCD Mode. Fullscreen A Fullscreen clock is displayed. Show Border, if enabled, will draw a small box at every hour position (1 to 12 inclusive). Invert Seconds, if enabled, will invert the LCD as the seconds pass. Second Hand, if enabled, will draw a second hand among the hour and minute hands. Binary mode This mode shows a Binary clock. The hour is displayed on the top line, the minute is displayed on the middle line, and the seconds are on the last line. Circle mode, if enabled, draws empty and full circles, instead of zeros and ones. For help on reading binary, please visit: http://en.wikipedia.org/wiki/Binary_numeral_system Plain mode This mode shows a plain clock in large text that takes up nearly the whole LCD.

10.4.17. Stopwatch

Figure 10.55.: Stopwatch
A simple stopwatch program with support for saving times.
Chapter 10. Plugins Key Action Quit Plugin Start / stop Reset timer (only when timer is stopped) Take lap time Scroll through lap times

10.4.18. Text Editor

This plugin allows you to view and edit simple text documents on your DAP. You can view les by using Open with from the Context Menu (see section 4.1.2 (page 24)). Usage If you start the Text Editor from the plugin browser you will be greeted with a blank screen. When started from the Open with menu item your le should be shown on the screen. You can now edit the le. The Text Editor is line based. This means you can edit one line at a time using the Virtual Keyboard (see section 4.1.3 (page 26)). Move the selection bar to the line you want to edit. Edit the highlighted text line or insert a new one using the Item Menu. When nished editing exit the Text Editor. Youll be shown a list of save options. Note: When you have not changed the le the Text Editor will quit immediately.
Key Menu or Centre or Middle-Right Power or Middle-Left Top-Left Long Menu or Long Centre or Long Middle-Right
Action Edit Line / Select Character Exit / Abort Editing Show Item Menu Delete Line
Chapter 11. Advanced Topics

11. Advanced Topics

11.1. Customising the User Interface

11.1.1. Getting Extras

Rockbox supports custom fonts. A collection of fonts is available for download in the font package at http://www.rockbox.org/daily.shtml.

11.1.2. Loading Fonts

Rockbox can load fonts dynamically. Simply copy the.fnt le to the player and play it in the File Browser. If you want a font to be loaded automatically every time you start up, it must be located in the /.rockbox/fonts directory and the lename must be at most 24 characters long. You can browse the fonts in /.rockbox/fonts under Settings Theme Settings Font in the Main Menu. 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.
11.1.3. Loading Languages

Appendix C. Theme Tags The images must be in BMP format The image tag must be on its own line The ID is case sensitive, giving 52 dierent IDs
The size of the LCD screen for each player varies. See table below for appropriate sizes of each device. The x and y coordinates must respect each of the players limits.

C.21. Album Art

Rockbox allows you to put the album art, or another image related to the music on your player to display it in the PictureFlow plugin or in the theme. For this feature to work, there are a few requirements.

C.21.1. Limitations

Rockbox supports embedded album art only for formats that use ID3v2 tags, such as MP3. It additionally supports loading images located on the ash storage. The image les must be in either BMP or JPEG format, while embedded album art is currently limited to JPEG. Rockbox does not support RLE-compressed BMP les, nor does it support progressive and multi-scan JPEG les. Embedded JPEG images must not be unsynchronized. JPEG les must consist of a single scan with interleaved components, as progessive and multi-scan images require much more memory to decode. Pictureow does not currently support embedded album art.
C.21.2. Where to put album art
The pictures can be named a number of dierent ways, and placed to a number of dierent locations. You can have pictures specic to the le or the album or use a generic picture. You can place the picture in the same directory as the le, in the parent directory or in a xed directory named /.rockbox/albumart/. The order Rockbox uses when looking for a picture is as follows (a list in braces means that those le extensions are tried in that order): 1. embedded (JPEG images in ID3v2 tags only) 2./filename.{jpeg,jpg,bmp} 3./albumtitle.{jpeg,jpg,bmp} 4./cover.{jpeg,jpg,bmp} 5./folder.jpg
Appendix C. Theme Tags 6. /.rockbox/albumart/albumartist-albumtitle.{jpeg,jpg,bmp} 7./albumtitle.{jpeg,jpg,bmp} 8./cover.{jpeg,jpg,bmp}
The following characters will be replaced with an underscore (_) when looking for albumtitle.bmp or albumartist-albumtitle.bmp: \ / : < > ? * |. Doublequotes will be replaced by single quotes. If no album artist is set, artist will be used instead. See ZAlbumArt in the wiki for programs that will help you automate the process of putting album art on your player.
C.21.3. How to display the album art
Once the album art les are present on your player, they can be displayed as follows. Tag %Cl(x,y,[maxwidth], [maxheight], hor_align, vert_align) Description Dene the settings for album art x: x coordinate y: y coordinate maxwidth: Maximum height maxheight: Maximum width hor_align: Horizontal alignment, enter as l, c or r for left, centre or right. Centre is default vert_align: Vertical alignment, enter as t, c or b for top, centre or bottom. Centre is default Display the album art as congured. Use in a conditional to determine if an image is available.

Cowon D2 Audible User Guide
Requirements & Tech Specs
Windows XP with SP 2 or Vista Windows Media Player 11. Audible Formats: Capacities Available: 1GB, 2GB, & 8GB Bookmarking: No
Section Navigation: Yes Variable Playback Speed: No FM Radio: Yes Video: Yes Removable Battery: No

How To's:

A. Playback: How do I locate/play Audible content on the device?
1. From the Main Menu, select Music to go to the Music menu. 2. Next, tap the screen to display additional options and select Browser in the lower left corner of the screen. 3. Then, select Music List on the left side of the screen. 4. Select Mode in the lower left corner of the screen , then select Music Library on the left hand side of the screen. 5. Scroll down and select Audible. 6. Finally, select the title that you want to play.
B. Rewind/Fast-Forward: How do I rewind/fast-forward through my Audible
content on the device? 1. Rewinding: While a title is playing tap the screen to bring up the menu and hold down the Rewind button. 2. Fast-Forwarding: While a title is playing tap the screen to bring up the menu and hold down the Fast Forward button.
C. Section Navigation: How do I use section navigation?
1. Audible section navigation must be turned on to navigate by sections. To turn this on from the Main Menu select Settings. 2. Next select General. 3. Scroll down and select Audible Section Navigate to enable section navigation. (When enabled, Audible Section Navigate will be checked). 4. While a title is playing, tap the screen to bring up the menu. a. Press the Rewind (<<) button to return to the previous section. b. Press the Fast Forward (>>) button to skip to the next section.

Buttons and Functions