background image

Appendix E. Config file options

229

Setting

Allowed Values

Unit

bidir limit

0 to 200

% screen

scroll paginated

on, off

N/A

hold_lr_for_scroll_in_list on, off

N/A

show path in browser

off, current directory, full path

N/A

contrast

0 to 63

N/A

backlight timeout

off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10,
15, 20, 25, 30, 45, 60, 90, 120

s

backlight timeout plugged

off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10,
15, 20, 25, 30, 45, 60, 90, 120

s

backlight filters first
keypress

on, off

N/A

backlight on button hold

normal, off, on

N/A

caption backlight

on, off

N/A

brightness

devise a way to get ranges
from config-*.h

N/A

disk spindown

3 to 254

s

battery capacity

devise a way to get ranges
from config-*.h

mAh

car adapter mode

on, off

N/A

qs top

any setting name, - for none

N/A

qs bottom

any setting name, - for none

N/A

qs left

any setting name, - for none

N/A

qs right

any setting name, - for none

N/A

shortcuts instead of
quickscreen

off, on

N/A

idle poweroff

off, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15,
30, 45, 60

min

sleeptimer duration

5 to 300 (in steps of 5)

min

sleeptimer on startup

off, on

N/A

keypress restarts
sleeptimer

off, on

N/A

max files in playlist

1000 - 32000

N/A

max files in dir

50 - 10000

N/A

lang

/path/filename.lng

N/A

wps

/path/filename.wps

N/A

autocreate bookmarks

off, on

N/A

autoload bookmarks

off, on

N/A

use
most-recent-bookmarks

off, on

N/A

pause on headphone
unplug

off, pause, pause and resume

N/A

rewind duration on pause

0 to 15

s

The Rockbox manual

(version 3.14)

Toshiba Gigabeat F and X Series

Summary of Contents for Gigabeat F

Page 1: ...The Rockbox Manual for Toshiba Gigabeat F and X Series rockbox org April 30 2017 ...

Page 2: ...ria Garcia Valdecasas Bernal Peter Schlenker Version 3 14 Built using pdfL A TEX Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 2 or any later version published by the Free Software Foundation with no Invariant Sec tions no Front Cover Texts and no Back Cover Texts A copy of the license is included in the section...

Page 3: ... 17 2 5 1 Automatic Uninstallation 17 2 5 2 Manual Uninstallation 17 2 6 Troubleshooting 18 3 Quick Start 19 3 1 Basic Overview 19 3 1 1 The player s controls 19 3 1 2 Turning the player on and off 20 3 1 3 Putting music on your player 20 3 1 4 The first contact 21 3 1 5 Basic controls 21 3 1 6 Basic concepts 21 3 2 Customising Rockbox 22 3 3 USB Charging 22 4 Browsing and playing 23 4 1 File Brow...

Page 4: ...Hotkeys 40 5 The Main Menu 41 5 1 Introducing the Main Menu 41 5 2 Navigating the Main Menu 42 5 3 Recent Bookmarks 42 5 4 Files 43 5 5 Database 43 5 6 Now Playing Resume Playback 43 5 7 Settings 43 5 7 1 Sound Settings 44 5 7 2 Playback Settings 44 5 7 3 General Settings 44 5 7 4 Theme Settings 44 5 7 5 Manage Settings 44 5 8 Playlists 44 5 9 Plugins 45 5 10 System 45 5 11 Quick Screen 45 5 12 Sh...

Page 5: ... Change Directory 61 7 12 Constrain Auto Change 61 7 13 Pause on Headphone Unplug 61 7 14 Last fm Log 62 7 15 Cuesheet Support 62 7 16 Skip Length 62 7 17 Prevent Track Skipping 62 7 18 Rewind Before Resume 63 7 19 Rewind on Pause 63 8 General Settings 64 8 1 Playlist 64 8 2 File View 64 8 3 Database 66 8 4 Display 66 8 5 System 69 8 5 1 Battery 69 8 5 2 Disk 69 8 5 3 Limits 70 8 5 4 Use Shortcuts...

Page 6: ...e 85 11 1 4 BrickMania 85 11 1 5 Bubbles 86 11 1 6 Chessbox 87 11 1 7 Chopper 89 11 1 8 Clix 90 11 1 9 Codebuster 91 11 1 10 Dice 91 11 1 11 Doom 92 11 1 12 Flipit 94 11 1 13 Goban 95 11 1 14 Invadrox 100 11 1 15 Jackpot 101 11 1 16 Jewels 102 11 1 17 Maze 102 11 1 18 MazezaM 103 11 1 19 Minesweeper 104 11 1 20 Pacbox 105 11 1 21 Pegbox 107 11 1 22 Pong 108 11 1 23 Puzzles 109 11 1 24 Reversi 110 ...

Page 7: ...Fractals 132 11 2 8 Logo 133 11 2 9 Matrix 133 11 2 10 Mosaique 134 11 2 11 Oscilloscope 135 11 2 12 PictureFlow 136 11 2 13 Plasma 138 11 2 14 Rocklife 138 11 2 15 Snow 139 11 2 16 Starfield 140 11 2 17 VU meter 141 11 3 Viewers 141 11 3 1 Shortcuts 142 11 3 2 Chip 8 Emulator 143 11 3 3 Frotz 144 11 3 4 Image Viewer 145 11 3 5 Lua scripting language 146 11 3 6 Midiplay 147 11 3 7 MPEG Player 147 ...

Page 8: ...180 11 4 17 Periodic Table 180 11 4 18 Random Folder Advance Configuration 181 11 4 19 Resistor Calculator 181 11 4 20 Rockpaint 182 11 4 21 Stats 185 11 4 22 Stopwatch 186 11 4 23 Text Editor 186 12 Advanced Topics 188 12 1 Customising the User Interface 188 12 1 1 Customising The Main Menu 188 12 1 2 Getting Extras 188 12 1 3 Loading Fonts 188 12 1 4 Loading Languages 189 12 1 5 Changing Filetyp...

Page 9: ...04 B 1 Supported audio formats 204 B 1 1 Lossy Codecs 204 B 1 2 Lossless Codecs 205 B 1 3 Other Codecs 206 B 1 4 Codec featureset 207 B 2 Supported metadata tags 208 B 2 1 Featureset for generic metadata tags 208 B 2 2 Featureset for codec specific metadata 209 B 2 3 Limitations of metadata handling 209 C Album Art 210 C 1 Limitations 210 C 2 Where to put album art 210 D Theme Tags 212 D 1 Status ...

Page 10: ...l Tags 224 D 24 Subline Tags 224 D 25 Time and Date 225 D 26 Text Translation 225 D 27 Bar Tags 225 D 27 1 Options 226 D 28 Other Tags 227 E Config file options 228 F Menu Overview 233 G User feedback 234 G 1 Bug reports 234 G 1 1 Rules for submitting new bug reports 234 G 2 Feature ideas 234 G 2 1 Rules for submitting a new feature idea 234 G 2 2 Features we will not implement 235 H Credits 236 I...

Page 11: ...to making Rockbox sound the best it can and improvements are constantly being made All models have access to a large number of plugins including many games applications and graphical demos You can load different configurations quickly for different purposes e g a large font for in your car different sound settings for at home Rockbox features a very wide range of languages and all supported models...

Page 12: ...on the margin to help you finding important parts or parts you could skip The following icons are used Note This indicates a note A note starts always with the text Note In order to b make finding notes easier each one is accompanied by an icon in the margin as here Notes are used to mark useful information that may help you to get the most out of Rockbox Warning This is a warning In contrast to n...

Page 13: ...ling Rockbox There are two ways to install Rockbox automated and manual The automated way is the preferred method of installing Rockbox for the majority of people Rockbox Utility is a graphical application that does almost everything for you However should you encounter a problem then the manual way is still available to you There are three separate components two of which need to be installed in ...

Page 14: ...ckbox 2 2 1 Automated Installation To automatically install Rockbox download the official installer and housekeeping tool Rockbox Utility It allows you to Automatically install all needed components for using Rockbox Minimal Instal lation Automatically install all suggested components Complete Installation Selectively install optional components Install additional fonts and themes Install voice fi...

Page 15: ...he release version and the current build there is also an archive of daily builds available for download These are built once a day from the latest source code in the repository For a manual install you can download archived builds from http www rockbox org daily shtml Note Because current and archived builds are development versions that change fre b quently they may behave differently than descr...

Page 16: ...directories are hidden Make sure that you have configured your browser to show hidden files or you may be unable to see FWIMG In that directory you ll find a file called FWIMG01 DAT This too may be hidden Rename the file to FWIMG01 DAT ORIG Make sure you spelled that name correctly as it is needed for booting the Toshiba firmware Warning If you do not complete this step then you will be unable to ...

Page 17: ...e easily updated with Rockbox Utility You can also update Rockbox manually download a Rockbox build as detailed above and unzip the build to the root directory of your player as in the manual installation stage If your unzip program asks you whether to overwrite files choose the Yes to all option The new build will be installed over your current build The bootloader only changes rarely and should ...

Page 18: ...ult of not extracting the contents of the zip file to the proper location and should not happen when Rockbox has been installed with Rockbox Utility To fix this either install Rockbox with the Rockbox Utility which will take care of this for you or recheck the Manual Install section to see where the files need to be located The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 19: ...lowing description is for the Gigabeat F but can also apply for the Gi b gabeat X The Gigabeat F is slightly larger and more rectangular shaped while the Gigabeat X is smaller and has a slightly tapered back Hold the player with the screen on top and the controls on the right hand side Below the screen is a cross shaped touch sensitive pad which contains the Up Down Left and Right controls On the ...

Page 20: ... Rockbox enabled player use the following keys Key Remote Key Action Power Start Rockbox Long Power Shutdown Rockbox On shutdown Rockbox automatically saves its settings If you have problems with your settings such as accidentally having set the colours to black on black they can be reset at boot time See the Reset Settings in section 12 3 3 page 199 for details In the unlikely event of a software...

Page 21: ...ts replaced with the contents of the current directory This way you can easily treat directories as playlists The created dynamic playlist can be extended or modified while playing This is also known as on the fly playlist To go back to the File Browser stop the playback with the Power button or return to the file browser while keeping playback running using Select In list views you can go back on...

Page 22: ...iew LCD settings and all other settings that can be modified using cfg files This topic is discussed in more detail in section 12 3 page 198 The Rockbox distribution comes with some themes that should look nice on your player Note Some of the themes shipped with Rockbox need additional fonts from the fonts b package so make sure you installed them Also if you downloaded additional themes from the ...

