Toshiba 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 orw ard/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 P ow er Related Information .......................... 1 4 3 B.4 File Info ..................................... 1 4 3 B.5 Pla ylist/Song Info ............................... 1 4 4 B.6 Run time Database .................[...]

Chapter 1. Introduction 9 1 Intro duction 1.1 W elcome This is the man ual for Ro ckbox. Ro ckbox is an open source firmw are replacemen t for a gro wing num b er of digital audio play ers. Rockbox aims to be considerably more functional and efficien t than your device’s stock firm w are while remaining easy to use and customisable. Ro ckbox is[...]

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 IRC logs can be found at http://www.ro ckb o x.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 manual 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 may 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 soft ware migh t b e necessary . USB connection. T o transfe[...]

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 ckboxUtilit y wiki page. W arning: When first starting R ockbox Utility run “Auto detect”, found in the con- ! figuration dialog (File → Configure). Auto detectio[...]

Chapter 2. Inst alla tion 14 Installing the firmw are 1. Do wnload your c hosen version of Rockbox from the links in the previous section. 2. Connect y our pla yer to the computer via USB as describ ed in the manual that came with y our play er. 3. T ak e the .zip file that y ou downloaded and use the “Extract all” command of y our unzip prog[...]

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 ov er your curren t build. Note: If y ou use Ro ckbox Utilit y b e 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 automatic[...]

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 play er are lab elled 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 p erformed on that button. The buttons are descri[...]

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 ro ck er v olume switc h wit[...]

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 pretty in tuitiv e. I[...]

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

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 you bro wse your m usic in either of tw o w ays. The File Bro wser 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 you 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 op erations on files or directories. T o access the Context Menu , p osition the selector ov er 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 fil[...]

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 b e 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 Br[...]

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 kept on disk (to sa ve memory),[...]

