Toshiba Rockbox F Series manual

The Ro c kb o x Man ual for T oshiba Gigab eat F Series ro c kb o x.org Decem b er 23, 2008[...]

2 Ro ckb o x http://www.ro ckbox.o rg/ Op en Source Juk eb o x Firm ware Ro c kb o x and this man ual is the collab orativ e effort of the Ro c kb o x team and its con tributors. See the app endix for a complete list of con tributors. c  2003-2008 The Ro c kb o x T eam and its con tributors, c  2004 Christi Alice Scarb orough, c  2003 Jos[...]

Contents 3 Contents 1 Intro duction 9 1.1 W elcome ..................................... 9 1.2 Getting more help ............................... 9 1.3 Naming con ven tions and marks ........................ 1 0 2 Installation 11 2.1 Ov erview .................................... 1 1 2.2 Prerequisites .................................. 1 2 2.3 Insta[...]

Contents 4 4.2.3 The Database Men u .......................... 2 6 4.2.4 Using the Database .......................... 2 7 4.3 While Pla ying Screen .............................. 2 8 4.3.1 WPS Key Con trols ........................... 2 9 4.3.2 P eak Meter ............................... 2 9 4.3.3 The WPS Con text Menu ....................... 3 0 [...]

Contents 5 7 Pla yback Settings 48 7.1 Sh uffle ...................................... 4 8 7.2 Rep eat ...................................... 4 8 7.3 Pla y Selected First ............................... 4 9 7.4 F ast-F orward/Rewind .............. ............... 4 9 7.5 An ti-Skip Buffer ................................ 4 9 7.6 F ade on Stop/P au[...]

Contents 6 10.1.6 Dice ................................... 7 2 10.1.7 Do om .................................. 7 3 10.1.8 Flipit .................................. 7 5 10.1.9 Jew els .................................. 7 6 10.1.10 MazezaM ................................ 7 7 10.1.11 Minesw eep er .............................. 7 8 10.1.12 P acb o x [...]

Contents 7 10.3.8 Searc h .................................. 1 1 6 10.3.9 Sort ................................... 1 1 6 10.3.10 T ext View er ............................... 1 1 6 10.3.11 VBRfix ................................. 1 1 8 10.3.12 ZXBo x .................................. 1 1 8 10.4 Applications ................................... 1 2[...]

Contents 8 B.1 Status Bar .................................... 1 4 2 B.2 ID3 Info ..................................... 1 4 2 B.3 Po wer Related Information .......................... 1 4 3 B.4 File Info ..................................... 1 4 3 B.5 Playlist/Song Info ............................... 1 4 4 B.6 Runtime Database ....................[...]

Chapter 1. Introduction 9 1 Intro duction 1.1 W elcome This is the man ual for Ro c kb o x. Rockbox is an open source firmw are replacement for a gro wing num b er of digital audio pla yers. Ro c kb o x aims to b e considerably more functional and efficien t than your device’s stock firm ware while remaining easy to use and customisable. Rockbo[...]

Chapter 1. Introduction 10 c hannel for Ro c kb o x is #rockbox on irc://irc.freeno de.net . A bunch of helpful dev elop ers and users are usually around. Just join and ask – if someone knows the answ er you’ll usually get an answ er pretty quic kly . More information including IR C logs can b e found at http://www.ro ckbox.o rg/irc/ . W e also[...]

Chapter 2. Inst alla tion 11 2 Installation 2.1 Overview There are t wo w ays of installing Rockbox: automated and manual. While the man ual w ay is older, more tested and prov en to work correctly , the automated installation is based on a nice graphical application that do es almost ev erything for y ou. It is still imp ortan t that y ou hav e an[...]

Chapter 2. Inst alla tion 12 2.2 Prerequisites Before installing Ro c kb o x y ou should make sure y ou meet the prerequisites. Y ou ma y need some additional to ols for installation. In most cases these will already b e a v ailable on y our computer, but if not, installing some additional softw are might be necessary . USB connection. T o transfer[...]

Chapter 2. Inst alla tion 13 • Uninstall all comp onen ts y ou installed using Ro c kb o x Utility Prebuilt binaries for Windo ws, Lin ux and MacOS X are av ailable at the Z Ro c kb o xUtility wiki page. W arning: When first starting Rockbo x Utility run “Autodetect”, found in the con- ! figuration dialog (File → Configure). Auto detecti[...]

Chapter 2. Inst alla tion 14 Installing the firmw are 1. Download y our c hosen version of Rockbox from the links in the previous section. 2. Connect your pla y er to the computer via USB as describ ed in the manu al that came with y our play er. 3. T ake the .zip file that y ou do wnloaded and use the “Extract all” command of y our unzip pro[...]

Chapter 2. Inst alla tion 15 • Starting at the ro ot directory of y our pla yer bro wse into the directory GBSYSTEM and from that in to the sub directory FWIMG . These directories are hidden. Make sure that y ou hav e configured your bro wser to show hidden files or y ou ma y b e unable to see FWIMG . • In that directory y ou’ll find a fi[...]

Chapter 2. Inst alla tion 16 o verwrite files, c ho ose the “Y es to all” option. The new build will b e installed o ver y our curren t build. Note: If y ou use Ro c kb o x Utility be aw are that it cannot detect manually installed b comp onen ts. 2.6 Uninstalling Ro ckb o x 2.6.1 Automatic Uninstallation Y ou can uninstall Ro c kb o x automat[...]

Chapter 3. Quick St ar t 17 3 Quick Sta rt 3.1 Basic Overview 3.1.1 The pla y er’s controls Throughout this man ual, the buttons on the pla yer are labelled according to the picture ab o v e. Whenever a button name is prefixed b y “Long”, a long press of approx- imately one second should b e performed on that button. The buttons are describ [...]

Chapter 3. Quick St ar t 18 do c king station and finally on the righ t hand side of the b ottom of the unit is a mini USB so c k et for connecting directly to USB. Finally on the righ t hand side of the unit are some control buttons. Going from the b ottom of the unit to the top there is a small round A buttton then a rock er volume switc h with [...]

Chapter 3. Quick St ar t 19 to bro wse in a view that is based on the meta-data 1 of your audio files, select D a t abase (see section 4.2 (page 25 )). 3.1.5 Basic controls When bro wsing files and moving through men us you usually get a list view presen ted. The na vigation in these lists are usually the same and should b e prett y in tuitiv e. [...]

Chapter 3. Quick St ar t 20 3.2 Customising Ro ckb o x Ro c kb o x’ User In terface can b e customised using “Themes”. Themes usually only affect the visual app earance, but an adv anced user can create a theme that also c hanges v arious other settings lik e file view, LCD settings and all other settings that can b e modified using .cfg ?[...]

Chapter 4. Bro wsing and pla ying 21 4 Bro wsing and pla ying 4.1 File Bro wser Figure 4.1: The file bro wser Ro c kb o x lets y ou browse y our music in either of t wo w a ys. The File Browser lets y ou navigate through the files and directories on y our play er, entering directories and executing the default action on eac h file. T o help di?[...]

Chapter 4. Bro wsing and pla ying 22 4.1.1 File Bro wser Controls Key Action Up / Do wn Go to previous/next item in list. If y ou are on the first/last en try , the cursor will wrap to the last/first en try . Left Go to the paren t directory . Select or Righ t Executes the default action on the se- lected file or en ters a directory . A If there[...]

Chapter 4. Bro wsing and pla ying 23 The Context Menu allows y ou to p erform certain operations on files or directories. T o access the Context Menu , p osition the selector o ver a file or directory and access the con text menu with Long Select . Note: The Context Menu is a context sensitiv e men u. If the Context Menu is b in vok ed on a file[...]

Chapter 4. Bro wsing and pla ying 24 Add to Sho rtcuts. Adds a link to the selected item in the shortcuts.link file. If the file do es not already exist it will be created in the ro ot directory . Note that if you create a shortcut to a file, Ro c kb o x will not op en it up on selecting, but simply bring y ou to it’s lo cation in the File Bro[...]