Page 23: ... on your player using categories like album artist genre etc You can select whether to browse using the File Browser or the Database Browser by selecting either Files or Database in the Main Menu If you choose the File Browser the Show Files setting lets you select what types of files you wish to view See section 8 2 page 65 for more information on the Show Files setting Note The File Browser allo...

Page 24: ...rd Execute the default action on the se lected file or enter a directory A Play If there is an audio file playing return to the While Playing Screen WPS without stopping playback Power Long Play Stop audio playback Long Select Long Menu Enter the Context Menu Menu Menu Enter the Main Menu Long Menu Long Rewind Switch to the Quick Screen see sec tion 5 11 page 45 A Menu Activate the Hotkey function...

Page 25: ...tory it will display options for directories The Context Menu contains the following options unless otherwise noted each option pertains both to files and directories Playlist Enters the Playlist Submenu see section 4 4 3 page 38 Playlist Catalogue Enters the Playlist Catalogue Submenu see section 4 4 2 page 37 Rename This function lets the user modify the name of a file or directory Cut Copies th...

Page 26: ...ed to view a text file even if the file has a non standard extension i e the file has an extension of something other than txt See section 11 3 page 141 for more details on viewers Create Directory Create a new directory in the current directory on the disk Properties Shows properties such as size and the time and date of the last modification for the selected file If used on a directory the numbe...

Page 27: ... easily changed by making a text file with the required layout More information on how to achieve this can be found on the Rockbox website at ZLoadableKeyboardLayouts Also you can switch to Morse code input mode by changing the Use Morse Code Input setting or by pressing A Power in the virtual keyboard Note When the cursor is on the input line Select deletes the preceding character b The Rockbox m...

Page 28: ...character in Morse code input mode 4 2 Database 4 2 1 Introduction This chapter describes the Rockbox music database system Using the information contained in the tags ID3v1 ID3v2 Vorbis Comments Apev2 etc in your audio files Rockbox builds and maintains a database of the music files on your player and allows you to browse them by Artist Album Genre Song Name etc The criteria the database uses to ...

Page 29: ... boot up Note If you browse your music frequently using the database you should load b to RAM as this will reduce the overall battery consumption because the disk will not need to spin on each search Auto Update If Auto update is set to on each time the player boots the database will automatically be updated Initialize Now You can force Rockbox to rescan your disk for tagged files by using the Ini...

Page 30: ...se If Auto Update is enabled this is per formed automatically when the database is initialized 4 2 4 Using the Database Once the database has been initialized you can browse your music by Artist Al bum Genre Song Name etc To use the database go to the Main Menu and select Database Note You may need to increase the value of the Max Entries in File Browser b setting Settings General Settings System ...

Page 31: ...th numeric system Lm track len min numeric system Ls track len sec numeric system 4 3 While Playing Screen The While Playing Screen WPS displays various pieces of information about the cur rently playing audio file The appearance of the WPS can be configured using WPS configuration files The items shown depend on your configuration all items can be turned on or off independently Refer to section D...

Page 32: ...ong Rewind Rewind in track Right Forward Go to the next track Long Right Long Forward Fast forward in track A Play Toggle play pause Power Long Play Stop playback Select Return to the File Browser Database Long Select Long Menu Enter WPS Context Menu Menu Menu Enter Main Menu Long Menu Switch to the Quick Screen see sec tion 5 11 page 45 A Up Down Show Pitch Screen see section 4 3 3 page 35 A Down...

Page 33: ...ear mode each dot is a 10 mark In dBFS mode the dots represent the following values from right to left 0 dB 3 dB 6 dB 9 dB 12 dB 18 dB 24 dB 30 dB 40 dB 50 dB 60 dB 4 3 3 The WPS Context Menu Like the context menu for the File Browser the WPS Context Menu allows you quick access to some often used functions Playlist The Playlist submenu allows you to view save search and reshuffle the current play...

Page 34: ...tcut to the Sound Settings Menu where you can configure volume bass treble and other settings affecting the sound of your music See section 6 page 48 for more information Playback Settings This is a shortcut to the Playback Settings Menu where you can configure shuffle repeat party mode skip length and other settings affecting the playback of your music Rating The menu entry is only shown if Gathe...

Page 35: ... is the same as the Open With function in the file browser s Context Menu Delete Delete the currently playing file The file will be deleted but the playback of the file will not stop immediately Instead the part of the file that has already been buffered i e read into the player s memory will be played This may even be the whole track Pitch The Pitch Screen allows you to change the rate of playbac...

Page 36: ...ookmarks you may create see section 8 7 page 73 and will be restored upon playing back those bookmarks Key Remote Key Action Menu Long Play Toggle pitch changing mode cycle through all available modes Up Down Volume Up Volume Down Increase Decrease pitch by 0 1 in procentual mode or 0 1 semitone in semitone mode Long Up Long Down Long Volume Up Long Volume Down Increase Decrease pitch by 1 in pro ...

Page 37: ...he File Browser with Select or Right Rockbox will automatically create a playlist containing all of the songs in that directory and start playback with the selected song Note If you already have created a dynamic playlist playing a new song will erase the b current dynamic playlist and create a new one If you want to add a song to the current playlist rather than erasing the current playlist see t...

Page 38: ...ion 4 1 2 page 25 it allows you to put tracks into a dynamic playlist If there is no music currently play ing Rockbox will create a new dynamic playlist and put the selected track s into it If there is music currently playing Rockbox will put the selected track s into the cur rent playlist The place in which the newly selected tracks are added to the playlist is determined by the following options...

Page 39: ...n be used to add either single tracks or entire directories to a playlist If the Playlist Submenu is invoked on a single track it will put only that track into the playlist On the other hand if the Playlist Submenu is invoked on a directory Rockbox adds all of the tracks in that directory to the playlist Note You can control whether or not Rockbox includes the contents of subdirectories b when add...

Page 40: ...ge 27 enter a filename for your playlist and accept it and you are done 4 4 6 Loading saved playlists Through the File Browser Playlist files like regular music tracks can be selected through the File Browser When loading a playlist from disk it will replace the current dynamic playlist Through the Playlist catalogue The Playlist catalogue offers a shortcut to all playlists in your player s specif...

Page 41: ...the Menu button All settings are stored on the unit However Rockbox does not access the hard disk solely for the purpose of saving settings Instead Rockbox will save settings when it accesses the hard disk the next time for example when refilling the music buffer or navigating through the File Browser Changes to settings may therefore not be saved unless the player is shut down safely see section ...

Page 42: ...evious option Select or Right Forward Select option Left or Power Rewind Exit menu or setting or move to parent menu 5 3 Recent Bookmarks Figure 5 2 The list bookmarks screen If the Save a list of recently created bookmarks option is enabled then you can view a list of several recent bookmarks here and select one to jump straight to that track Note Bookmarking only works when tracks are launched f...

Page 43: ...is not shown in the Main Menu when the option is off the default setting See section 8 7 page 73 for more details on configuring bookmarking in Rockbox 5 4 Files Browse the files on your player see section 4 1 page 23 5 5 Database Browse by the meta data in your audio files see section 4 2 page 28 5 6 Now Playing Resume Playback Go to the While Playing Screen and resume if music playback is stoppe...

Page 44: ...pearance of Rockbox The details of this menu are covered in section 9 page 79 5 7 5 Manage Settings The Manage Settings option allows the saving and re loading of user configuration settings browsing the hard drive for alternate firmwares and finally resetting your player back to initial configuration The details of this menu are covered in section 12 3 page 198 5 8 Playlists This menu allows you ...

Page 45: ...ing Time This item shows the cumulative overall runtime of your player since you either disconnected it from charging in Rockbox or manually reset this item A manual reset is done through pressing any button followed by pressing Select or Right Top Time This item shows the cumulative overall runtime of your player since you last manually reset this item A manual reset is done through pressing any ...

Page 46: ...ortcut A file can be run i e a music file played plugin started or a cfg loaded The file browser can be opened with the cursor positioned at a specified file or folder A file s or folder s Current Playlist context menu item can be displayed A setting can be configured any which can be added to the Quick Screen A debug menu item can be displayed useful for developers mostly The current time can be ...

Page 47: ...s to run the sleep timer for 0 to disable name is required for this shortcut type shutdown data is ignored name can be used to display text If the name icon items are not specified a sensible default will be used Note For the browse type if you want the file browser to start inside a folder make b sure the data has the trailing slash i e Music instead of Music Without the trailing slash it will ca...

Page 48: ...he maximum volume that the player can produce without possible distortion clipping All values lower than this reference will be negative and yield a progressively softer volume Values higher than 0 dB are available and can be used to raise the volume more than would otherwise be possible These volume levels will ordi narily lead to distorted sound but might work nicely for music that has an otherw...

Page 49: ...left channel relative to the right positive numbers increase the volume of the right channel relative to the left 6 6 Channels A stereo audio signal consists of two channels left and right The Channels setting determines if these channels are to be combined in any way and if so in what manner they will be combined Available options are Stereo Leave the audio signal unmodified Mono Combine both cha...

Page 50: ...the sound is coming from On the other hand when listening to head phones each ear hears only the stereo channel corresponding to it The left ear hears only the left channel and the right ear hears only the right channel The result is that sound from headphones does not provide the same spatial cues to your ear and brain as speakers and might for that reason sound unnatural to some listeners The cr...

Page 51: ... to ones preference Beware that the crossfeed function is capable of making the audio distort if you choose settings which result in a too high output level 6 9 Equalizer Figure 6 2 The graphical equalizer Rockbox features a parametric equalizer EQ In contrast to non parametric equalizers a parametric EQ enables adjusting the center frequency gain and width of EQ bands separately The ability to ad...

Page 52: ... low frequencies A cutoff frequency of 200 Hz on the other hand will adjust a much wider range of bass frequencies The gain parameter controls how much the loudness of the band is adjusted Positive numbers make the EQ band louder while negative numbers make that EQ band quieter The Q parameter should always be set to 0 7 for the shelving filters Higher values will add a small boost around the cuto...

Page 53: ...own Moves to the next EQ band Select Play Toggles the cursor among the three pa rameters gain centre frequency Q for the selected EQ band Power Menu Exits the graphic EQ screen Pre cut If too much positive gain is added through the graphical EQ your music may distort The Precut setting allows you to apply a global negative gain to decoded audio cancelling out positive gain from the EQ This will pr...

Page 54: ...rum humans cannot hear so easily In Rockbox case some of the noise is pushed up to above 10 kHz This setting will be put to its best use when listening to dynamic music with frequently occuring quiet parts classical music being a typical example It is worth noting that the effects of dithering and noise shaping are very subtle and not easily noticable Rockbox uses highpass triangular distribution ...