Chapter 4. Bro wsing and pla ying 27 Imp o rt Mo difications. Allo ws the /.rockbox/database changelog.txt backup to be con venien tly loaded into the database. If A uto 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, y ou can bro wse your m u[...]

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 numeric id tag trac knum n umeric id t[...]

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 “(a vg)” • Elapsed and total time. • A slidebar progress meter represen ting where in the song y ou are. • P eak meter. See section 11.2 (page 134 ) for details of customising y our WPS (While Playin[...]

Chapter 4. Bro wsing and pla ying 30 The ba r: This is the wide horizontal bar. It represen ts the curren t volume v alue. The p eak indicato r: This is a little v ertical line at the righ t end of the bar. It indicates the p eak v olume v alue that occurred recently . The clip indicato r: This is a little black block that is displa yed at the v er[...]

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 c kb o x always considers the song that it is pla ying to b e part of a pla ylist, and in some situations, Ro c kb ox will create a pla ylist automatically . F or example, if you are pla ying the con tents of a[...]

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 ve y et b een added via an Inser t , new trac ks will b e added immediately after the curren t playing trac k. If playbac k is stopp ed a new dynamic pla ylist will get create d with the selected tra[...]

Chapter 4. Bro wsing and pla ying 36 Moving and removing tracks T o mo v e or remov e a track from the curren t playlist en ter 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 whic h all of the Ro c kb o x functions can b e 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.[...]

Chapter 5. The Main Menu 38 5.2 Navigating the Main Menu 5.3 Recent Bo okma rks 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 y ou 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 con?[...]

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 y our pla yer w orks. There are many submen us for different parameter areas. Ev ery 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[...]

Chapter 5. The Main Menu 40 Create Pla ylist: Ro ckbox will create a pla ylist with all tracks in the curren t directory and all sub-directories. The playlist will be created one directory level “up” from where y ou currently are. View Current Pla ylist: Displays the con tents of the pla ylist currently stored in memory . Save Current Pla ylist[...]

Chapter 5. The Main Menu 41 5.11 Quick Screen Whilst not strictly part of the Main Menu , it is worth notin g 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 progressiv ely 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 too high output level. 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 par[...]

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 c hosen. Graphic equalizers in home stereos are usually p eaking filters. The p eaking filters in Ro ckbox’s EQ lets y ou adjust three different parameters for EQ bands 1 through 3. The “center?[...]

Chapter 6. Sound Settings 47 Advanced EQ: This sub men u provides 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 in terface. Save EQ Preset: This option sa v es the current EQ configuration in a .cfg file. Bro wse EQ Pres[...]

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

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 pla yback while sh uffle mo de 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 [...]

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 trac k skip only , trac ks will only crossfade when y ou manually c hange[...]

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 repla ygain 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 eha vior. 7.12 P ause on Headphone Unplug Enables and disables automat[...]

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 giv en num b er of minutes instead of skipping to a new trac k. Note: T o skip trac ks with this[...]

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, follo w ed by all files that begin 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 so[...]

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 horizon tal 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 n umber of pixels the text should mov e for each step,[...]

Chapter 8. General Settings 58 Clip Hold Time: The n um 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 et w 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 you 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 (curren tly 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 inform[...]

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 c ursor. In order for this to w ork, 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 c kb o x b y default. The voice file is [...]

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), v oicing uses the metho d set under V oice Filenames ab o v e. Sa y File T yp [...]

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 c kb o x. Bro wse Themes. This option will display all the curren tly 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, st[...]

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 elemen ts in Ro ckbox. Line Selecto r Colours. These options sets the colours for the line selector bars. Prima ry Colour: Set the primary colour used for the [...]

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 hav e exclusive con trol o ver the user in terface. This means y ou cannot switc h back and forth b et ween a plugin and Rockbox. When a plugin is loaded, you need to exit it to return to the Ro c kb o x in ter[...]

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 o ver 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 eac h time it hits. B Ball Immediately fires another ball. FL Flip Flip left / r[...]

Chapter 10. Plugins 70 10.1.3 Bubbles Figure 10.3: Bubbles The goal of the game is to b eat eac h lev el as quickly as possible by clearing the board of all bubbles. Bubbles are remov ed from the b oard when a cluster of three of more of the same t yp e is formed. The game is o v er when any bubbles on the b oard extend b elo w the b ottom line. T [...]

Chapter 10. Plugins 71 10.1.4 Chessb o x Figure 10.4: Chessb o x 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 b y 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 an y file with .pgn extension in the ?[...]

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 y ou need .wad game files lo cated in /.rockbox/doom/ on your pla yer. Create the directory and sa v e the follo wing files there: ro ckdo om.wad. The Rockbox .wad , based on prboom.wad from prbo om-2.2.6 Y our wad files. C[...]

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 pla y on game start Options. [...]

Chapter 10. Plugins 75 Keys Key Action Up Mo ve F orward 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 t[...]

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 o x T o b eat eac h 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 [...]

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 c kblo 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 cks of differen t shap es form full rows. 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 bric k! Key Action Select Mo ve do wn faster P ow er Quit 10.1.18 Sliding Puzzle Figu[...]

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 gro w y our snake as large as possible by eating the dots that app ear on the screen. The game will end w[...]

Chapter 10. Plugins 87 10.1.20 Snak e 2 Figure 10.17: Snak e 2 – The Snak e Strikes Bac k 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 snak e gets longer. The game ends when the snak e hits a w all, or runs into itself. Key Action In men u Up / Do wn S[...]

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 c kb o x can act as b oth a plugin and a view er. When starting Sudoku [...]

Chapter 10. Plugins 94 Y ou can create and sa ve y our own grids under the New men u option. En ter the menu (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 pap er most p eople lik e to mark num b ers i[...]

Chapter 10. Plugins 95 10.1.26 W ormlet Figure 10.23: W ormlet game W ormlet is a m ulti-w orm game on a multi-threaded m ulti-functional Ro ckbox console. Y ou na vigate a h ungry little worm. Help y our w orm to find fo o d and to av oid p oisoned argh-tiles. The goal is to turn your tin y worm in to a big w orm for as long as p ossible. Men u c[...]

Chapter 10. Plugins 96 The game Use the con trol keys of y our w orm 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 your w orm 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 hollo w pi[...]

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

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 a y of enemy balls because, if they hit you or y our trail, y ou lose a l[...]

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 c k 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 / R[...]

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 c kb o x main men u. Exit at any time b y pressing Left or P ow er . 10.2.3 Cub e Figur[...]

Chapter 10. Plugins 101 10.2.4 Demystify Figure 10.27: Dem ystify Dem ystify is a screen sa ver lik e 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 bouncing around the screen. Key Action Righ t / Left Increase / decrease[...]

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 m usic b eing pla yed. 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[...]

Chapter 10. Plugins 106 10.2.10 Plasma Figure 10.32: Plasma Plasma is a demo displa ying a 80’s st yle 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 y our screen. If you lo ve win ter, you will lo v 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 allo ws for the displa y o[...]

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 works 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 should[...]

Chapter 10. Plugins 111 10.3.2 Chip-8 Emulato r Chip8 is a kind of assem bly language for a long-gone arc hitecture. 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 bytes 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 pla yback. 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 ybac k 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 in to .mpg files. T[...]

Chapter 10. Plugins 114 Main Men u Displa y Options Op ens ”Display Options” submen u - see b elow. Sta rt Menu (default: on) Enable/disable the start men u. 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 ) Prev ent banding effects in gradien ts by blending[...]

Chapter 10. Plugins 115 10.3.7 Ro ckb oy Figure 10.36: Ro c kb o y 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 op en a R OM file sav ed 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 ol[...]

Chapter 10. Plugins 116 Save Game. . . Sa ves y our current state. Options. . . Max F rameskip. Change frameskip setting to improv e sp eed. 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 keymapp ing. Screen Size. Chose whether the original asp ect ratio should b [...]

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 view er. 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-8[...]

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 curren tly supp ort righ t-to-left languages. 10.3.11 VBRfix This function scans a VBR (V ariable Bitrat[...]

Chapter 10. Plugins 119 .sna in the file bro wser. Note: As ZXBo x is a 48k em ulator only loading of 48k z80 snapshots is p ossible. b Default k eys The em ulator is set up for 5 different buttons: Up, Do wn, Left, Right 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 “Kemps[...]

Chapter 10. Plugins 120 V olume. Controls v olume of sound output. Predefined Keymap Select one of the predefined k eymaps. F or example 2w90z means: map ZXBo x’s Up to 2 , Do wn to w , Left to 9 , Right to 0 and Jump/Fire to z . This example k eymap is used in the “Ch uckie Egg” game. Custom Keymap This men u allows y ou to map one of the [...]

Chapter 10. Plugins 121 lost. Benchmarks can be resumed if you acciden tally load a plugin, or turn off y our 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 ho w to use the plugin. Time This column rep orts the total time of op eration of the play e[...]

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 w orks lik e a standard calculator. Pressing the “1st” and “2nd” buttons will toggle betw 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 t yp es are: one off, y early , monthly , and weekly memos. Key Action Left / Righ t / Up / Do wn Mo ve the selector Select Sho w memos for the selected da y V olume up / V olume down Previous / Ne[...]

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 v e 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 [...]

Chapter 10. Plugins 125 10.4.5 Clo ck Figure 10.41: Clo c k This is a fully featured analogue and digital clo c k 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 v e Settings (if enabled) and Exit Clo c k Men u [...]

Chapter 10. Plugins 126 Mo de Settings Op ens a menu from whic h y ou can adjust settings p ertaining 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 Sa ve all settings to disk. Sho w Counter T oggle Counter displa y . Save Cho ose whether to disable[...]

Chapter 10. Plugins 127 F ullscreen A F ullscreen clo c k is displa yed. Show Border, if enabled, will dra w a small b o x at every hour p osition (1 through 12). Inv ert Seconds, if enabled, will inv ert 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 Po w 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 ve options. Note: When y ou hav e not changed the file the T ext Editor will quit immediately . b Key Ac[...]

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 Browser to sho w different filet yp es in differen t colours dep ending up on the file extension. See the Z CustomFilet yp eColours Wiki page for details. 11.1.6 Loading Backdrops Ro c kb o x supp orts sho wing an image as a b[...]

Chapter 11. Adv anced Topics 135 • Lines b eginning with # are commen ts and will b e ignored. • Maxim um file size used is 1600 b ytes. If y ou ha ve 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)[...]

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 modified by 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 e[...]

Chapter 11. Adv anced Topics 137 Using Images Y ou can ha v e as many as 52 images in y our WPS. There are v arious wa ys of displa ying images: 1. Load and alw a ys show the image, using the %x tag 2. Preload the image with %xl and sho w it with %xd . This w ay y ou can hav e y our images displa yed conditionally . 3. Load an image and sho w as ba[...]

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 liste ning to y our play er 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 [...]

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 Manage 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 c[...]

Appendix A. File forma ts 140 A File fo rmats A.1 Supp o rted file formats 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 Ro[...]

Appendix A. File forma ts 141 A.2 Supp o rted audio formats 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 wnmixing[...]

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 o w 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 tim[...]

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, Play , Pau[...]

Appendix B. WPS T ags 146 The example ab o v e will display the text “V olume changing” if the v olume is b eing 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 [...]

Appendix B. WPS T ags 147 B.13 Images T ag Description %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 LCD. %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 and [...]

Appendix B. WPS T ags 148 • The images m ust b e in a ro c kb o x compatible format (1 bit p er pixel BMP) • The image tag m ust be on its own line • The ID is case sensitiv e, giving 52 differen t ID’s • The size of the LCD screen for eac h pla yer v aries. See table below for appropriate sizes of eac h device. The x and y coordinates 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 o rts If y ou e xp erience inappropriate p erformance from an y supp orted 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 elo w). F or op en bug rep orts refer to http://www.ro ckb ox.o rg/track er/ind[...]

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 (lik e cameras) or 2 play er games ov er 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 con trolled 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 vpac k ? 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 K orr · 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 Mosk ov 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 Crk ovsk ´ y · Ariy a Hid a y a t · Jonas Hurrelmann · Lee Kang Hyuk · Clemen[...]

Appendix G. Licenses 163 G Licenses G.1 GNU F ree Do cumentation License V ersion 1.2, No v ember 2002 Cop yright c  2000,2001,2002 F ree Soft w are F oundation, Inc. 51 F ranklin St, Fifth Flo or, Boston, MA 02110-1301 USA Ev eryone is permitted to c op y and distribute verbatim copies of this license document, but c hanging it is not allo wed.[...]

Appendix G. Licenses 164 A ”Mo dified V ersion” of the Do cument 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 relat[...]

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 men tioned b elow, suc h as ”Ackno wledgemen ts” , ”Dedications” , ”Endo[...]

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. Preserv e the netw ork lo cation, if any , given in the Document for public access to a T ransparen t cop y of the Do cumen t, a[...]

Appendix G. Licenses 168 5. COMBINING DOCUMENTS Y ou ma y com bine the Do cumen t with other do cumen ts released under this License, under the terms defined in section 4 ab o ve for modified versions, pro vided that you include in the com bination all of the Inv ariant Sections of all of the original documents, 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 cop yrigh t holders, but you ma y include translations of some or all In v ariant S[...]

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

Appendix G. Licenses 171 G.2 The GNU General Public License V ersion 2, June 1991 Cop yright c  1989, 1991 F ree Soft w are F oundation, Inc. 51 F ranklin Street, Fifth Flo or, Boston, MA 02110-1301, USA Ev eryone is permitted to c op y and distribute verbatim copies of this license document, but c hanging it is not allo wed. Preamble The licens[...]

Appendix G. Licenses 172 Terms and Conditions F or Copying, Distribution and Modifica tion 0. This License applies to an y program or other work 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 elo w, refers to an y suc h program or w ork, a[...]

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 b e reasonably considered indep enden t and separate w orks in themselves, then thi[...]

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 cop y the source along with the ob ject co de. 4. Y ou ma y not cop y , mo dify , sublicense, or distribute the Program except as ex- pressly pro vided under this License. An y attempt otherwise to cop y , mo dify , s[...]

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 c hoice. 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 countri[...]

Appendix G. Licenses 176 you f or dama ges, 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 da t a or d a t a being rendered inaccura te or losses sust ained by you or third p ar ties or a f ailure of the program 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 emplo yer (if y o[...]