Chapter 4. Bro wsing and pla ying 25 Key Action Left / Righ t / Up / Do wn Mo ve about the virtual keyboard (mov es the solid cursor) A + Left or A + Righ t Mo ve the line cursor within the text line Select Inserts the selected k eyb oard letter at the curren t cursor p osition P ow er Exits the virtual k eyb oard without sa ving an y changes A Exi[...]

Chapter 4. Bro wsing and pla ying 26 If a sub directory of an ’ignored’ directory should still b e scanned, place a file named database.unignore in it. The files in that directory and its sub directories will b e scanned and added to the database. 4.2.3 The Database Menu Load T o RAM The database can either b e k ept on disk (to sa ve memory)[...]

Chapter 4. Bro wsing and pla ying 27 Imp o rt Mo difications. Allows the /.rockbox/database changelog.txt bac kup to b e con venien tly loaded into the database. If Auto Upda te is enabled this is p er- formed automatically when the database is initialized. 4.2.4 Using the Database Once the database has b een initialized, you can bro wse y our mus[...]

Chapter 4. Bro wsing and pla ying 28 T ag T yp e Origin filename string system album string id tag albumartist string id tag artist string id tag commen t string id tag comp oser string id tag genre string id tag grouping string id tag title string id tag bitrate n umeric id tag discn um n umeric id tag y ear n umeric id tag trac knum n umeric id [...]