Page 55: ...ons of dynamic material in noisy environments while preventing sudden loud sections from being overbearing There are several settings associated with the compressor The first and most impor tant is the Threshold The threshold is the audio input level at which the compressor begins to act Any level louder than the threshold will be compressed to some extent The maximum amount of compression or the ...

Page 56: ...eshold The Attack Time setting sets the delay in milliseconds between the input signal exceeding the activation threshold and acting upon it The Release Time setting sets the recovery time after the signal is compressed Once the compressor determines that compression is necessary the input signal is reduced appropriately but the gain isn t allowed to immediately return to normal levels This is nec...

Page 57: ... Yes Rockbox b will move on to the next directory on your hard drive If the Auto Change Directory option is set to No playback will stop when the current directory or playlist is finished All The current playlist will repeat when it is finished One Repeat one track over and over Shuffle When the current playlist has finished playing it will be shuffled and then repeated A B Repeats between two use...

Page 58: ...n be set to various values between 5 seconds and 10 minutes Note Having a large anti skip buffer tends to use more power and may reduce your b battery life It is recommended to always use the lowest possible setting that allows correct and continuous playback 7 6 Fade on Stop Pause Enables and disables a fade effect when you pause or stop playing a song If the Fade on Stop Pause option is set to Y...

Page 59: ...tween when the crossfade process begins and when the new track begins to fade in Fade In Duration The length of time in seconds that it takes your music to fade in once the Fade In Delay has ended Fade Out Delay The fade out delay is the length of time between when the crossfade process begins and when the old track begins to fade out Fade Out Duration The length of time in seconds that it takes y...

Page 60: ...y Album Gain Maintain a constant volume level between albums but keep any intentional volume variations between songs in an album If album gain value is not available uses track gain information Track Gain Maintain a constant volume level between tracks If track gain value is not available no replaygain is applied Track Gain If Shuffling Maintains a constant volume between tracks if Shuffle is set...

Page 61: ...ires you to first generate a folder list via the Random Folder Advance Configuration plugin see section 11 4 18 page 181 Note You must have the Repeat option set to No for Auto Change Directory to b function properly Note This feature only works when songs have been played from the file browser Using b it with the database may cause unexpected behaviour 7 12 Constrain Auto Change If enabled and yo...

Page 62: ... ID3 tags When you enable this option you ll have to reboot for it to come into effect Cuesheet files should have the same file name as the audio file they reference except with the extension cue This file can either reside in the same directory as the audio file checked first or within the rockbox cue directory The contents of a cuesheet file can also be embedded within the metadata of an audio f...

Page 63: ...ed The size of the rewind can be set to various values between 0 off and 60 seconds Note This option does not apply to resuming a paused track Use the next option for b rewinding on pause Note The actual rewind distance may differ a little from the requested value depending b on the file in question 7 19 Rewind on Pause This option rewinds the current track by a small amount whenever it is paused ...

Page 64: ...c playlist all subdirectories will also be inserted If set to Ask Rockbox will prompt the user about whether to include sub directories Warn When Erasing Dynamic Playlist If set to Yes Rockbox will provide a warning if the user attempts to take an action that will cause Rockbox to erase the current dynamic playlist 8 2 File View The File View menu deals with options relating to how the File Browse...

Page 65: ...gits to a number used for sorting taking leading zeros into account As digits disables this algorithm and causes every digit to be compared sepa rately The following table demonstrates the two sorting methods As whole numbers As digits 03 Jackson mp3 03 Jackson mp3 1 Ring Of Fire mp3 1 Ring Of Fire mp3 2 I Walk The Line mp3 10 A Thing Called Love mp3 10 A Thing Called Love mp3 2 I Walk The Line mp...

Page 66: ...on the Database browser If set to Current Directory Only or Full Path then the title of each menu will be displayed on the first line in the Database Browser 8 3 Database This sub menu allows you to configure the database See section 4 2 page 28 for more information about using the database 8 4 Display LCD Settings This sub menu contains settings that relate to the display of the player Backlight ...

Page 67: ... that have no action assigned and accidental button combi nations don t turn on backlight Disable on External Power When plugged goes back to regular behavior Selected actions are indicated by a leading Note If all options get de selected the entire feature is disabled Sleep After Backlight Off This setting controls how long rockbox will wait be fore turning off the display after the backlight is ...

Page 68: ...at surpass the screen size will page up down instead of simply changing lines This can be useful on slow displays List Acceleration Start Delay This setting enables the acceleration of scroll speed in lists when holding Up or Down When set to Off the acceleration is disabled When any other value is set the acceleration will start to accelerate after holding Up or Down for the chosen time in second...

Page 69: ...er set are encoded ID3v1 tags do not have a codepage encoding contained so Rockbox needs to know what encoding has been used when generating these tags This should be ISO 8859 1 but to support lan guages outside Western Europe most applications use the setting of your operating system instead If your operating system uses a different codepage and you are getting garbled extended characters you sho...

Page 70: ...any particular directory in the file browser You can configure the size to be between 50 and 10 000 files in steps of 50 The default is 400 Higher values will shorten the music buffer so you should increase this setting only if you have directories with a large number of files Max Playlist Size This setting controls the maximum size of a playlist The playlist size can be between 1 000 and 32 000 f...

Page 71: ...This setting controls the amount of time the button lights shine after a button press If set to Off the LEDs will not light when a button is pressed If set to On the lights will never shut off If set to a time 1 to 120 seconds the buttons will stay lit for that amount of time after a button press 8 5 7 Button Light Brightness Changes the brightness of the button lights 8 5 8 Keyclick This menu con...

Page 72: ...Lock Off device locked Lock Button Pressed 3 device unlocked Disable Touch Blocks touch screen buttons like the original Disable Notify Suppresses the notification Buttons Locked still will if power button is pressed Note This is a pre requisite for selectivebacklight section 8 4 page 67 b to work also during key lock Selected actions are indicated by a leading Note If all options get de selected ...

Page 73: ...er duration Shown when the Sleep Timer is inactive this option will initiate a Sleep Timer with the duration shown in brackets Cancel Sleep Timer remaining Shown when the Sleep Timer is active this option will cancel the current Sleep Timer The time remaining before completion is shown in brackets Default Sleep Timer Duration The default number of minutes a new Sleep Timer will run for The values ...

Page 74: ...ookmarks list Ask Recent Only Ask if a bookmark should be created but only add it to the recent bookmarks list When either Yes Recent Only or Ask Recent Only is selected bookmarks are only created if the Maintain a List of Recent Bookmarks is enabled Note The Resume function remembers your position in the most recently ac b cessed track regardless of how the Bookmark on Stop option is set Update o...

Page 75: ...lected bookmark Left or Power Rewind Exits Recent Bookmark menu A Long Menu Deletes the currently selected bookmark Long Select Long Menu Enters the context menu for the selected bookmark There are two options in the context menu Resume will commence playback of the currently selected bookmark entry Delete will remove the currently selected bookmark entry from the list 8 8 Automatic resume The aut...

Page 76: ...ck transition should be resumed at its last playback position as well No Automatic resume works only for manual track selection Yes Always attempt to resume for both manual and automatic track changes In custom directories only Configure directories in which to enable resume on automatic track change Selecting this option starts the text editor in which you can enter the absolute case insensitive ...

Page 77: ...a text to speech engine on a PC Off No checking is made for directory talk clips they are not used even if present This can reduce disk activity Use of a talk clip takes precedence over other directory name voicing Otherwise e g if a talk clip is not available voicing uses the method set under Voice Directories above Voice Filenames This option controls voicing of filenames Again a voice file must...

Page 78: ...ery Level When this option is enabled the battery level is announced when it falls under 50 30 and 15 See ZVoiceHowto for more details on configuring speech support in Rockbox 8 11 Hotkey WPS Hotkey File Browser Hotkey These options set the hotkey function for their respective screens see section 4 5 page 40 The default for the WPS is View Playlist The File Browser default is Off The Rockbox manua...

Page 79: ...your player Selecting one will activate it See section 12 1 3 page 188 for further details about fonts While Playing Screen Opens the File Browser in the rockbox wps directory and displays all wps files Selecting one will activate it Left or Power will exit back to the menu For further information about the WPS see section 4 3 page 31 For information about editing a wps file see section 12 2 page ...

Page 80: ...d colour the colour is set in the Colours submenu Bar Gradient Colour A bar with a colour gradient the colours are set in the Colours submenu Colours The options in this menu sets the colours for visual elements in Rockbox Line Selector Colours These options sets the colours for the line selector bars Primary Colour Set the primary colour used for the gradient line selector bar and the colour used...

Page 81: ... Time related menu options Pressing Long Select will voice the current time if voice support is enabled Set Time Date Set current time and date Time Format Choose 12 or 24 hour clock The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 82: ...ere with music playback but some of them will stop playback while running Plugins have the file ex tension rock Most of them can be started from Browse Plugins in the Main Menu Viewer plugins get started automatically by opening an associated file i e text files chip8 games or from the Open with option on the Context Menu 11 1 Games See also the Chip 8 emulator in section 11 3 2 page 143 Frotz in ...

Page 83: ...esulting tile cannot merge with another the same move After each move a tile with the value of 2 or 4 is created in an empty spot on the grid The game is won when a tile with a value of 2048 is created and the player loses when there are no more possible moves Note On players with a small screen tiles with a value greater than 1000 are shortened b to 1k 2k and so forth k is the abbreviation of kil...

Page 84: ...ifficult blackjack is a game renowned for the strategy involved This version includes the ability to split buy insurance and double down For the full set of rules to the game and other fascinating information visit http www blackjackinfo com blackjack rules php Key Remote Key Action Left Right Up Down Enter betting amount Select Hit Draw new card Select Volume down Stay End hand A Double down Powe...

Page 85: ...ckbox 11 1 4 BrickMania Figure 11 3 BrickMania BrickMania is a clone of the classic game Breakout The aim of the game is to destroy all the bricks by hitting them with the ball once or more Sometimes a special item falls down when you destroy a brick For a special item to take effect you must catch it with the paddle Look out for the bad ones The Rockbox manual version 3 14 Toshiba Gigabeat F and ...

Page 86: ...ows you to shoot bricks with paddle G Glue Ball sticks to paddle each time it hits B Ball Immediately fires another ball FL Flip Flip left right movement Key Remote Key Action Left Right Moves the paddle Select Up Release the ball Fire Power Open menu Quit 11 1 5 Bubbles Figure 11 4 Bubbles The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 87: ...e entire board is shifted down every time a certain number of shots have been fired Points are awarded depending on how quickly the level was completed Key Remote Key Action Up Forward Pause game Left Right Volume Down Volume Up Aim the bubble Select Fire bubble Power or Long Power Exit to menu 11 1 6 Chessbox Figure 11 5 Chessbox Chessbox is a one person chess game with computer artificial intell...

Page 88: ...is thinking will cause it to make its move immediately If done while it s your turn the computer will move for you and flip the board so that you are playing from the other side If you want you can force play an entire game and watch the artificial intelligence fight against itself When you quit the game the current state will be saved and restored when you resume the game The menu also allows the...

Page 89: ... 6 Chopper Navigate a cavernous maze without banging into walls the ceiling or the floor How long can you fly your chopper Key Remote Key Action Select Make chopper fly Menu Enter menu The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 90: ...remove blocks if at least two blocks with the same color have a direct connection The more blocks you remove per turn the more points you get Key Remote Key Action Left Right Up Down Move the cursor around the blocks Select Remove a block Power Exit The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 91: ... peg signifies a correct peg in the correct position and a white peg signifies a correct peg in the wrong position Key Remote Key Action Power Show menu Select Check suggestion and move to next line Left Right Volume Down Volume Up Select a peg Up Down Forward Rewind Change current peg 11 1 10 Dice Dice is a simple dice rolling simulator Select number and type of dice to roll in a menu and start b...

Page 92: ... prboom 2 2 6 Your wad files Copy all Doom wads you wish to play into that directory The needed files can be found at ZPluginDoom To play addon wads create the addons directory within the doom directory Place wad files in this directory Currently doom only supports a maximum number of 10 addons A free alternative for Doom 2 is FreeDoom http freedoom sourceforge net This can be used in place of doo...

Page 93: ...a player Only runs on Doom Shareware Player Bobbing Enable or Disable player up Down movement Translucency Enable or Disable sprite translucency Fireballs Plasma Fake Contrast Enable or Disable modified game lighting Always Run Make the player always run Headsup Display Show the player status when in fullscreen Statusbar Always Red Disable colour response statusbar InGame Main Menu This menu can o...

Page 94: ...urn Right A Shoot Menu Open Power InGame Menu Select Enter Volume down Change Weapon Playing the game After installation of the wad files is complete you can start the game more description is needed 11 1 12 Flipit Figure 11 10 Flipit The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 95: ...le Volume up Solve Volume down Solve step by step Power Quit the game 11 1 13 Goban Figure 11 11 Goban Goban is a a plugin for playing viewing and recording games of Go also known as Weiqi Baduk Igo and Goe It uses standard Smart Game Format SGF files for sav ing and loading games You can find a short introduction to Go at http senseis xmp net WhatIsGo and more information about SGF files can be r...

Page 96: ... rare but if you have one don t even try it the file will most likely be corrupted if you save over it You have been warned The file sgf gbn_def sgf is used by the plugin to store any unsaved changes in the most recently loaded game This means that if you forget to save your changes you should load sgf gbn_def sgf immediately to offload the changes to another file If you load another file first th...

Page 97: ...ecified file Game Info View and modify the metadata of the current game Playback Control Control the playback of the current playlist and modify the volume of your player Zoom Level Zoom in or out on the board If you set the zoom level it will be saved and used again the next time you open this plugin Options Open the Options Menu Context Menu Open the Context Menu which allows you to set play mod...

Page 98: ...llow the format specified at http www red bean com sgf properties html DT to be read by other SGF readers Event The name of the event which this game was a part of if any Place The place that this game took place Round If part of a tournament the round number for this game Done Return to the previous menu Options Customize the behavior of the plugin in certain ways Show Child Variations Enable thi...

Page 99: ...he mode of play Next Variation If the game is at the first move in a variation this will navigate to the next variation after the current one This is the only way to reach variations which start with adding or removing stones as you cannot follow them by playing the same move Force Play Mode The same as Play Mode except that this mode will allow you to play illegal moves such as retaking a ko imme...

Page 100: ...ic arcade game Space Invaders Kill those pesky aliens before they get to you Remember they increase speed drop down and reverse direction after every pass Key Remote Key Action Left Move left Right Move right Select Fire Power Quit The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 101: ...ackpot This is a jackpot slot machine game At the beginning of the game you have 20 Payouts are given when three matching symbols come up Key Remote Key Action Select Play Power Exit the game The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 102: ...r points are awarded to larger combos The game advances to the next level after every one hundred points and randomly clears several jewels In puzzle mode the aim of the game is to connect the puzzles by skillfully swapping pairs of jewels Key Remote Key Action Left Right Up Down Move the cursor around the jewels Select Select a jewel Power Menu 11 1 17 Maze This is a simple maze generator that cr...

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

Page 104: ...ll of the squares on the board If a mine is uncovered then the game is over If a mine is not uncovered then the number of mines adjacent to the current square is revealed The aim is to use the information you are given to work out where the mines are and avoid them When the player is certain that they know the location of a mine it can be tagged to avoid accidentally stepping on it The Rockbox man...

Page 105: ...e Menu Display the current game status Power Exit the game 11 1 20 Pacbox Figure 11 17 Pacbox Pacbox is an emulator of the Pacman arcade machine hardware It is a port of PIE Pacman Instructional Emulator by Alessandro Scotti ROMs To use the emulator to play Pacman you need a copy of ROMs for Midway Pacman The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 106: ...j 33c0e197be4c787142af6c3be0d8f6b0 These need to be stored in the rockbox pacman directory on your player In the MAME ROMs collection the necessary files can be found in pacman zip and puckman zip The MAME project itself can be found at http www mame net Keys Key Remote Key Action Up Move Up Down Move Down Left Move Left Right Move Right A Insert Coin Select 1 Player Start Power 2 Player Start Men...

Page 107: ...er they disappear except for triangles which form a solid block and crosses which allow you to choose a replacement block Key Remote Key Action Up Down Left Right to move around Select to choose peg A to restart level Volume up to go up a level Volume down to go down a level Power to quit The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 108: ...of the paddles is pressed control of that paddle passes to the player so for a single player game just press the appropriate buttons to control the side you want to play For a two player game both players should just press the appropriate buttons for their side Key Remote Key Action Up Left player up Down Left player down Volume up Right player up Volume down Right player down Power Quit The Rockb...

Page 109: ...Chapter 11 Plugins 109 11 1 23 Puzzles Figure 11 20 Cube from Puzzles Figure 11 21 Map from Puzzles The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 110: ...g at the end of the game The game rules can be found in the internet You can choose to play manually you place both the white and dark pieces or to play against a not very smart robot 11 1 25 Robotfindskitten Figure 11 22 Robotfindskitten In this game you are robot Your job is to find kitten This task is complicated by the existence of various things which are not kitten Robot must touch items to ...

Page 111: ...assic falling blocks game from Russia The aim of the game is to make the falling blocks of different shapes form full rows Whenever a row is completed it will be cleared away and you gain points For every ten lines completed the game level increases making the blocks fall faster If the pile of blocks reaches the ceiling the game is over The Rockbox manual version 3 14 Toshiba Gigabeat F and X Seri...

Page 112: ...witch Pause Power Quit 11 1 27 Rockblox1d Rockblox1d is a game for people who find rockblox too hard In this version the second dimension is missing so the user only has to move the bricks down No horizontal moving anymore and no need to rotate the brick Key Remote Key Action Down Move down faster Power or Long Power Quit The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 113: ...e the album art of the currently playing music track if one exists see section C page 210 You can also use the sliding puzzle plugin as a viewer for supported image types to turn your own pictures into a puzzle Key controls Key Remote Key Action Left Right Up and Down Move Tile Select Shuffle A Switch between pictures default puz zle album art and your own image if launched via Open With and numbe...

Page 114: ...e as large as possible by eating the dots that appear on the screen The game will end when the snake touches either the borders of the screen or itself Key Remote Key Action Up Down Left Right Move snake Select Toggle Play Pause Go to the plugin s menu The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 115: ...time an apple is eaten the snake gets longer The game ends when the snake hits a wall or runs into itself Key Remote Key Action Up Down Left Right Steer the snake Select Pause and resume the game Power Quit In game A the maze stays the same in game B after an increasing number of apples eaten the maze is replaced by a new one The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 116: ...pushed never pulled and only one can be pushed at a time Sokoban may be used as a viewer for viewing saved solutions and playing external level sets with the sok extension Level sets should be in the standard Sokoban text format or RLE Run Length Encoded For more information about the level format see http sokobano de wiki index php title Level_format The Rockbox manual version 3 14 Toshiba Gigabe...

Page 117: ...ndone move Solution playback Select Pause resume Up Down Increase decrease playback speed Left Right Go backward forward while paused Power Quit Some places where can you can find level sets http www sourcecode se sokoban levels php http sokobano de en levels php Note that some level sets may contain levels that are too large for this version of Sokoban and are unplayable as a result The Rockbox m...

Page 118: ...ist Though the name may not be familiar the game itself certainly is This is due in no small part to Microsoft s inclusion of the the game in every version of Windows Though popular the odds of winning are rather low perhaps one in thirty hands For the full set of rules to the game and other interesting information visit http www solitairecentral com rules Klondike html The Rockbox manual version ...

Page 119: ...e cursor Long Select Put the card under the cursor on one of the 4 final colour stacks A Right Put the card on top of the remains stack on one of the final colour stacks Power Show menu 11 1 33 Spacerocks Figure 11 29 Spacerocks Spacerocks is a clone of the old arcade game Asteroids The goal of the game is to blow up the asteroids and avoid being hit by them Once in a while a UFO will appear shoot...

Page 120: ...te of Star a game written by CDK designed for the hp48 calculator Rules Take all of the o s to go to the next level You can switch control between the filled circle which can take o s and the filled square which is used as a mobile wall to allow your filled circle to get to places on the screen it could not otherwise reach The block cannot take o s The Rockbox manual version 3 14 Toshiba Gigabeat ...

Page 121: ...owse Plugins menu a random game will be generated automatically and an estimate of its difficulty very easy easy medium hard or fiendish will be displayed on the screen New games can be generated from the Generate menu option When playing an existing Sudoku game file from Rockbox file browser the plugin is invoked as viewer The selected Sudoku will get loaded and you can start solving it The sudok...

Page 122: ... b Key Remote Key Action Up Down Left Right Move the cursor Select Change number under the cursor Long Select Constantly changing the number under the cursor Menu Open Menu A Add Remove number to scratchpad Power Quit Some places where can you can find ss files Simple Sudoku Advanced Puzzle Packs 1 and 2 located near the bottom of that page http www angusj com sudoku Kjell s Sudoku generator solve...

Page 123: ...chosen at random The bank in the purchasing phase is a place where you can store your money and earn interest usually about 10bank it is not accessible until the next purchasing phase Notes on food Each year you are allocated an amount of food based on the number of farms you control Food is used to feed your men but if you do not have enough food to feed your population of men some will die of st...