Chapter 4. Bro wsing and pla ying 29 • The ID3 album name. • The ID3 artist name. • Bit rate. VBR files display a v erage bitrate and “(avg)” • Elapsed and total time. • A slidebar progress meter represen ting where in the song you are. • P eak meter. See section 11.2 (page 134 ) for details of customising y our WPS (While Playing [...]

Chapter 4. Bro wsing and pla ying 30 The ba r: This is the wide horizon tal bar. It represents the curren t volume v alue. The p eak indicato r: This is a little vertical line at the righ t end of the bar. It indicates the p eak volume v alue that o ccurred recently . The clip indicato r: This is a little blac k blo ck that is displa yed at the v e[...]

Chapter 4. Bro wsing and pla ying 31 Sound Settings This is a shortcut to the Sound Settings Menu , where you can configure v olume, bass, treble, and other settings affecting the sound of y our music. See section 6 (page 42 ) for more information. Pla yback Settings This is a shortcut to the Pla yback Settings Menu , where y ou can configure sh[...]

Chapter 4. Bro wsing and pla ying 32 This screen is accessible from the WPS screen, and provides a detailed view of all the iden tity information about the current trac k. This info is kno wn as meta data and is stored in audio file formats to k eep information on artist, album etc. T o access this screen, Op en With... This Open With function is [...]

Chapter 4. Bro wsing and pla ying 33 Directo ry . A playlist! One of the keys to getting the most out of Rockbox is under- standing that Ro ckbox always considers the song that it is pla ying to b e part of a pla ylist, and in some situations, Rockbox will create a pla ylist automatically . F or example, if you are pla ying the con tents of a direc[...]

Chapter 4. Bro wsing and pla ying 34 existing pla ylist and Add to a new pla ylist creates a new playlist con taining the selected trac k or directory . Note: All pla ylists in the Pla ylist ca t alog are stored by default in the /Playlists b directory in the ro ot of y our play er’s disk and playlists stored in other locations are not included i[...]

Chapter 4. Bro wsing and pla ying 35 Insert. Add trac k(s) immediately after any trac ks added via the most recent Inser t op eration. If no tracks ha v e yet been added via an Inser t , new tracks will be added immediately after the curren t playing trac k. If playbac k is stopp ed a new dynamic pla ylist will get created with the selected tracks.[...]

Chapter 4. Bro wsing and pla ying 36 Moving and removing tracks T o mo ve or remo ve a trac k from the current pla ylist enter the Pla ylist Viewer by selecting View Current Pla ylist in the Pla ylist submenu in the WPS con text men u or the Main Menu . Once in the Pla ylist Viewer op en the context men u on the trac k you w ant to mo ve or remo v [...]

Chapter 5. The Main Menu 37 5 The Main Menu 5.1 Intro ducing the Main Menu Figure 5.1: The main men u The Main Menu is the screen from which all of the Rockbox functions can be accessed. This is the first screen y ou will see when starting Ro c kb o x. T o return to the Main Menu , press the Men u button. All settings are stored on the unit. How e[...]

Chapter 5. The Main Menu 38 5.2 Navigating the Main Menu 5.3 Recent Bo okmarks Figure 5.2: The list b o okmarks screen If the Sa ve a list of recentl y crea ted bookmarks option is enabled then you can view a list of sev eral recent bo okmarks here and select one to jump straight to that trac k. See section 8.6 (page 60 ) for more details on confi[...]

Chapter 5. The Main Menu 39 5.7 Settings The Settings men u allows to set or adjust man y parameters that affect the wa y your pla yer w orks. There are many submen us for different parameter areas. Every time y ou are setting a v alue of a parameter, and that v alue is selected from a list of some predefined a v ailable v alues, you can press L[...]

Chapter 5. The Main Menu 40 Create Pla ylist: Ro c kb o x will create a playlist with all trac ks in the current directory and all sub-directories. The playlist will be created one directory level “up” from where y ou currently are. View Current Pla ylist: Displa ys the conten ts of the playlist curren tly stored in memory . Save Current Pla yl[...]

Chapter 5. The Main Menu 41 5.11 Quick Screen Whilst not strictly part of the Main Menu , it is worth noting that a few of the more commonly used settings are a v ailable from the Quick Screen . The Quick Screen screen is accessed with Long Menu and exited with Men u . It allo ws rapid access to the Shuffle and Repea t mo des (section ?? (page ?? )[...]

Chapter 6. Sound Settings 42 6 Sound Settings Figure 6.1: The sound settings screen The sound settings men u offers a selection of sound settings you ma y change to customise y our listening exp erience. 6.1 V olume This setting adjusts the v olume of your m usic. Like most professional audio gear and man y consumer audio pro ducts, Ro ckbox uses [...]

Chapter 6. Sound Settings 43 6.2 Bass This setting emphasises or suppresses the lo wer (bass) frequencies in the sound. A v alue of 0 dB means that bass sounds are unaltered (flat resp onse). 6.3 T reble This setting emphasises or suppresses the higher (treble) frequencies in the sound. A v alue of 0 dB means that treble sounds are unaltered (fla[...]

Chapter 6. Sound Settings 44 ten ts of one channel in to the other. This has the effect of gradually centering the stereo image, until y ou ha ve monophonic sound at 0%. V alues ab ov e 100% will progressively remo ve components in one c hannel that is also present in the other. This has the effect of widening the stereo field. A v alue of 100% [...]

Chapter 6. Sound Settings 45 Bew are that the crossfeed function is capable of making the audio distort if you c ho ose settings whic h result in a to o high output lev el. 6.8 Equalizer Figure 6.2: The graphical equalizer Ro c kb o x features a parametric equalizer (EQ). As the name suggests, a parametric EQ lets y ou control sev eral different p[...]

Chapter 6. Sound Settings 46 Bands 1-3: Peaking filters P eaking EQ filters b o ost or low er a frequency range centered at the cen ter frequency chosen. Graphic equalizers in home stereos are usually p eaking filters. The p eaking filters in Ro c kb o x’s EQ lets you adjust three differen t parameters for EQ bands 1 through 3. The “center[...]

Chapter 6. Sound Settings 47 Advanced EQ: This sub menu pro vides options for adjusting the same parameters as the Graphical EQ . The only difference is that the parameters are adjusted through textual men us rather than through a graphic interface. Save EQ Preset: This option sav es the curren t EQ configuration in a .cfg file. Bro wse EQ Prese[...]

Chapter 7. Pla yba ck Settings 48 7 Pla yback Settings The Pla yback Settings menu allo ws you to configure settings related to audio play- bac k. 7.1 Shuffle T urning sh uffle on will cause Ro c kb ox to randomly re-order the pla ylist. Th us, to shuffle all of the audio files on the pla yer, you first need to create a pla ylist containing all [...]

Chapter 7. Pla yba ck Settings 49 7.3 Pla y Selected First This setting con trols what happ ens when y ou select a file for playbac k while shuffle mode is on. If the Pla y Selected First setting is Yes , the file y ou selected will b e play ed first. If this setting is No , a random file in the directory will b e play ed first. 7.4 F ast-F or[...]

Chapter 7. Pla yba ck Settings 50 Enable Crossfade If set to Off , crossfade is disabled. If set to Al w a ys , songs will alw ays crossfade in to one another. If set to Shuffle , crossfade is enabled when the sh uffle feature is set to Yes , but disabled otherwise. If set to track skip only , trac ks will only crossfade when you man ually change t[...]

Chapter 7. Pla yba ck Settings 51 7.9 Repla ygain This allo ws you to con trol the replaygain function. The purp ose of replaygain is to adjust the v olume of the music pla yed so that all songs (or albums, depending on your settings) ha ve the same apparen t volume. This prev en ts sudden changes in v olume when c hanging b et ween songs recorded [...]

Chapter 7. Pla yba ck Settings 52 Note: Y ou m ust hav e the Repea t option set to No for A uto-Change Director y to b function prop erly . Note: This feature only w orks when songs hav e b een play ed from the file browser. Using b it with the database ma y cause unexp ected b ehavior. 7.12 P ause on Headphone Unplug Enables and disables automati[...]

Chapter 7. Pla yba ck Settings 53 7.15 Skip Length Designed to sp eed up na vigation and preven t uninten tional track skipping when listening to long audio trac ks, Skip Length changes the behavior of the Left and Righ t buttons so that they skip b y a given n umber of minutes instead of skipping to a new trac k. Note: T o skip trac ks with this s[...]

Chapter 8. General Settings 54 8 General Settings Figure 8.1: The general settings screen 8.1 Pla ylist The Pla ylist sub menu allo ws you to configure settings related to pla ylists. Recursively Insert Directo ries. If set to On , then when a directory is inserted or queued in to a dynamic playlist, all sub directories will also b e inserted. If [...]

Chapter 8. General Settings 55 So rt Case Sensitive: If this option is set to Yes , all files that start with upp er case letters will b e listed first, follow ed b y all files that b egin with low er case letters. If this option is set to NO, then case will b e ignored when sorting files. So rt Directories: This option controls ho w Ro ckbox s[...]

Chapter 8. General Settings 56 This has a similar effect on the Database bro wser. If set to Current Director y Onl y or Full P a th , then the title of each men u will b e displa yed on the first line in the D a t abase Browser . 8.3 Database This sub men u allows y ou to configure the database. See section 4.2 (page 25 ) for more information a[...]

Chapter 8. General Settings 57 Scroll Sp eed: Sets how man y times p er second the automatic horizontal scrolling text will mo ve a step. Scroll Sta rt Delay: Controls ho w many milliseconds Rockbox should w ait b efore a new text b egins automatically scrolling. Scroll Step Size: Defines the num b er of pixels the text should mo ve for eac h step[...]

Chapter 8. General Settings 58 Clip Hold Time: The num b er of seconds that the clipping indicator will b e visible after clipping is detected. Scale: Select whether the p eak meter displa ys linear or logarithmic v alues. The h uman ear p erceives loudness on a logarithmic scale. If the Scale setting is set to Logarithmic (dB) scale, the volume v [...]

Chapter 8. General Settings 59 effect whatso ev er on actual battery life. This setting only affects the accuracy of the battery life estimation as sho wn on screen. Cha rge During USB Connection: This option lets y ou control whether the pla y er should c harge during the USB connection and hence draw the full 500mA. T urning it Off is recommend[...]

Chapter 8. General Settings 60 Max Pla ylist Size: This setting con trols the maximum size of a pla ylist. The pla ylist size can b e b etw een 1,000 and 32,000 files, in steps of 1,000 (default is 10,000). Higher v alues will shorten the m usic buffer, so y ou should increase this setting only if y ou hav e very large pla ylists. 8.5.6 Ca r Adap[...]

Chapter 8. General Settings 61 will b e added to the fron t of the existing list, up to the maximum n umber of allow ed b o okmarks p er file (currently 10). If no .bmark file exists, one will b e created with the new b o okmark information. Finally , if the Maint ain a list of Recentl y Used Bookmarks option is enabled, the b o okmarking informa[...]

Chapter 8. General Settings 62 8.8 V oice V oice Menus. This option controls the v oicing of menus/settings as they are selected b y the cursor. In order for this to work, a voice file m ust b e present in the /.rockbox/langs/ directory on the pla yer. V oice files are large and are not shipp ed with Ro ckbox b y default. The v oice file is the [...]

Chapter 8. General Settings 63 Off. No c hecking is made for file .talk clips; they are not used even if presen t. This can reduce disk activit y . Use of a .talk clip tak es precedence ov er other filename voicing. Otherwise (e.g. if a .talk clip is not a v ailable), voicing uses the method set under Voice Filenames ab o v e. Sa y File T yp e. [...]

Chapter 9. Theme Settings 64 9 Theme Settings The Theme Settings menu offers options that y ou can change to customize the visual app erance of Ro ckbox. Bro wse Themes. This option will displa y all the currently installed themes on the pla yer, press Select or Righ t to load the chosen theme and apply it. A theme is a configuration file, store[...]

Chapter 9. Theme Settings 65 Ba r (Gradient Colour): A bar with a colour gradient, the colours are set in the Colours submen u. Colours. The options in this men u sets the colours for visual elements in Ro c kb o x. Line Selecto r Colours. These options sets the colours for the line selector bars. Prima ry Colour: Set the primary colour used for th[...]

Chapter 10. Plugins 66 10 Plugins Plugins are programs that Ro c kb o x can load and run. Only one plugin can b e loaded at a time. Plugins ha ve exclusiv e con trol o ver the user in terface. This means y ou cannot switc h back and forth betw een a plugin and Ro ckbox. When a plugin is loaded, you need to exit it to return to the Ro ckbox in terfa[...]

Chapter 10. Plugins 67 10.1.1 Blackjack Figure 10.1: Blac kjack Blac kjack, a game play ed in casinos around the w orld, is now a v ailable in the palm of y our hand! The rules are simple: try to get as close to 21 without going ov er or simply b eat out the dealer for the b est hand. Although this may not seem difficult, blac kjack is a game reno [...]

Chapter 10. Plugins 68 Key Action In men u A Start new game Men u Resume sav ed game Righ t Show high scores P ow er Quit In game Left / Righ t / Up / Do wn Enter betting amount V olume up Hit (Dra w new card) V olume down Sta y (End hand) Select Double do wn Men u Sav e game P ow er Return to men u or cancel 10.1.2 BrickMania Figure 10.2: Bric kMa[...]

Chapter 10. Plugins 69 the paddle. Lo ok out for the bad ones. Sp ecial items Displa yed Name Description N Normal Returns paddle to normal. D Die Ball dies; lose a life. L Life Gain a life. F Fire Allo ws you to shoot bricks with paddle. G Glue Ball stic ks to paddle each time it hits. B Ball Immediately fires another ball. FL Flip Flip left / ri[...]

Chapter 10. Plugins 70 10.1.3 Bubbles Figure 10.3: Bubbles The goal of the game is to b eat each lev el as quic kly as p ossible by clearing the b oard of all bubbles. Bubbles are remo ved from the b oard when a cluster of three of more of the same t yp e is formed. The game is o ver when an y bubbles on the b oard extend b elow the b ottom line. T[...]

Chapter 10. Plugins 71 10.1.4 Chessb o x Figure 10.4: Chessb ox Chessb o x is a one-p erson c hess game with computer artificial intelligence. The chess engine is a p ort of GNU Chess 2 by John Stan bac k. It also w orks as a PGN file viewer. Instead of executing the game from the plugin men u, lo ok for any file with .pgn extension in the file[...]

Chapter 10. Plugins 72 Keys Key Action Direction k eys Mo ve the cursor Select Pic k up / Drop piece Men u Change level A F orce pla y P ow er Sho w the men u 10.1.5 Chopp er Na vigate a cav ernous maze without banging into w alls, the ceiling, or the flo or. Ho w long can y ou fly your c hopp er? Key Action Select Mak e chopper fly Men u Enter [...]

Chapter 10. Plugins 73 10.1.7 Do om Figure 10.5: Do om This is the famous Do om game. Getting sta rted F or the game to run you need .wad game files located in /.rockbox/doom/ on your pla yer. Create the directory and sa ve the follo wing files there: ro ckdo om.wad. The Rockbox .wad , based on prboom.wad from prbo om-2.2.6 Y our w ad files. Cop[...]

Chapter 10. Plugins 74 Main Menu. The Do om plugin has a main menu, whic h is brought up before a game is started. It has the following en tries: Game. Select whic h (official) wad to launc h A ddon. Select whic h unofficial addon wad to launc h (F rom /.rockbox/doom/addons directory) Demos. Select whic h demo file to play on game start Options. C[...]

Chapter 10. Plugins 75 Keys Key Action Up Mo ve F orw ard Do wn Down Left T urn Left Righ t T urn Right A Sho ot Men u Op en P ow er Escap e Select En ter V olume down Change W eap on Pla ying the game After installation of the wad files is complete y ou can start the game. 10.1.8 Flipit Figure 10.6: Flipit Flipping the colour of the tok en under [...]

Chapter 10. Plugins 76 one colour. Key Action Up / Do wn / Left / Righ t Mo ve the cursor Select Flip Men u Shuffle V olume up Solv e V olume down Solv e step by step P ow er Quit the game 10.1.9 Jew els Figure 10.7: Jew els Jew els is a simple yet addicting game whic h inv olves sw apping pairs of jew els in order to form connected segmen ts of th[...]

Chapter 10. Plugins 77 Key Action Left / Righ t / Up / Do wn Mov e the cursor around the jewels Select Select a jew el Long Select Sho w the in-game menu P ow er Exit 10.1.10 MazezaM Figure 10.8: MazezaM The goal of this puzzle game is to escap e a dungeon consisting of ten “mazezams”. These are ro oms con taining ro ws of blo c ks which can be[...]

Chapter 10. Plugins 78 Key Action Up , Do wn , Left , Righ t Mo ve Character P ow er Men u 10.1.11 Minesw eep er Figure 10.9: Minesw eep er plugin The classic game of minesw eep er. Use to select the required p ercen tage of mines to set the difficult y then press the k ey to b egin. The aim of the game is to unco ver all of the squares on the boar[...]

Chapter 10. Plugins 79 Key Action Up / Do wn / Left / Righ t Mo ve the cursor across the minefield A T oggle flag on / off Select Rev eal the conten ts of the current square Men u Display the curren t game status P ow er Exit the game 10.1.12 P acb o x Figure 10.10: P acb o x P acb o x is an emulator of the P acman arcade machine hardw are. It i[...]

Chapter 10. Plugins 80 Filename MD5 c hec ksum pacman.5e 2791455babaf26e0b396c78d2b45f8f6 pacman.5f 9240f35d1d2b eee0ff17195653b5e405 pacman.6e 290aa5eae9e2f63587b5dd5a7da932da pacman.6f 19a886fcd8b5e88b0ed1b97f9d8659c0 pacman.6h d7cce8bffd9563b133ec17ebbb6373d4 pacman.6j 33c0e197b e4c787142af6c3b e0d8f6b0 These need to b e stored in the /.rockbo[...]

Chapter 10. Plugins 81 10.1.13 P egb o x Figure 10.11: p egb ox T o b eat each lev el, you m ust destroy all of the pegs. If tw o like pegs are pushed into eac h other they disapp ear except for triangles which form a solid block and crosses whic h allo w you to c ho ose a replacement block. Key Action In game Up , Do wn , Left , Righ t to mo ve ar[...]

Chapter 10. Plugins 82 10.1.14 P ong Figure 10.12: P ong P ong is a simple tw o play er “tennis game”. Whenever a pla y er misses the ball the other scores. Key Action Up Left pla yer up Do wn Left play er down V olume up Righ t play er up V olume down Righ t play er down P ow er Quit The R ockbox manual Toshiba Gigabea t F Series[...]

Chapter 10. Plugins 83 10.1.15 Rob otfindskitten Figure 10.13: Rob otfindskitten In this game, you are robot (#). Y our job is to find kitten. This task is complicated b y the existence of v arious things which are not kitten. Robot must touc h items to determine if they are kitten or not. The game ends when rob otfindskitten. Key Action Up , D[...]

Chapter 10. Plugins 84 10.1.16 Ro ckblo x Figure 10.14: Ro ckbl o x Ro c kblo x is a ro ckbox v ersion of the classic falling blo cks game. The aim of the game is to mak e the falling blo c ks of different shapes form full ro ws. Whenev er a ro w is complete it will b e cleared and the game score will increase. F or ev ery ten lines completed the [...]

Chapter 10. Plugins 85 10.1.17 Ro ckblo x1d Ro c kblo x1d is a game for p eople who find ro ckblo x to o hard. In this version the second dimension is missing so the user only has to mo ve the bric ks down. No horizon tal moving an ymore and no need to rotate the brick! Key Action Select Mo ve do wn faster P ow er Quit 10.1.18 Sliding Puzzle Figur[...]

Chapter 10. Plugins 86 Key Action Left , Righ t , Up and Do wn Mo ve Tile Select Sh uffle A Change b et w een picture and num b ered tiles P ow er Stop the game 10.1.19 Snak e Figure 10.16: Snak e This is the p opular snak e game. The aim is to grow y our snak e as large as p ossible by eating the dots that app ear on the screen. The game will end [...]

Chapter 10. Plugins 87 10.1.20 Snak e 2 Figure 10.17: Snak e 2 – The Snake Strik es Back Another v ersion of the Snake game. Mo ve the snak e around, and eat the apples that p op up on the screen. Each time an apple is eaten, the snake gets longer. The game ends when the snak e hits a wall, or runs in to itself. Key Action In men u Up / Do wn Set[...]

Chapter 10. Plugins 88 10.1.21 Sok oban Figure 10.18: Sok oban The ob ject of the game is to push b oxes in to their correct p osition in a cro wded warehouse with a minimal n umber of pushes and mov es. The b oxes can only be pushed, never pulled, and only one can b e pushed at a time. Sok oban may be used as a viewer for viewing sa ved solutions [...]

Chapter 10. Plugins 89 Key Action In game Up , Do wn , Left , Righ t Mo ve the “sok oban” up, down, left, or righ t P ow er Men u V olume down Bac k to previous level Men u Restart level V olume up Go to next lev el Select Undo last mo vemen t A Redo previously undone mo ve Solution pla yback Select P ause/resume Up / Do wn Increase/decrease pl[...]

Chapter 10. Plugins 90 10.1.22 Solitaire Figure 10.19: Klondik e solitaire This is the classic Klondik e solitaire game for Ro c kb o x. This is probably the b est-known solitaire in the w orld. Man y p eople do not even realize that other games exist. Though the name ma y not b e familiar, the game itself certainly is. This is due in no small part[...]

Chapter 10. Plugins 91 Key Action Up / Do wn / Left / Righ t Mo ve Cursor around. Select Select cards, mo v e cards, rev eal hidden cards... Men u If a card was selected – unselect it, else Dra w 3 new cards from the remains stack A + Left Put the card from the top of the remains stac k on top of the cursor Long Select Put the card under the curs[...]

Chapter 10. Plugins 92 Key Action Select Sho ot Up Thrust Left / Righ t T urn left/right Do wn T elep ort A P ause game P ow er Quit 10.1.24 Sta r Figure 10.21: Star game This is a puzzle game. It is actually a rewrite of Star, a game written b y CDK designed for the hp48 calculator. Rules: T ake all of the “o”s to go to the next lev el. Y ou c[...]

Chapter 10. Plugins 93 Key Action Left Mo ve Left Righ t Mov e Right Up Mo ve Up Do wn Mov e Down Select Switc h b et ween circle and square V olume down Previous lev el A Reset lev el V olume up Next lev el P ow er Exit the game 10.1.25 Sudoku Figure 10.22: Sudoku Sudoku in Ro ckbox can act as both a plugin and a viewer. When starting Sudoku from [...]

Chapter 10. Plugins 94 Y ou can create and sa ve y our own grids under the New men u option. Enter the men u (as describ ed in the k ey table b elo w) when you ha ve finished and en ter the full path to sa ve to including the .ss extension (e.g. /sudoku/new.ss ). The scratchpad When y ou play Sudoku on paper most p eople lik e to mark num b ers in[...]

Chapter 10. Plugins 95 10.1.26 W ormlet Figure 10.23: W ormlet game W ormlet is a m ulti-worm game on a m ulti-threaded multi-functional Rockbox console. Y ou na vigate a hungry little w orm. Help your w orm to find fo o d and to a void poisoned argh-tiles. The goal is to turn your tin y w orm into a big w orm for as long as p ossible. Men u contr[...]

Chapter 10. Plugins 96 The game Use the con trol keys of y our worm to na vigate around obstacles and find fo o d. W orms do not stop mo ving except when dead. Dead worms are no fun. Be careful as y our worm will try to eat an ything that you steer it across. It won’t distinguish whether it is edible or not. F o o d. The small square hollow piec[...]

Chapter 10. Plugins 97 Hungry: That’s the normal state of a w orm. W orms are alwa ys h ungry and wan t to eat. It is go o d to hav e a h ungry worm since it means that y our worm is aliv e. But it is b etter to get your w orm gro wing. Gro wing: When a worm has eaten a piece of foo d it starts growing. F or eac h step it mo ves o ver foo d it ca[...]

Chapter 10. Plugins 98 10.1.27 Xob o x Figure 10.24: Xob o x Xob o x is a simple clone of the w ell known arcade game Qix. The aim of the game is to section off parts of the arena with y our trail in order to remo ve that section from the game. Be careful not to get in the w ay of enem y balls b ecause, if they hit you or y our trail, y ou lose a [...]

Chapter 10. Plugins 99 10.2 Demos 10.2.1 Bounce Figure 10.25: Bounce This demo is of the w ord “Ro ckbox” bouncing across the screen. There is also an analogue clo ck in the bac kground. In Scroll mode the b ouncing text is replaced by a differen t one scrolling from right to left. Key Action Up / Do wn Mov es to next/previous option Left / Ri[...]

Chapter 10. Plugins 100 10.2.2 Credits The credits plugin scrolls the en tire list of the names of all the Ro c kb o x contributors after displa ying the Ro c kb o x logo and version. This plugin is called when selecting Version from the System section of the Ro ckbox main men u. Exit at any time b y pressing Left or P ow er . 10.2.3 Cub e Figure 1[...]

Chapter 10. Plugins 101 10.2.4 Demystify Figure 10.27: Dem ystify Dem ystify is a screen sav er like demo. Key Action Righ t / Left Increase / decrease sp eed Up / Do wn Add / remov e p olygon P ow er Quit The R ockbox manual Toshiba Gigabea t F Series[...]

Chapter 10. Plugins 102 10.2.5 Fire Figure 10.28: Fire Fire is a demo displa ying a fire effect. Key Action Up / Do wn Increase / decrease num b er of flames Left T oggle flame t yp e Righ t T oggle moving flames P ow er Quit 10.2.6 Logo Demo sho wing the Ro c kb o x logo b ouncing around the screen. Key Action Righ t / Left Increase / decreas[...]

Chapter 10. Plugins 103 10.2.7 Mandelb rot Figure 10.29: Mandelbrot This demonstration dra ws fractal images from the Mandelbrot set . Key Action Direction k eys Mo ve about the image Select Zo om in Long Select Zo om out V olume down Decrease iteration depth (less detail) V olume up Increase iteration depth (more detail) A Reset and return to the [...]

Chapter 10. Plugins 104 10.2.8 Mosaique Figure 10.30: Mosaique This simple graphics demo dra ws a mosaic picture on the screen of the play er. Press P ow er to quit. The R ockbox manual Toshiba Gigabea t F Series[...]

Chapter 10. Plugins 105 10.2.9 Oscilloscop e Figure 10.31: Oscilloscop e This demo sho ws the shap e of the sound samples that mak e up the music being play ed. A t faster sp eed rates, the play er is less resp onsive to user input and m usic may start to skip. Keys Key Action Select T oggle filled / curv e / plot Do wn T oggle whether to scroll o[...]

Chapter 10. Plugins 106 10.2.10 Plasma Figure 10.32: Plasma Plasma is a demo displa ying a 80’s style retro plasma effect. Key Action Up / Do wn Adjust frequency Select Change colours P ow er Quit The R ockbox manual Toshiba Gigabea t F Series[...]

Chapter 10. Plugins 107 10.2.11 Sno w Figure 10.33: Ha ve y ou ever seen sno w falling? This demo replicates sno w falling on your screen. If you lo v e win ter, y ou will lov e this demo. Or ma yb e not. Press P ow er to quit. The R ockbox manual Toshiba Gigabea t F Series[...]

Chapter 10. Plugins 108 10.2.12 Sta rfield Figure 10.34: Starfield Starfield sim ulation (like the classic screensa ver). Key Action Righ t / Left Increase / decrease num b er of stars Up / Do wn Increase / decrease sp eed Select Change colours P ow er Quit The R ockbox manual Toshiba Gigabea t F Series[...]

Chapter 10. Plugins 109 10.2.13 VU meter Figure 10.35: VU-Meter This is a VU meter, whic h displays the v olume of the left and right audio c hannels. There are 3 t yp es of meter selectable. The analogue meter is a classic needle style. The digital meter is mo delled after LED v olume displa ys, and the mini-meter option allows for the displa y of[...]

Chapter 10. Plugins 110 10.3.1 Sho rtcuts The Shortcuts Plugin allo ws you to jump to places within the file bro wser without having to na vigate there manually . The plugin w orks with .link files. A .link file is just a text file with ev ery line containing the name of the file or the directory y ou wan t to quic kly jump to. All names shoul[...]

Chapter 10. Plugins 111 10.3.2 Chip-8 Emulato r Chip8 is a kind of assem bly language for a long-gone architecture. This plugin runs games written using the c hip8 instructions. T o start a game op en a .ch8 file in the File Bro wser There are lots of tin y Chip8 games (usually only ab out 256 b ytes to a couple of KB) whic h were made popular by [...]

Chapter 10. Plugins 112 10.3.3 JPEG view er Op en a JPEG file in the File Bro wser to view it. Note: When an audio file is pla ying the size of the image is limited as the deco ding b pro cess needs to share memory with audio trac ks. T o b e able to view a bigger file y ou ma y need to stop playbac k. Key Action Up / Do wn / Left / Righ t Mo ve[...]

Chapter 10. Plugins 113 Key Action Up / Do wn V olume up/ V olume down Righ t / Left Skip 3 seconds forward/ bac kward A P ause/Resume playbac k P ow er Stop pla yback and quit 10.3.5 MPEG Pla y er The Mp eg Pla y er is a video play er plugin capable of playing bac k MPEG-1 and MPEG-2 video streams with MPEG audio m ultiplexed into .mpg files. T o[...]

Chapter 10. Plugins 114 Main Men u Displa y Options Op ens ”Displa y Options” submen u - see b elow. Sta rt Menu (default: on) Enable/disable the start menu. Clea r all resumes: x Discard all x resume p oints. Quit mp egpla y er Exit the plugin. Displa y Options Menu Dithering (default: off ) Preven t banding effects in gradients b y blending[...]

Chapter 10. Plugins 115 10.3.7 Ro ckb oy Figure 10.36: Ro ckboy Ro c kb o y is a Nin tendo Game Boy and Game Bo y Color emulator for Rockbox based on the gn ub o y emulator. T o start a game open a ROM file sa ved as .gb or .gbc in the file bro wser. Default k eys Key Action Up / Do wn / Left / Righ t Direction k eys V olume up A button V olume d[...]

Chapter 10. Plugins 116 Save Game. . . Sa ves y our current state. Options. . . Max F rameskip. Change frameskip setting to impro ve speed. Sound. T oggle sound on or off. Stats. T oggle sho wing fps and current frameskip. Set Keys (BUGGY) Select this option to set a new keymapping. Screen Size. Chose whether the original asp ect ratio should b e [...]

Chapter 10. Plugins 117 The View er’s Menu Quit Exits the plugin. View er Options Enco ding sets the co depage in the text viewer. Av ailable settings: UTF-8 (Unico de), BIG5 (T raditional Chinese), KSX-1001 (Korean), GB- 2312 (Simple Chinese), SJIS (Japanese), CP1250 (Central European), ISO- 8859-2 (Latin Extended), ISO-8859-9 (T urkish), ISO-88[...]

Chapter 10. Plugins 118 Note: The text view er automatically sav es its settings and also stores the current posi- b tion in the view ed text files (up to the last 46 files). Compatibilit y • Curren tly messages are in English • Do es not currently support right-to-left languages. 10.3.11 VBRfix This function scans a VBR (V ariable Bitrate) [...]

Chapter 10. Plugins 119 .sna in the file bro wser. Note: As ZXBo x is a 48k emulator only loading of 48k z80 snapshots is p ossible. b Default k eys The em ulator is set up for 5 different buttons: Up, Down, Left, Righ t and Jump/Fire. Eac h one of these can b e mapp ed to one k ey of the Sp ectrum Keyb oard or they can b e used lik e a “Kempst[...]

Chapter 10. Plugins 120 V olume. Controls v olume of sound output. Predefined Keymap Select one of the predefined keymaps. F or example 2w90z means: map ZXBox’s Up to 2 , Do wn to w , Left to 9 , Righ t to 0 and Jump/Fire to z . This example k eymap is used in the “Chuc kie Egg” game. Custom Keymap This menu allo ws y ou to map one of the S[...]

Chapter 10. Plugins 121 lost. Benchmarks can be resumed if you acciden tally load a plugin, or turn off your pla yer, as long as the log file /battery bench.txt is not deleted. Info rmation explained On the top of the file y ou will see v arious info on how to use the plugin. Time This column rep orts the total time of op eration of the play er.[...]

Chapter 10. Plugins 122 10.4.2 Calculato r Figure 10.38: Calculator This is a simple scien tific calculator for use on the play er. It works lik e a standard calculator. Pressing the “1st” and “2nd” buttons will toggle b etw een other av ailable math functions. Key Action Left / Righ t / Up / Do wn Mo ve around the k eypad Select Select a [...]

Chapter 10. Plugins 123 This is a small and simple calendar application with memo sa ving function. Dots indicate dates with memos. The av ailable memo types are: one off, yearly , monthly , and w eekly memos. Key Action Left / Righ t / Up / Do wn Mo ve the selector Select Sho w memos for the selected day V olume up / V olume down Previous / Next [...]

Chapter 10. Plugins 124 Setup Key Action Righ t / Left Increase / decrease display ed V alue Select Mo ve to next screen P ow er Mo ve to previous screen • First en ter the num b er of play ers (1–10) • Then set the total game time in mm:ss • Then the maxim um round time is entered. F or example, this could b e used to play Scrabble for a m[...]

Chapter 10. Plugins 125 10.4.5 Clo ck Figure 10.41: Clo ck This is a fully featured analogue and digital clo ck plugin. Key configuration Key Action Left / Righ t Cycle through mo des Up / Do wn Cycle through skins Men u Main Menu Select Start / Stop Coun ter Long Select Reset Coun ter P ow er Sa ve Settings (if enabled) and Exit Clo c k Men u Vie[...]

Chapter 10. Plugins 126 Mo de Settings Op ens a menu from whic h you can adjust settings pertaining to the curren t clo c k mo de (analog, digital, binary). General Settings Reset Settings Reset all settings to their default v alues. Save Settings Sav e all settings to disk. Sho w Counter T oggle Coun ter display . Save Cho ose whether to disable a[...]

Chapter 10. Plugins 127 F ullscreen A F ullscreen clo ck is displa y ed. Show Border, if enabled, will dra w a small b ox at ev ery hour p osition (1 through 12). Inv ert Seconds, if enabled, will in vert the LCD as the seconds pass. Second Hand, if enabled, will draw a second hand among the hour and min ute hands. Bina ry mo de This mo de sho ws a[...]

Chapter 10. Plugins 128 10.4.7 Keyb o x Keyb o x is an encrypted passw ord storage using the “Tiny Encryption Algorithm” with a k ey derived using md5. Using Keyb o x T o get started, start up the plugin and select Enter Keybox . The first time you en ter Keyb o x y ou will b e prompted for a master password and for confirmation of the master[...]

Chapter 10. Plugins 129 Key Action P ow er Exit plugin A Start / Stop Select T ap temp o Left / Righ t Adjust temp o Up / Do wn Adjust volume 10.4.11 Random F older Advance Configuration This plugin is used to configure the folders whic h will b e considered when the Auto- Change Directory feature is set to Random . Menu Generate F older List Gen[...]

Chapter 10. Plugins 130 10.4.12 Stats Figure 10.42: The stats-plugin The stats-plugin simply coun ts the num b er of files, m usic files and directories on your pla yer. Press P ow er to ab ort counting and exit the plugin. Press it again to quit after coun ting has finished. The R ockbox manual Toshiba Gigabea t F Series[...]

Chapter 10. Plugins 131 10.4.13 Stop watch Figure 10.43: Stop watc h A simple stop watc h program with supp ort for saving times. Key Action P ow er Quit Plugin Select Start / stop A Reset timer (only when timer is stopp ed) Men u T ake lap time Up / Do wn Scroll through lap times 10.4.14 T ext Edito r This plugin allo ws you to view and edit simpl[...]

Chapter 10. Plugins 132 • Mo ve the selection bar to the line y ou wan t to edit. • Edit the highligh ted text line or insert a new one using the Item Men u. • When finished editing exit the T ext Editor. Y ou’ll b e shown a list of sa v e options. Note: When y ou hav e not changed the file the T ext Editor will quit immediately . b Key A[...]

Chapter 11. Adv anced Topics 133 11 Advanced T opics 11.1 Customising the User Interface 11.1.1 Getting Extras Ro c kb o x supp orts custom fon ts. A collection of fon ts is av ailable for download in the fon t pack age at http://www.rockb ox.o rg/daily .shtml . 11.1.2 Loading F onts Ro c kb o x can load fonts dynamically . Simply copy the .fnt fi[...]

Chapter 11. Adv anced Topics 134 11.1.5 Changing Filet yp e Colours Ro c kb o x has the capabilit y to mo dify the File Bro wser to show differen t filetypes in differen t colours dep ending up on the file extension. See the Z CustomFiletypeColours Wiki page for details. 11.1.6 Loading Backdrops Ro c kb o x supp orts sho wing an image as a back[...]

Chapter 11. Adv anced Topics 135 • Lines b eginning with # are comments and will be ignored. • Maxim um file size used is 1600 b ytes. If y ou hav e a bigger WPS file, only the first part of it will b e loaded and used. Note: Keep in mind that y our play er resolution is 240x320x16 (with the last num b er b giving the colour depth in bits) w[...]

Chapter 11. Adv anced Topics 136 Items on a line are brok en into sublines with the semicolon ’ ; ’ c haracter. The display time for eac h subline defaults to 2 seconds unless mo dified b y using the ’ %t ’ tag to sp ecify an alternate time (in seconds and optional ten ths of a second) for the subline to b e displa y ed. Subline related sp[...]

Chapter 11. Adv anced Topics 137 Using Images Y ou can ha ve as man y as 52 images in your WPS. There are v arious wa ys of displaying images: 1. Load and alwa ys sho w the image, using the %x tag 2. Preload the image with %xl and show it with %xd . This wa y you can ha ve y our images displa yed conditionally . 3. Load an image and show as bac kdr[...]

Chapter 11. Adv anced Topics 138 while pla ying your juk eb ox in y our car, and a headphones.cfg file to store the settings that y ou use while listening to your pla yer through headphones. See section 11.3.2 (page 138 ) b elo w for an explanation of the format for configuration files. See section 11.3.3 (page 139 ) for an explanation of how to[...]

Chapter 11. Adv anced Topics 139 11.3.3 The Manage Settings menu The Manage Settings menu can be found in the Main Menu . The Mana ge Set- tings men u allows y ou to sav e and load .cfg files. Bro wse .cfg Files Op ens the file bro wser in the /.rockbox directory and displays all .cfg (configuration) files. Selecting a .cfg file will cause Ro [...]

Appendix A. File forma ts 140 A File fo rmats A.1 Supp o rted file fo rmats Icon File Type Extension Action when selected Directory none The bro wser enters that directory Audio file various (se e se ction A.2 (p age 141 ) ) Ro c kb o x takes y ou to the WPS and starts pla ying the file Cuesheet .cue View a cuesheet file Pla ylist .m3u, .m3u8 R[...]

Appendix A. File forma ts 141 A.2 Supp o rted audio fo rmats F ormat Extension Notes L ossy c o de cs MPEG audio .mp1, .mpa, .mp2, .mp3 OGG/V orbis .ogg, .oga Some old “flo or 0” files ma y crash Ro c kb o x. Musepac k .mpc Adv anced Audio Coding .m4a, .m4b, .mp4 Windo ws Media Audio .wma, .wmv, .asf A TSC A/52 .a52, .ac3 Supp orts do wnmixin[...]

Appendix B. WPS T ags 142 B WPS T ags B.1 Status Ba r T ag Description %we Status Bar Enabled %wd Status Bar Disabled These tags o verride the pla yer setting for the displa y of the status bar. They m ust b e noted on their o wn line. B.2 ID3 Info T ag Description %ia ID3 Artist %ic ID3 Comp oser %id ID3 Album Name %ig ID3 Genre Name %in ID3 T rac[...]

Appendix B. WPS T ags 143 B.3 P ow er Related Information T ag Description %bl Sho w numeric battery lev el in p ercent. Can also b e used in a conditional: %?bl < -1 | 0 | 1 | 2 | ... | N > Where the -1 v alue is used when the battery lev el isn’t known (it usually is). %bv Sho w the battery level in v olts %bt Sho w estimated battery time[...]

Appendix B. WPS T ags 144 B.5 Pla ylist/Song Info T ag Description %pb Progress Bar This will replace the en tire line with a progress bar. Y ou can set the heigh t, p osition and width of the progressbar (in pixels): %pb | height | leftpos | rightpos | toppos | %px P ercentage Pla yed In Song %pc Curren t Time In Song %pe T otal Num b er of Pla yl[...]

Appendix B. WPS T ags 145 B.8 Virtual LED T ag Description %lh “h” if the hard disk is accessed B.9 Rep eat Mo de T ag Description %mm Rep eat mo de, 0-4, in the order: Off, All, One, Shuffle Example: %?mm < Off | All | One | Shuffle | A-B > B.10 Pla yback Mo de T ags T ag Description %mp Pla y status, 0-4, in the order: Stop, Pla y , Pa[...]

Appendix B. WPS T ags 146 The example ab o v e will display the text “V olume c hanging” if the volume is being c hanged and 2.5 secs after the volume button has been released. After that, it will displa y the volume v alue. B.12 Settings T ag Description %St | <setting name> | Displa y the v alue of any Rockbox setting Example: Can b e u[...]

Appendix B. WPS T ags 147 B.13 Images T ag Descri ption %X | filename.bmp | Load and set a bac kdrop image for the WPS. This image m ust b e exactly the same size as y our LC D. %P | filename.bmp | Load a Progress bar image for the WPS. Use %pb tag to sho w the progress bar %x | n | filename | x | y | Load and displa y an image n : image ID (a-z an[...]

Appendix B. WPS T ags 148 • The images m ust b e in a ro ckbox compatible format (1 bit per pixel BMP) • The image tag m ust b e on its o wn line • The ID is case sensitiv e, giving 52 different ID’s • The size of the LCD screen for eac h play er v aries. See table b elow for appropriate sizes of eac h device. The x and y co ordinates m [...]

Appendix B. WPS T ags 149 B.16 Real Time Clo ck T ag Description %cd Da y of month %ce Zero padded da y of month %cH Zero padded hour from 00 to 24 %ck Hour from 0 to 24 %cI Zero padded hour from 12 to 12 %cl Hour from 12 to 12 %cm Mon th %cM Min utes %cS Seconds %cy 2-digit y ear %cY 4-digit y ear %cP Capital AM/PM %cp Lo wercase am/pm %ca W eekda[...]

Appendix C. Config file options 150 C Config file options Setting Allo wed V alues Unit v olume dB bass dB treble dB balance -100 to +100 % c hannels stereo, mono, custom, mono left, mono righ t, k araoke N/A stereo width 0 to 250 % sh uffle on, off N/A rep eat off, all, one, sh uffle, ab N/A pla y selected on, off N/A part y mo de on, off N/[...]

Appendix C. Config file options 151 Setting Allo wed V alues Unit con trast 0 to 63 N/A bac klight timeout off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45, 60, 90, 120 seconds bac klight timeout plugged off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45, 60, 90, 120 seconds bac klight filters first k eypress on, off N/A bac [...]

Appendix C. Config file options 152 Setting Allo wed V alues Unit skip length trac k, 1, 2, 3, 4, 5, 10, 15 min utes start in screen previous, ro ot, files, db, wps, men u, b o okmarks N/A pla ylist catalog directory /path/to/dir N/A repla ygain on, off N/A repla ygain type trac k, album, track sh uffle N/A repla ygain no clip on, off N/A repla [...]

Appendix C. Config file options 153 Setting Allo wed V alues Unit p eak meter release 1 to 126 ? p eak meter hold off, 200ms, 300ms, 500ms, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 1min N/A p eak meter clip hold on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45, 60, 90, 2min, 3min, 5min, 10min, 20min, 45min, 90min N/A p eak meter busy on, o?[...]

Appendix D. User feedback 154 D User feedback D.1 Bug rep orts If y ou exp erience inappropriate p erformance from any supported feature, please file a bug rep ort on our w eb page. Do not rep ort missing features as bugs, instead file them as feature ideas (see b elow). F or op en bug rep orts refer to http://www.ro ckb ox.o rg/tracker/index.php[...]

Appendix D. User feedback 155 D.2.2 F eatures w e will not implement This is a list of F eature Requests w e get rep eatedly that w e simply cannot do. View it as the opp osite of a TODO! • In terfacing with other USB devices (like cameras) or 2 pla yer games o ver USB The USB system demands that there is a master that talks to a slav e. The pla [...]

Appendix E. Changelog 156 E Changelog E.1 What is new since v3.0? E.1.1 New features ? 2008-12-09: Album Art resizing. ? 2008-12-09: FM radio supp ort on Gigab eat S. ? 2008-11-26: Softw are controlled bac kligh t fading for targets without hardware fad- ing (e200v1, c200v1, X5, Co won D2 and H300) E.1.2 Enhancements ? 2008-12-01: Several new tags [...]

Appendix E. Changelog 157 ? 2007-07-27: Sound on iPod 2nd Gen ? 2007-07-25: Jackpot supp ort for bitmap targets ? 2007-06-30: Reversi game ? 2007-06-29: Ro cklife plugin ? 2007-06-28: Maze game ? 2007-06-17: Custom filetype colour feature introduced ? 2007-05-23: The 80GB Ip o d Video is now supported by Rockbox ? 2007-04-09: W A V file view er ?[...]

Appendix E. Changelog 158 ? 2006-02-22: ”Chessb ox” c hess game plugin ? 2006-02-13: iPod 5G audio playbac k ? 2006-01-28: Color bitmap supp ort in the WPS (for color mo dels) ? 2006-01-23: Brickmania game plugin ? 2005-12-06: Unico de supp ort ? 2005-11-05: Jewels game plugin - a Bejew eled clone. E.2.2 Enhancements ? 2008-08-06: Redesigned re[...]

Appendix E. Changelog 159 ? AIFF ? FLA C ? ALA C ? W a vpack ? Shorten ? Monk ey’s Audio Other co decs ? SID ? MOD ? NSF, NSFE ? SPC ? MIDI ? SAP The R ockbox manual Toshiba Gigabea t F Series[...]

Appendix F. Credits 160 F Credits P eople that hav e contributed to the pro ject, one wa y or another. F riends! · Bj ¨ orn Stenberg · Linus Nielsen Fel tz- ing · Andy Choi · Andrew Jamieson · P aul Suade · Jo achim Schiffer · D aniel Stenberg · Alan Korr · Gar y Czvitko vicz · Stuar t Mar tin · Fe- lix Arends · Ulf Ralberg · D a vid [...]

Appendix F. Credits 161 Hand · Nick Lanham · Sebastian Hen- riksen · Mar tin Scarra tt · Karl Kurbjun · Tomasz Malesinski · An- drew Pilley · Ma tt v.d. Westhuizen · Tim Crist · Jvo Studer · D an Ever- ton · Imre Herceg · Seven Le Mesle · Craig Bachelor · Nik olaj Chris- tensen · Mikael Magnusson · Dominik Wenger · Henrico Witvliet[...]

Appendix F. Credits 162 · Step an Moskov chenko · John S. Gwynne · Brian J. Morey · Stijn Hisken · Ber trik Sikken · Karim Boucher · James Espinoza · Franz R ¨ uhmland · Jordan Anderson · Ma urus Cuele- naere · Chris Allegrett a · Alast air S · Mar tin Crkovsk ´ y · Ariy a Hida y a t · Jonas Hurrelmann · Lee Kang Hyuk · Clemens W[...]

Appendix G. Licenses 163 G Licenses G.1 GNU F ree Do cumentation License V ersion 1.2, No vem b er 2002 Cop yright c  2000,2001,2002 F ree Soft ware F oundation, Inc. 51 F ranklin St, Fifth Flo or, Boston, MA 02110-1301 USA Ev eryone is permitted to copy and distribute v erbatim copies of this license do cument, but c hanging it is not allow ed.[...]

Appendix G. Licenses 164 A ”Mo dified V ersion” of the Document means an y work con taining the Do cument or a p ortion of it, either copied verbatim, or with modifications and/or translated into another language. A ”Secondary Section” is a named app endix or a front-matter section of the Doc- umen t that deals exclusively with the relati[...]

Appendix G. Licenses 165 A section ”En titled XYZ” means a named subunit of the Do cument whose title ei- ther is precisely XYZ or con tains XYZ in parentheses follo wing text that translates XYZ in another language. (Here XYZ stands for a sp ecific section name mentioned below, suc h as ”Ackno wledgemen ts” , ”Dedications” , ”Endors[...]

Appendix G. Licenses 166 y ou use the latter option, y ou must tak e reasonably prudent steps, when you begin distribution of Opaque copies in quan tity , to ensure that this T ransparent cop y will remain th us accessible at the stated lo cation until at least one y ear after the last time y ou distribute an Opaque copy (directly or through y our [...]

Appendix G. Licenses 167 create one stating the title, year, authors, and publisher of the Document as giv en on its Title P age, then add an item describing the Mo dified V ersion as stated in the previous sen tence. J. Preserve the net w ork lo cation, if any , given in the Document for public access to a T ransparen t copy of the Document, and [...]

Appendix G. Licenses 168 5. COMBINING DOCUMENTS Y ou ma y combine the Document with other docume n ts released under this License, under the terms defined in section 4 ab o ve for modified versions, provided that y ou include in the com bination all of the Inv arian t Sections of all of the original do cuments, unmo dified, and list them all as [...]

Appendix G. Licenses 169 8. TRANSLA TION T ranslation is considered a kind of mo dification, so you ma y distribute translations of the Do cumen t under the terms of section 4. Replacing Inv ariant Sections with translations requires sp ecial p ermission from their copyrigh t holders, but you ma y include translations of some or all In v ariant Se[...]

Appendix G. Licenses 170 Cop yright c  YEAR YOUR NAME. P ermission is granted to cop y , distribute and/or mo dify this do cument under the terms of the GNU F ree Do cumenta- tion License, V ersion 1.2 or any later v ersion published b y the F ree Softw are F oundation; with no Inv ariant Sections, no F ron t-Cov er T exts, and no Back- Co ver T[...]

Appendix G. Licenses 171 G.2 The GNU General Public License V ersion 2, June 1991 Cop yright c  1989, 1991 F ree Soft ware F oundation, Inc. 51 F ranklin Street, Fifth Flo or, Boston, MA 02110-1301, USA Ev eryone is permitted to copy and distribute v erbatim copies of this license do cument, but c hanging it is not allow ed. Preamble The license[...]

Appendix G. Licenses 172 Terms and Conditions F or Copying, Distribution and Modifica tion 0. This License applies to any program or other w ork whic h contains a notice placed b y the copyrigh t holder saying it ma y b e distributed under the terms of this General Public License. The “Program”, b elow, refers to an y suc h program or work, and[...]

Appendix G. Licenses 173 suc h an announcement, your w ork based on the Program is not required to prin t an announcement.) These requiremen ts apply to the mo dified work as a whole. If identifiable sections of that w ork are not derived from the Program, and can be reasonably considered indep enden t and separate w orks in themselves, then this[...]

Appendix G. Licenses 174 the same place coun ts as distribution of the source co de, even though third parties are not comp elled to copy the source along with the ob ject co de. 4. Y ou may not cop y , mo dify , sublicense, or distribute the Program except as ex- pressly pro vided under this License. An y attempt otherwise to copy , mo dify , sub-[...]

Appendix G. Licenses 175 decide if he or she is willing to distribute soft ware through an y other system and a licensee cannot imp ose that choice. This section is in tended to make thoroughly clear what is believed to be a conse- quence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countrie[...]

Appendix G. Licenses 176 you for d amages, including any general, special, incident al or con- sequential dama ges arising out of the use or inability to use the program (including but not limited to loss of d a t a or da t a being rendered inaccura te or losses sust ained by you or third p ar ties or a f ailure of the pr ogram to opera te with any[...]

Appendix G. Licenses 177 The h yp othetical commands show w and show c should show the appropriate parts of the General Public License. Of course, the commands y ou use may be called some- thing other than show w and show c ; they could even be mouse-clicks or men u items— whatev er suits your program. Y ou should also get y our employ er (if you[...]