Page 124: ...orm into a big worm for as long as possible Game controls Key Remote Key Action Left Turn left Right Turn right Up Turn Up Down Turn Down The game Use the control keys of your worm to navigate around obstacles and find food Worms do not stop moving except when dead Dead worms are no fun Be careful as your worm will try to eat anything that you steer it across It won t distinguish whether it is edi...

Page 125: ...to pause the game Press it again to resume the game Stop the game There are two ways to stop a running game If you want to quit Wormlet entirely simply hit Power The game will stop immediately and you will return to the game menu If you want to stop the game and still see the screen hit A This freezes the game If you hit A button again a new game starts with the same configu ration To return to th...

Page 126: ...orm Try to avoid other worms and crawl far away from them Wait until they curl up themselves and collect the food afterwards Don t worry if the other worms grow longer than yours you can catch up after they ve died When you are more experienced watch the tactics of other worms Those worms controlled by artificial stupidity head straight for the nearest piece of food Let the other worm have its nex...

Page 127: ... 75 Key Remote Key Action Up Down Left Right Move around the arena A Pause Power Open menu 11 1 39 XWorld In this cinematic award winning platform game by Éric Chahi you must evade capture and do your best to escape an alien planet After an experiment goes awry the hero must team up with an unlikely ally when they both become fugitives on another world XWorld requires the data files BANK and MEMLI...

Page 128: ...ion Up Up and Jump Down Down and Crouch Left Right Move Left and Right Volume up Action and Fire Menu Menu 11 2 Demos 11 2 1 Bounce Figure 11 34 Bounce This demo is of the word Rockbox bouncing across the screen There is also an analogue clock in the background In Scroll mode the bouncing text is replaced by a different one scrolling from right to left The Rockbox manual version 3 14 Toshiba Gigab...

Page 129: ...How fast the code moves on the sine curve on each axis Xsane Ysane Changes the appearance of the bouncing 11 2 2 Credits The credits plugin scrolls the entire list of the names of all the Rockbox contributors after displaying the Rockbox logo and version This plugin is called when selecting Version from the System section of the Rockbox main menu Exit at any time by pressing Left or Power 11 2 3 C...

Page 130: ...maximum frame rate Select Pause Menu Cycle draw mode Right Left Select axis to adjust Up Down Change speed angle speed can not be changed while paused Power Quit 11 2 4 Demystify Figure 11 36 Demystify Demystify is a screen saver like demo The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 131: ...Down Forward Rewind Add remove polygon Power Quit 11 2 5 FFT This plugin is a basic frequency analyzer with 3 different frequency amplitude plots lines bars and spectrogram 11 2 6 Fire Figure 11 37 Fire Fire is a demo displaying a fire effect The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 132: ...ase number of flames Left Volume Down Toggle flame type Right Volume Up Toggle moving flames Power Quit 11 2 7 Fractals Figure 11 38 Fractals Mandelbrot set This demonstration draws fractal images from the Mandelbrot set The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 133: ...to the default image Power Quit 11 2 8 Logo Demo showing the Rockbox logo bouncing around the screen Key Remote Key Action Right Left Increase decrease speed on the x axis Up Down Increase decrease speed on the y axis Power or Long Power Quit 11 2 9 Matrix This plugin is a visual demo resembling the scrolling code from The Matrix https en wikipedia org wiki The_Matrix The Rockbox manual version 3 ...

Page 134: ...le graphics demo draws a mosaic picture on the screen of the player Key Remote Key Action Up Change the gap between the drawing lines Select Restart the drawing process Power or Long Power Exits Mosaique demo The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 135: ...the player is less responsive to user input and music may start to skip Keys Key Remote Key Action Select Toggle filled curve plot Down Toggle whether to scroll or not Up Toggle drawing orientation A Pause the demo Volume up Volume down Increase decrease volume Right Left Increase decrease speed Power Exit demo The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 136: ...ile your tracks are played Requirements PictureFlow uses both the album art see section C page 210 and database see section 4 2 page 28 features of Rockbox It is therefore important that these are working correctly before attempting to use PictureFlow In addition there are some other points of which to be aware PictureFlow will accept album art larger than the dimensions of the screen but the larg...

Page 137: ...S Displays frames per second on screen Spacing The distance between the front edges of the side slides i e changes the degree of overlap of the side slides A larger number means less overlap Scales with zoom Centre margin The distance in screen pixels with zoom at 100 between the centre and side slides Scales with zoom Number of slides Sets the number of slides at each side including the centre sl...

Page 138: ... needed if albums are removed 11 2 13 Plasma Figure 11 42 Plasma Plasma is a demo displaying a 80 s style retro plasma effect Key Remote Key Action Up Down Forward Rewind Increase decrease Frequency Select Change Color Power Long Power Exit 11 2 14 Rocklife This an implementation of J H Conway s Game of Life see http en wikipedia org wiki Conway 27s_Game_of_Life for a detailed description The Rock...

Page 139: ...ng on a line starting with an exclamation sign and including it is a comment and is ignored Key Remote Key Action Select Play pause Down Rewind Change growth mode Right Volume Up Next generation Left Volume Down Status only when paused Power Exit 11 2 15 Snow Figure 11 43 Have you ever seen snow falling This demo replicates snow falling on your screen If you love winter you will love this demo Or ...

Page 140: ...ld Starfield simulation like the classic screensaver Key Remote Key Action Right Left Increase decrease number of stars Up Down Increase decrease speed Select Change colours Power or Long Power Quit The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 141: ...ters in addition to the main display as above From the settings menu the decay time for the meter its memory the meter type and the meter scale can be changed Key Remote Key Action Power Save settings and quit A Help Menu Settings Up Raise Volume Down Lower Volume 11 3 Viewers Viewers are plugins which are associated with specific file extensions They cannot be run directly but are started by play...

Page 142: ...t file with every line containing the name of the file or the directory you want to quickly jump to All names should be full absolute names i e they should start with a Directory names should also end with a How to create link files You can use your favourite text editor to create a link file on the PC an then copy the file to the player Or you can use the context menu on either a file or a direct...

Page 143: ...ommon path prefixes You can also provide a custom display name for each entry individually To do so append a tabulator character after the entry s path followed by your custom name That name will then be used for showing the entry For example Example MyMusic collection song mp3 TAB My favourite song 11 3 2 Chip 8 Emulator Chip8 is a kind of assembly language for a long gone architecture This plugi...

Page 144: ...games are text based and most depend heavily on typed commands The virtual keyboard is used for text entry both for typing entire lines and for typing single characters when the game requires single character input Sounds pictures colour and Unicode are not currently supported but the interpreter informs the game of this and almost all games will adapt so that they are still playable This port of ...

Page 145: ...to display them Supported formats are as follows Format File extension s BMP bmp JPEG jpg jpe jpeg PNG png GIF gif PPM ppm Note When an audio file is playing the size of the image is limited as the decoding b process needs to share memory with audio tracks To be able to view a bigger file you may need to stop playback Key Remote Key Action Up Down Left Right Move around in zoomed in image Volume u...

Page 146: ... PPM files see http netpbm sourceforge net doc ppm html 11 3 5 Lua scripting language To quote from the Lua website http www lua org Lua is a powerful fast lightweight embeddable scripting language Select a lua file in the File Browser to run it For more information on programming in Lua please see http www lua org manual 5 1 and http www lua org pil There are a few exceptions additions to the Lua...

Page 147: ...yer The Mpeg Player is a video player plugin capable of playing back MPEG 1 and MPEG 2 video streams with MPEG audio multiplexed into mpg files To play a video file you just select it in the Rockbox File Browser If your file does not have the mpg extension but is encoded in the supported format you will need to use the Open With context menu option and choose mpegplayer Key Remote Key Action Selec...

Page 148: ... in the directory continuously Clear all resumes x Discard all x resume points Display Options Menu Dithering default off Prevent banding effects in gradients by blending of colours only available on Sansa e200 Sansa c200 and Gigabeat F X Display FPS default off This option displays once a second if your video is full screen this means it will get overwritten by the video and appear to flash once ...

Page 149: ...h 16 bit per sample and a maximum of 2 channels Allowed sample rates are 16 22 05 24 32 44 1 and 48 kHz The user will be asked to select the desired output bitrate of the compressed MP3 file Select Bitrate The following bitrates can be selected 64 80 96 112 128 160 192 224 256 320 kbps Remark Bitrates above 160 kbps cannot be used in MPEG 2 Layer 3 bitstreams The encoder plugin automatically limit...

Page 150: ... emulator To start a game open a ROM file saved as gb or gbc in the file browser Default keys Key Remote Key Action Up Down Left Right Direction keys Volume up A button Volume down B button A Start Select Select Menu Open Rockboy menu Rockboy menu Load Game Loads a previously saved game The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 151: ...s through the playlist that it opened on looking for any occurrences of the string entered by the user The results of this search are saved to a new playlist search_results m3u within the same directory as the original playlist 11 3 11 Shopper Shopper is a plugin which allows you to maintain reusable shopping lists To create a list use a text editor to write down a list of items one per line note ...

Page 152: ...d so if you re open the shopping list it will be as you left it There are additional menu options for clearing the list selecting all items showing and hiding the categories toggling the categories and displaying the playback menu Shopper Keys Key Remote Key Action Select or Right Forward Select or clear an item Menu or Long Select Menu or Long Menu Show menu Left or Power Rewind Exit 11 3 12 Sort...

Page 153: ...is designed for reading plain text files such as ebooks It works by using a form of Rapid Serial Visual Presentation RSVP that has optimized word placement to reduce or eliminate eye movement saccades when reading The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 154: ...o display it The text viewer features controls to handle various styles of text formatting and has top of file and bottom of file buttons You can view files without a txt or nfo extension by using Open with from the Context Menu see section 4 1 2 page 25 You can also bookmark pages The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 155: ...ISO 8859 8 Hebrew CP1251 Cyrillic ISO 8859 11 Thai CP1256 Arabic ISO 8859 9 Turkish ISO 8859 2 Latin Extended CP1250 Central European SJIS Japanese GB 2312 Simple Chinese KSX 1001 Korean BIG5 Traditional Chinese UTF 8 Unicode This setting only applies to the plugin and is independent from the Default Codepage setting see section 8 4 page 69 Word Wrap Toggle word wrap mode On Break lines at the max...

Page 156: ...isplayed even if you select Yes No Do not display the status bar Yes Display the status bar Scroll Settings The scrolling settings submenu Horizontal Submenu for horizontal scrolling settings Scrollbar Toggle the horizontal scrollbar for the current mode If the file fits on one screen there is no scrollbar and this setting has no effect No Do not display the horizontal scroll bar Yes Display the h...

Page 157: ...row mode Change the function of the Left and Right buttons when the screen is in narrow mode i e one screen per page Previous Next Page Scroll up or down one full screen Top Bottom Page Move to the top or bottom page Indent Spaces Set the number of spaces to indent the text when line mode is set to Reflow Lines Available options are 0 to 5 spaces If you select 0 a blank line is displayed as an ind...

Page 158: ...e stored in rockbox rocks viewers viewer dat Quit Exits the plugin The text viewer automatically stores its settings the current position and bookmarks in rockbox rocks viewers viewer_file dat Bookmarks To add a bookmark press Select The bookmark will be displayed as shown below To delete the bookmark press the same button again The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 159: ... which are being kept Exit this screen by pressing any key A file called theme_remove_log txt is created in the root di rectory of your player listing all the changes Remove Options This menu specifies which items are removed if Remove Theme is selected in the menu One of the following options can be chosen for each setting Ask for Removal Selecting this option brings up a dialogue with two option...

Page 160: ... to a theme cfg file is handled Filetype Colours Specifies how the colours colours file belonging to a theme cfg file is handled Create Log File Setting this to No prevents the log file from being created Quit Exits this plugin 11 3 16 VBRfix This function scans a VBR Variable Bitrate MP3 file and updates creates the Xing VBR header The Xing header contains information about the VBR stream used to...

Page 161: ...ng of 48k z80 snapshots is possible b Default keys The emulator is set up for 5 different buttons Up Down Left Right and Jump Fire Each one of these can be mapped to one key of the Spectrum Keyboard or they can be used like a Kempston joystick Per default the buttons including an additional but fixed menu button are assigned as follows Key Remote Key Action Up Down Left Right Directional movement ...

Page 162: ...rum keyboard Display Speed Toggle displaying the emulation speed in percent Invert Colours Inverts the Spectrum colour palette sometimes helps visibility Frameskip Sets the number of frames to skip before displaying one With zero frameskip ZXBox tries to display 50 frames per second Sound Turns sound on or off Volume Controls volume of sound output Predefined Keymap Select one of the predefined ke...

Page 163: ...your player normally Results can be submitted to the ZBatteryRuntime wiki page How it works Once loaded Battery Benchmark runs in the background recording various informa tion about your battery to memory A new point is written to memory every minute Every time the disk is accessed for any reason such as refilling the audio buffer open ing a directory or entering USB mode etc then the information ...

Page 164: ...n mV at the moment the measurement was taken C This stands for Charger An A in that column shows if the power adapter was attached to the unit at the time of the measurement U USB powered Only for targets that support this A U will indicate if the unit was using the USB port for power at the time of the measurement Usage The log file can be used to tell you how long the battery lasted with some li...

Page 165: ...e a standard calculator Pressing the 1st and 2nd buttons will toggle between other available math functions Key Remote Key Action Left Right Up Down Move around the keypad Select Select a button A Delete last entered digit or clear after cal culation Menu Calculate Power Quit The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 166: ... available memo types are one off yearly monthly and weekly memos You can select what day is first day of week by the setting First Day of Week in the menu Key Remote Key Action Left Right Up Down Move the selector Select Show memos for the selected day Volume up Volume down Previous Next month Power Quit The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 167: ...ease decrease displayed Value Select Move to next screen Power Move to previous screen First enter the number of players 1 10 Then set the total game time in mm ss Then the maximum round time is entered For example this could be used to play Scrabble for a maximum of 15 minutes each with each round taking no longer than one minute Done Player 1 starts in paused mode The Rockbox manual version 3 14...

Page 168: ...in to continue Up Switch to next player Down Switch to previous player Menu Open menu Select to select From the menu it is possible to delete a player modify the round time for the current player or set the total time for the game When the round time is up for a player the message ROUND UP is shown press NEXT to continue When the total time is up for a player the message TIME UP is shown The playe...

Page 169: ...ter Mode Settings Opens a menu from which you can adjust settings pertaining to the current clock mode analog digital binary General Settings Reset Settings Reset all settings to their default values Save Settings Save all settings to disk Show Counter Toggle Counter display Save Choose whether to disable automatic saving saving to disk on exit or saving to disk every settings change Backlight Cho...

Page 170: ...the upper left The Blinking Colon if enabled blinks the colon once every second 12 hour mode if enabled will display the time in a 12 hour format LCD mode Based on the Digital Mode the LCD mode is another imitation of an LCD The settings available in this mode are exactly the same as Digital Mode but they are independent of Digital Mode For example you can have the Date Readout enabled in Digital ...

Page 171: ...e displayed and the plugin will exit You can do another search by relaunching the plugin 11 4 8 Disk Tidy Disk Tidy deletes junk files commonly left behind by Windows Linux and OS X after connecting your player over USB Select the files you want to delete in the Files to Clean menu and select Start Cleaning to begin the process The settings are stored in the plain text file rockbox rocks apps disk...

Page 172: ... stored passwords Once inside enter the context menu by pressing Long Select From the context menu you can create new entries delete entries and edit entries Each entry has a title a user name and a password Selecting Reset Keybox from the main menu will delete the current list of passwords and a new empty list will be created the next time you select Enter Keybox after prompting for a new master ...

Page 173: ...ag word time tag The time tag must be in the form mm ss mm ss xx or mm ss xxx where mm is minutes ss is seconds xx is tenth of milliseconds and xxx is milliseconds Any other tags and lines without time tags are ignored Location of lyrics files The plugin checks the following directories for lyrics files If no lyrics file is found and the audio file is a mp3 it also checks for SYLT and USLT tags in...

Page 174: ...t Controls Key Remote Key Action Up Down Volume Up Volume Down Volume up down Left Rewind Go to beginning of track or if pressed while in the first seconds of a track go to the previous track Long Left Long Rewind Rewind in track Right Forward Go to the next track Long Right Long Forward Fast forward in track A Play Toggle play pause Power or Select Long Play or Exit the plugin Long Select Long Me...

Page 175: ...ditor Selecting a line changes its time to the current position of the track To set a specific time or to adjust the time press Long Select to bring up a screen to adjust the time Changes will be saved automatically when the song is changed Editing words in lyrics is not supported 11 4 12 Main Menu Configuration This plugin helps you customizing the main menu i e reorder or hide menu items It chan...

Page 176: ...wearing headphones at a concert Simple Interactive Mode This is the mode of operation that is active when starting the plugin directly from the menu It offers a uniform metronome sound at a constant tempo You can adjust the tempo through the interface or by tapping it out on the appropriate button Key Remote Key Action Long Power Exit plugin Power Stop Long Select Start Select Tap tempo Left Right...

Page 177: ...lay indicates the part properties and position in track as such Metronome Track Interlude 3 4 120 V 25 P2 13 B1 5 2 In this example the part label is Interlude the meter is 3 4 and the tempo 120 quarter beats per minute bpm The volume setting is at 25 and this is the second part of a track with 13 total In that part the position is at the second beat of the first bar of five The syntax of programm...

Page 178: ...lues with a comma no spaces varibeat 3 4 4 135 90 78 100 120 120 99 100 43 94 120 133 where the beat duration is first according to 135 bpm then 90 bpm and so forth You are required to provide a value for each beat in all bars of the part You can provide a pattern that controls how the beats are played Symbol Meaning X emphasized beat Tick x normal beat Tock silent beat Some examples default 0 4 4...

Page 179: ... that for TOTP time based accounts to work properly the clock on your device MUST be accurate to no less than 30 seconds from the time on the authentication server and the correct time zone must be configured in the plugin See section 10 page 81 for more information URI Import This method of adding an account reads a list of URIs from a file It expects each URI to be on a line by itself in the fol...

Page 180: ...ed to HMAC based HOTP accounts only If this is the case the plugin will prompt you for information regarding the HOTP setup 11 4 16 Advanced Settings Time Zone Configuration In order for TOTP accounts to work properly the plugin must be able to determine the current UTC time This means that first your device s clock must be synchronized with UTC time and second that the plugin knows what time zone...

Page 181: ...rs within it you need to have both CDs and CDs as entries Edit Folder List Enter the folder list editor Export List To Textfile Exports the list to rockbox folder_advance_list txt Import List From Textfile Imports the list from rockbox folder_advance_list txt Play Shuffled Starts playback with the selected directories in random order Tracks within a directory will be played in normal order The plu...

Page 182: ...d textually LED resistance LED resistance calculator is used to determine the resistor necessary to light an LED safely at a given voltage First select the voltage that the LED will use the first option is the most common and a safe bet and the current that it will draw likewise with the first option Then use the onscreen keyboard to type in the supply voltage and if selected the custom forward cu...

Page 183: ...To swap them click on the background colour To edit the foreground colour click on it Preset Palette Several preset colours are available Clicking on one changes the fore ground of the Colour Picker to the selected colour Pencil Draws as you move the cursor You can change the brush size with the Menu option Brush Size Use the Select key to toggle the tool while editing the image Selection tool All...

Page 184: ...t file If it has not been saved before you will be given a chance to name it and choose the saving location Set Width Allows you to change the width of the image Border to indicate the width will be shown but it doesn t affect drawing Set Height Allows you to change the height of the image Border to indicate the height will be shown but it doesn t affect drawing Brush speed Changes the speed at wh...

Page 185: ... brush and selects objects 11 4 21 Stats Figure 11 58 The stats plugin The stats plugin counts the directories and files the total number as well as the number of audio playlist image and video files on your player Press Power or Long Power to abort counting and exit the plugin Press it again to quit after counting has finished The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 186: ...wn Scroll through lap times 11 4 23 Text Editor This plugin allows you to view and edit simple text documents on your DAP You can view files by using Open with from the Context Menu see section 4 1 2 page 25 Usage If you start the Text Editor from the plugin browser you will be greeted with a blank screen When started from the Open with menu item your file should be shown on the The Rockbox manual...

Page 187: ...hted text line or insert a new one using the Item Menu When finished editing exit the Text Editor You ll be shown a list of save options Note When you have not changed the file the Text Editor will quit immediately b Key Remote Key Action Select or Right Forward Edit Line Select Character Left or Power Rewind Exit Abort Editing Menu Menu Show Item Menu Long Select Long Menu Delete Line The Rockbox...

Page 188: ...following configuration example will change the main menu so that it will contain only the items for the file browser for resuming the playback and for changing the settings the latter will be added automatically Example root menu order files wps To reset the menu items to the default use root menu order i e use a hyphen instead of items This configuration entry can only be created and edited with...

Page 189: ...lename must be a maximum of 24 characters long If your language is not yet supported and you want to write your own language file find the instructions on the Rockbox website ZLangFiles 12 1 5 Changing Filetype Colours Rockbox has the capability to modify the File Browser to show files of different types in different colours depending on the file extension Set up There are two steps to changing th...

Page 190: ...irectory and then activate the config file from the menu as normal Settings Theme Settings Browse Theme Files Editing The built in Text Editor see section 11 4 23 page 186 automatically understands the colours file format but an external text editor can also be used To edit the colours file using Rockbox play it in the File Browser The file will open in the Text Editor Upon selecting a line the fo...

Page 191: ...the left of the screen and 20px from the top of the screen It is 100px wide and 150px high The font and the foreground background colours are defined in the theme cfg file or in the Theme Settings menu 12 2 Configuring the Theme 12 2 1 Themeing General Info There are various different aspects of the Rockbox interface that can be themed the WPS or While Playing Screen the FMS or FM Screen if the pl...

Page 192: ...will be ignored Note Keep in mind that your player s resolution is 240 320 16 with the last number b giving the colour depth in bits when designing your own WPS or if you use a WPS designed for another target Viewports By default a viewport filling the whole screen contains all the elements defined in each theme file The elements in this viewport are displayed with the same background foreground c...

Page 193: ... their default values Note The correct number of commas with hyphens in blank fields are still needed b Example V 12 20 1 Vf 000000 Vb FFFFFF Vg FFC0CB FF0000 FFFF00 sThis viewport is displayed permanently It starts 12px from the left and s20px from the top of the screen and fills the rest of the screen from sthat point The lines will scroll if this text does not fit in the viewport sThe user font...

Page 194: ...fier is a single lowercase letter a z and the parameters use the same logic as the V tag explained above Vd identifier Display the identifier viewport Viewports can share identifiers so that you can display multiple viewports with one Vd line Example C Vd a Vd b Vl a 10 10 50 50 Cl 0 0 50 50 c c Cd Vl a 0 70 70 14 1 s acThere you have it Album art Vl b 20 14 50 14 1 Vf ff0000 Vb ffffff t 1 acWarni...

Page 195: ... and the WPS but you can use multiple fonts in each of the individual screens Fl id filename glyphs id is the number you want to use in viewport declarations 0 and 1 are reserved and so can t be used filename is the font filename to load Fonts should be stored in rockbox fonts glyphs is an optional specification of how many unique glyphs to store in memory Default is from the system setting Glyphs...

Page 196: ...ups or sublines Each subline will be displayed in succession on the line for a specified time alternating continuously through each defined subline Items on a line are broken into sublines with the semicolon character The display time for each subline defaults to 2 seconds unless modified by using the t tag to specify an alternate time in seconds and optional tenths of a second for the subline to ...

Page 197: ...ges You can have as many as 52 images in your WPS There are various ways of displaying images 1 Load and always show the image using the x tag 2 Preload the image with xl and show it with xd This way you can have your images displayed conditionally 3 Load an image and show as backdrop using the X tag The image must be of the same exact dimensions as your display Example on background image use Exa...

Page 198: ...ough headphones See section 12 3 2 page 198 below for an explanation of the format for configuration files See section 12 3 3 page 199 for an explanation of how to create edit and load configuration files 12 3 2 Specifications for cfg Files The Rockbox configuration file is a plain text file so once you use the Save cfg file option to create the file you can edit the file on your computer using an...

Page 199: ...g 12 3 3 The Manage Settings menu The Manage Settings menu can be found in the Main Menu The Manage Set tings menu allows you to save and load cfg files Browse cfg Files Opens the File Browser in the rockbox directory and displays all cfg configuration files Selecting a cfg file will cause Rockbox to load the settings contained in that file Pressing Left or Power will exit back to the Manage Setti...

Page 200: ...essing or using effective audio codecs The following provides a short overview of the most relevant settings and rules of thumb 12 5 1 Display backlight The active backlight consumes a lot of power Therefore choose a setting that disables the backlight after timeout for setting Backlight see section 8 4 page 66 Avoid having the backlight enabled all the time Activating selectivebacklight section 8...

Page 201: ... different codec s performance on different players can be found at ZCodecPerformanceComparison Your target uses a hard disk which consumes a large amount of power while spinning up to several hundred mA The less often the hard disk needs to spin up for buffering and the shorter the buffering duration is the lower is the power consumption Therefore the bitrate of the audio files does have an impac...

Page 202: ...Appendix A File formats 202 The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 203: ...cue View the cuesheet file Font fnt Change the user interface font to this one Rockbox firmware gigabeat Load the new firmware with ROLO Image jpg View the JPEG image Link link Display list of target files and di rectories selecting one jumps to the target See section 11 3 1 page 142 Language File lng Load the language file Playlist m3u m3u8 Load the playlist and start playing the first file Video...

Page 204: ... 1 2 3 Musepack mpc Supports SV7 and SV8 in mono stereo OGG Vorbis ogg oga Playback of some old floor 0 files may fail on low memory targets Files with album art larger than available RAM will be skipped Chained Ogg files are not supported Sony Audio oma aa3 rm ra rmvb Supports ATRAC3 RealAudio rm ra rmvb Supports RealAudio G2 Cook Speex spx Dialogic telephony type vox Windows Media Audio Standard...

Page 205: ...ssless Audio flac Supports multichannel playback in cluding downmixing to stereo Apple Lossless m4a mp4 Shorten shn Seeking not supported True Audio tta Wave64 w64 Supports same formats as Wave form audio format Waveform audio format wav Linear PCM 8 16 24 32 bit IEEE float 32 64 bit ITU T G 711 a law µ law Microsoft ADPCM In tel DVI ADPCM IMA ADPCM 2 3 4 5 bit Dialogic OKI AD PCM YAMAHA ADPCM Ado...

Page 206: ...nstead of seconds MSX Konami Sound System kss Progress bar and seek use subtracks instead of seconds SMS GG CV Sound Format sgc Supports Sega Mas ter System and Game Gear Sound Format Progress bar and seek use subtracks instead of seconds Video Game Music Format vgm Gzipped Video Game Music Format vgz MOD mod NES Sound Format nsf nsfe Progress bar and seek use subtracks instead of seconds Atari SA...

Page 207: ... x x Wavpack x x x Atari Sound Format x Synthetic music Mobile Application Format x x Game Boy Sound Format x AY Sound Chip Music x Hudson Entertainment System Sound Format x MSX Konami Sound System x SMS GG CV Sound Format x Video Game Music Format x x Gzipped Video Game Music Format x x MOD x NES Sound Format x Atari SAP x Sound Interface Device x SPC700 x Note The seek implementations of NES So...

Page 208: ...v asf Codec specific mmf mod nsf nsfe sap sid spc gbs ay kss sgc vgm None a52 ac3 adx oma aa3 aif aiff au snd shn vox w64 wav cmc cm3 cmr cms dmc dlt mpt mpd hes vgz B 2 1 Featureset for generic metadata tags Feature ID3 APE Vorbis MP4 ASF Embedded albumart bmp Embedded albumart jpg x x x x Embedded albumart png Embedded cuesheet x x Replaygain information x x x x x Title string x x x x x Artist s...

Page 209: ...f nsfe gbs ay sgc vgm Genre tta spc sap Disc tta Track tta Year spc sid sap Composer mmf Comment spc rm ra rmvb vgm Albumartist None Grouping None B 2 3 Limitations of metadata handling 1 Multiple tags e g for Genre are not supported The first tag item of a set of multiple tags is used 2 Only one tag type is supported for each audio format 3 Overall there are 900 bytes available to load metadata s...

Page 210: ...lti scan JPEG files JPEG files must consist of a single scan with interleaved components as progressive and multi scan images require much more memory to decode C 2 Where to put album art The pictures can be named a number of different ways and placed to a number of different locations You can have pictures specific to the file or the album or use a generic picture You can place the picture in the...

Page 211: ...e bmp or albumartist albumtitle bmp Doublequotes will be replaced by single quotes If no album artist is set artist will be used instead See ZAlbumArt in the wiki for programs that will help you automate the process of putting album art on your player The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 212: ...h will not be shown in the WPS D 2 Hardware Capabilities Tag Description cc Check for presence of a real time clock returns c when used unconditionally tp Does this target have a radio Tp Indicates that the target has a touchscreen With the above tags it is possible to find out about the presence of certain hardware and make the theme adapt to it This can be very useful for designing a theme that ...

Page 213: ... Description V x y width height font Vf fgcolour Vb bgcolour Vg start end text See section 12 2 2 Vs mode param See section 12 2 2 Vl identifier Preloads a viewport for later display identifier is a single lowercase letter a z and the parameters use the same logic as the V tag explained above Vd identifier Display the identifier viewport E g C Vd a Vd b will show viewport a if album art is found a...

Page 214: ... conditional bl 1 0 1 2 N where the value 1 is used when the battery level isn t known it usually is The value N is only used when the battery level is ex actly 100 percent An image can also be used the propor tion of the image shown corresponds to the battery level bl x y width height image bmp bv The battery level in volts bt Estimated battery time left bp p if the charger is connected only on t...

Page 215: ...aache ay gbs hes sgc vgm kss unknown The codec or der is as shown above ff File Frequency in Hz fk File Frequency in kHz fm File Name fn File Name without extension fp File Path fs File Size in Kilobytes fv avg if variable bit rate or empty string if constant bit rate d N N th segment from the end of the file s directory N can be 1 2 3 Example for the d N commands If the file is Rock Kent Isola 11...

Page 216: ... pv Current volume in dB Can also be used in a conditional pv Mute 0 dB Above 0 dB Mute is 0 volume is the values between Mute and max 0 dB is max volume and Above 0 dB is amplified volume This can also be used like pb to provide a continuous scale pv x y width height image bmp pS Track is starting An optional number gives how many seconds the tag remains true for after the start of the track The ...

Page 217: ...ylist position then either the track title from the tags or the filename The viewer will display as many tracks as will fit in the viewport D 11 Runtime Database Tag Description rp Song playcount rr Song rating 0 10 This tag can also be used in a conditional tag rr 0 1 2 3 4 5 6 7 8 9 10 ra Autoscore for the song D 12 Sound DSP settings Tag Description Sp Current playback pitch xf Crossfade settin...

Page 218: ... All One Shuffle A B D 16 Playback Mode Tag Description mp Play status 0 4 in the order Stop Play Pause Fast For ward Rewind Recording Recording paused FM Radio play ing FM Radio muted Example mp Stop Play Pause Ffwd Rew Rec Rec pause FM FM pause D 17 Current Screen Tag Description cs The current screen 1 20 in the order shown below The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 219: ... values will never be returned Examples You are in the cs Main menu WPS Recording screen FM Radio screen if cs 2 This is the WPS D 18 List Title sbs only Tag Description Lt Title text Should be used in a conditional so that non list screens don t show a title when they shouldn t Li Title icon This uses the same order as custom icons see ZCustomIcons in the wiki except that here 0 is no icon This t...

Page 220: ...can produce neat effects when used with conditional viewports Example mv 2 5 Volume changing pv The example above will display the text Volume changing if the volume is being changed and 2 5 seconds after the volume button has been released After that it will display the volume value D 20 Settings Tag Description St setting name The value of the Rockbox setting with the specified name See section ...

Page 221: ... if both x and y are not speci fied nimages optional number of sub images tiled vertically of the same height contained in the bitmap Default is 1 xd n i tag offset Display a preloaded image n image ID as it was specified in x or xl i optional number of the sub image to display a z for 1 26 and A Z for 27 52 ignored when tag is used Only useable if the ID is a single letter By default the first i ...

Page 222: ...on your player they can be displayed as follows Tag Description Cl x y maxwidth maxheight hor_align vert_align Define the settings for album art x x coordinate y y coordinate maxwidth Maximum height maxheight Maximum width hor_align Horizontal alignment enter as l c or r for left centre or right Centre is default vert_align Vertical alignment enter as t c or b for top centre or bottom Centre is de...

Page 223: ...he text right aR Align the text right or to the left if RTL language is in use ax The next tag should follow the set language direction When prepended to a viewport declaration the viewport will be horizontally mirrored if the user language is set to a RTL language Currently the Cl V and Vl tags support this Sr Use as a conditional to define options for left to right or right to left languages Sr ...

Page 224: ... parameters are true or tag1 tag2 tagN Logical or operator Will be evaluate to true if any of the tag parameters are true Examples of the if tag if pv 0 Clipping possible Volume OK will display Clipping possible if the volume is higher than or equal to 0 dB Volume OK if it is lower if ia Ia same artist this artist and the next artist are the same Note When performing a comparison against a string ...

Page 225: ...name cb Month name cu Day of week from 1 to 7 1 is Monday cw Day of week from 0 to 6 0 is Sunday D 26 Text Translation Tag Description Sx English Display the translation of English in the current language English must be a phrase used in the language file It should match the Source line in the language file Note checkwps cannot verify that the string is correct so please check on either the b simu...

Page 226: ... the desired image backdrop draw a preloaded image under the bar The full image will be displayed and must be the same size as the bar This must be followed by the label of the desired image nofill don t draw the bar only its frame for use with the slider option noborder don t draw the border for image less bars instead maximise the filling over the specified area This doesn t work for bars which ...

Page 227: ...sent it will assume the substring is a number so it can be used with conditionals i e cM 0 is the first conditional option Tag Description The character The character The character The character The character The character The character The character The character s Indicate that the line should scroll Can occur anywhere in a line given that the text is displayed see conditionals above You can spe...

Page 228: ... 30s 1min 2min 3min 5min 10min N A volume fade on off N A sort case on off N A show files all supported music playlists N A show filename exts off on unknown view_all N A follow playlist on off N A playlist viewer icons on off N A playlist viewer indices on off N A playlist viewer track display track name full path N A recursive directory insert on off ask N A scroll speed 1 to 25 Hz scroll delay ...

Page 229: ... way to get ranges from config h mAh car adapter mode on off N A qs top any setting name for none N A qs bottom any setting name for none N A qs left any setting name for none N A qs right any setting name for none N A shortcuts instead of quickscreen off on N A idle poweroff off 1 2 3 4 5 6 7 8 9 10 15 30 45 60 min sleeptimer duration 5 to 300 in steps of 5 min sleeptimer on startup off on N A ke...

Page 230: ...en erasing dynamic playlist on off N A cuesheet support on off N A folder navigation off on random N A constrain next folder off on N A gather runtime data off on N A skip length outro track 1s 2s 3s 5s 7s 10s 15s 20s 1min 90s 2min 3min 5min 10min 15min N A prevent track skip on off N A start in screen previous root files dB wps menu bookmarks N A playlist catalog directory path to dir N A list_ac...

Page 231: ...in Hz q 0 to 64 gain 240 to 240 eq peak filter 6 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 7 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 8 cutoff in Hz q 0 to 64 gain 240 to 240 eq high shelf filter cutoff in Hz q 0 to 64 gain 240 to 240 0 1 dB dithering enabled on off N A timestretch enabled on off N A compressor threshold 0 to 24 3 dB compressor makeup gain off auto N A com...

Page 232: ... graphic numeric N A battery display graphic numeric N A font path filename fnt N A kbd path filename kbd N A flip display on off N A selector type pointer bar inverse bar color bar gradient N A show icons on off N A iconset path filename bmp N A viewers iconset path filename bmp N A backdrop path filename bmp N A foreground colour 000000 to FFFFFF RRGGBB background colour 000000 to FFFFFF RRGGBB ...

Page 233: ...Appendix F Menu Overview 233 F Menu Overview include an overview of the menu structure here The Rockbox manual version 3 14 Toshiba Gigabeat F and X Series ...

Page 234: ...what happened Whether the problem is repeatable or a one time occurrence All relevant data regarding the problem such as playlists MP3 files etc IMPORTANT G 2 Feature ideas To suggest an idea for a feature or to read those made by others see http forums rockbox org index php board 49 0 Please keep in mind that this forum is for the dis cussion of feature ideas they are not requests and there is no...

Page 235: ...and them Add scandisk like features It would be a very slow operation that would drain the batteries and take a lot of useful ram for something that is much better and faster done when connected to a host computer Alphabetical list skipping Skipping around the lists by jumping letters i e skip all C s and go straight to the first D This isn t feasible with the current list implementation if you re...

Page 236: ...c Dang Ngoc Pierre De lore Huw Smith Garrett Derner Barry McIntosh Leslie Donald son Lee Pilgrim Zakk Roberts Francois Boucher Matthias Wien tapper Brent Coutts Jens Arnold Gerald Vanbaren Christi Scarbor ough Steve Cundari Mat Holton Jan Gajdos Antoine Cellerier Brian King Jiri Jurecek Jacob Erl beck Jean Philippe Bernardy Dave Hooper Jonas Häggqvist Thom Johansen Rinat Zakirov Manuel Dejonghe Ma...

Page 237: ...Adam Gashlin Robert Kukla David Quesada Jared Stafford Martin Hensel Stéphane Doyon Austin Appel Andre Smith Travis Hyyppa Ian Webber Pavel Gnelitsa Lutz Böhne Will Robertson Robert Carboneau Ye Wei Bryan Childs Mike Schmitt Chris Taylor Tobias Langhoff Steve Gotthardt Greg White Mattieu Favréaux Malcolm Tyrrell Piotr Jafis zow Gary Allen John BouAntoun Tomasz Mon Jakub Matoušek Al bert Veli Chris...

Page 238: ... Eric Lassauge François Dinel Francesco Rigoni Joël Puik Klaas Bosteels Teruaki Kawashima Marcin Łukasik Le Jin Alex Ben nee Stéphane Quertinmont Bartosz Fabianowski Adam Hogan Andrew Mahone Anton Veretenenko Vi cente Ibarra Rui Araújo Brian Cloutier Olivier Barbut Yoshi hisa Uchida Sanggon Lee Kaspar Rothenfußer Ryan Press Craig El liott Kenderes Tamas Eric Shat tow Joshua Simmons Sei Aoyumi Mart...

Page 239: ...zhik Desu Rozen Olivier Kaloudoff Kessia Pinheiro Jean Louis Biasini Lorenzo Miori James Hunt Artur Juraszek Wieland Hoffmann Nathan Ko rth Igor Petelin Cástor Muñoz Albert Barca Fukuda Takafumi Dimitar Dimitrov Osborne Jacobs Marty Miller Eduardo Gonzalez Enric Morales Mateusz Renkiewicz Dario Castellarin Thiago Kenji Okada Manuel Flury Vanja Cvelbar Richard Quirk Kirill Stryaponoff Roman Poltora...

Page 240: ...a copyleft license designed for free software We have designed this License in order to use it for manuals for free software be cause free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or whether it is pu...

Page 241: ... is available to the general public that is suitable for re vising the document straightforwardly with generic text editors or for images composed of pixels generic paint programs or for drawings some widely available drawing edi tor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters A copy made in an otherwi...

Page 242: ...r the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cover a...

Page 243: ...ersion if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities responsible for authorship of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you from this requirement C State on the Title pag...

Page 244: ...t matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section Entitled Endorsements p...

Page 245: ...leased under this License and replace the individual copies of this License in the various docu ments with a single copy that is included in the collection provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individ ually under this License provided you inse...

Page 246: ...e the Document is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Doc umentation License from ti...

Page 247: ...Front Cover Texts and Back Cover Texts replace the with Texts line with this with the Invariant Sections being LIST THEIR TITLES with the Front Cover Texts being LIST and with the Back Cover Texts being LIST If you have Invariant Sections without Cover Texts or some other combination of the three merge those two alternatives to suit the situation If your document contains nontrivial examples of pr...

Page 248: ... forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the software or if you modify it For example if you distribute copies of such a program whether gratis or for a fee you must give the recipients all the rights that you have You must make sure that they too receive or can get the...

Page 249: ...act all the notices that refer to this License and to the absence of any warranty and give any other recipients of the Program a copy of this License along with the Program You may charge a fee for the physical act of transferring a copy and you may at your option offer warranty protection in exchange for a fee 2 You may modify your copy or copies of the Program or any portion of it thus forming a...

Page 250: ...so do one of the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or b Accompany it with a written offer valid for at least three years to give any third party for a charge no more than your cost of physically performing source distribution ...

Page 251: ...onditions You may not impose any further restrictions on the recipients exercise of the rights granted herein You are not responsible for enforcing compliance by third parties to this License 7 If as a consequence of a court judgment or allegation of patent infringement or for any other reason not limited to patent issues conditions are imposed on you whether by court order agreement or otherwise ...

Page 252: ...ion or of any later version published by the Free Software Foundation If the Program does not specify a version number of this License you may choose any version ever published by the Free Software Foundation 10 If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different write to the author to ask for permission For software which is copyrig...

Page 253: ...st the copyright line and a pointer to where the full notice is found one line to give the program s name and a brief idea of what it does Copyright C year name of author This program is free software you can redistribute it and or modify it un der the terms of the GNU General Public License as published by the Free Software Foundation either version 2 of the License or at your option any later ve...

Page 254: ...f any to sign a copyright disclaimer for the program if necessary Here is a sample alter the names Yoyodyne Inc hereby disclaims all copyright interest in the program Gnomovision which makes passes at compilers written by James Hacker signature of Ty Coon 1 April 1989 Ty Coon President of Vice This General Public License does not permit incorporating your program into propri etary programs If your...

Reviews: