background image

Appendix E. Changelog

159

?

AIFF

?

FLAC

?

ALAC

?

Wavpack

?

Shorten

?

Monkey’s Audio

Other codecs

?

SID

?

MOD

?

NSF, NSFE

?

SPC

?

MIDI

?

SAP

The Rockbox manual

Toshiba Gigabeat F Series

Summary of Contents for Rockbox F Series

Page 1: ...The Rockbox Manual for Toshiba Gigabeat F Series rockbox org December 23 2008 ...

Page 2: ...se Maria Garcia Valdecasas Bernal Peter Schlenker Version r19569 081223 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 ...

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

Page 4: ...Hints 36 5 The Main Menu 37 5 1 Introducing the Main Menu 37 5 2 Navigating the Main Menu 38 5 3 Recent Bookmarks 38 5 4 Files 38 5 5 Database 38 5 6 Now Playing Resume Playback 38 5 7 Settings 39 5 7 1 Sound Settings 39 5 7 2 Playback Settings 39 5 7 3 General Settings 39 5 7 4 Manage Settings 39 5 7 5 Theme Settings 39 5 8 Playlist 39 5 9 Plugins 40 5 10 System 40 5 11 Quick Screen 41 6 Sound Se...

Page 5: ...ort 52 7 15 Skip Length 53 8 General Settings 54 8 1 Playlist 54 8 2 File View 54 8 3 Database 56 8 4 Display 56 8 5 System 58 8 5 1 Start Screen 58 8 5 2 Battery 58 8 5 3 Disk 59 8 5 4 Idle Poweroff 59 8 5 5 Limits 59 8 5 6 Car Adapter Mode 60 8 5 7 Button Light Timeout 60 8 5 8 Button Light Brightness 60 8 6 Bookmarking 60 8 7 Language 61 8 8 Voice 62 9 Theme Settings 64 10 Plugins 66 10 1 Games...

Page 6: ... 91 10 1 24Star 92 10 1 25Sudoku 93 10 1 26Wormlet 95 10 1 27Xobox 98 10 2 Demos 99 10 2 1 Bounce 99 10 2 2 Credits 100 10 2 3 Cube 100 10 2 4 Demystify 101 10 2 5 Fire 102 10 2 6 Logo 102 10 2 7 Mandelbrot 103 10 2 8 Mosaique 104 10 2 9 Oscilloscope 105 10 2 10Plasma 106 10 2 11Snow 107 10 2 12Starfield 108 10 2 13VU meter 109 10 3 Viewers 109 10 3 1 Shortcuts 110 10 3 2 Chip 8 Emulator 111 10 3 ...

Page 7: ... 133 11 1 Customising the User Interface 133 11 1 1 Getting Extras 133 11 1 2 Loading Fonts 133 11 1 3 Loading Languages 133 11 1 4 Changing Colours 133 11 1 5 Changing Filetype Colours 134 11 1 6 Loading Backdrops 134 11 2 Configuring the WPS 134 11 2 1 WPS General Info 134 11 2 2 WPS Build Your Own 134 11 3 Managing Rockbox Settings 137 11 3 1 Introduction to cfg Files 137 11 3 2 Specifications ...

Page 8: ...Tags 149 C Config file options 150 D User feedback 154 D 1 Bug reports 154 D 1 1 Rules for submitting new bug reports 154 D 2 Feature ideas 154 D 2 1 Rules for submitting a new feature idea 154 D 2 2 Features we will not implement 155 E Changelog 156 E 1 What is new since v3 0 156 E 1 1 New features 156 E 1 2 Enhancements 156 E 2 What is new since v2 5 156 E 2 1 New features 156 E 2 2 Enhancements...

Page 9: ... put into making Rockbox sound the best it can and improvements are constantly being made All models have access to a large number of plugins including many games applications and graphical demos You can load 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...

Page 10: ... 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 For easier b finding of notes we have put this an icon in the margin like here Notes are used to mark information that could help you or indicate a possible weirdness in rockbox that would be explained Warning This is a warning In contrast to notes me...

Page 11: ...ox bootloader is loaded from disk by the Toshiba bootloader It is responsible for loading the Rockbox firmware and for providing the dual boot function It directly replaces the Toshiba firmware in the player s boot sequence Note Dual boot does not currently work on the Gigabeat b The Rockbox firmware Similar to the Toshiba firmware most of the Rockbox code is contained in a build that resides on y...

Page 12: ...ng such archive files Win dows XP has built in support for zip files and presents them to you as directories unless you have installed a third party program that handles compressed files For other operating systems this may vary If the zip file format is not recognised on your computer you can find a program to handle them at http www info zip org or http sevenzip sf net both of which can be downl...

Page 13: ...ble release free of known critical bugs The current stable release of Rockbox version 3 1 is available at http www rockbox org download Current Build The current build is built at each source code change to the Rockbox SVN repository and represents the current state of Rockbox development This means that the build could contain bugs but most of the time is safe to use You can download the current ...

Page 14: ...link in the menu on the Rockbox website While the current builds and daily builds change frequently the fonts package rarely changes and is therefore not included in these builds When installing Rockbox for the first time you should install the fonts package The release version on the other hand does not change so fonts are included with it 1 Download the fonts package from the link above 2 Take t...

Page 15: ...itch back from off to on 2 3 3 Enabling Speech Support optional If you wish to use speech support you will also need a voice file English ones are available from http www rockbox org daily shtml Download the voice package for your player and unzip it directly to the root of your player You should now find an english voice in the rockbox langs directory on your player Voice menus are enabled by def...

Page 16: ...stallation You can uninstall Rockbox automatically by using Rockbox Utility If you installed Rockbox manually you can still use Rockbox Utility for uninstallation but will not be able to do this selectively 2 6 2 Manual Uninstallation If you wish to clean up your disk you may also wish to delete the rockbox directory and its contents Turn the Toshiba off Turn the player back on and the original To...

Page 17: ... screen is a cross shaped touch sensitive pad which contains the Up Down Left and Right controls On the top of the unit from left to right are the power socket the Hold switch and the headphone socket The Hold switch puts the player into hold mode when it is switched to the right of the unit The buttons will have no effect when this is the case Starting from the left hand side on the bottom of the...

Page 18: ... switch until the player shuts off or reboots 3 1 3 Putting music on your player With the player connected to the computer as an MSC UMS device like a USB Drive music files can be put on the player via any standard file transfer method that you would use to copy files between drives e g Drag n Drop The default directory structure that is assumed by some parts of Rockbox album art searching and mis...

Page 19: ...riented This means that every time you play an audio file a so called dynamic playlist is generated unless you play a saved playlist You can modify the dynamic playlist while playing and also save it to a file If you do not want to use playlists you can simply play your files directory based Playlists are covered in detail in section 4 4 page 32 Menu From the menu you can customise Rockbox Rockbox...

Page 20: ...137 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 Internet make sure you have the needed fonts installed as otherwise the theme may get displayed garbled 3 3 Charging The player can be po...

Page 21: ...the music 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 55 for more information on the Show Files setting Note The File Bro...

Page 22: ...ect or Right Executes the default action on the se lected file or enters a directory A If there is an audio file playing returns to the While Playing Screen WPS without stopping playback Power Stops audio playback Long Select Enter the Context Menu Menu Enter the Main Menu Long Menu Switches to the Quick Screen see sec tion 5 11 page 41 4 1 2 Context Menu Figure 4 2 The Context Menu The Rockbox ma...

Page 23: ...y Delete Deletes the currently selected file This option applies only to files and not to directories Rockbox will ask for confirmation before deleting a file Press Select to confirm deletion or any other key to cancel Delete Directory Deletes the currently selected directory and all of the files and subdi rectories it may contain Deleted directories cannot be recovered Use this feature with cauti...

Page 24: ...imply bring you to it s location in the File Browser 4 1 3 Virtual Keyboard Figure 4 3 The virtual keyboard This is the virtual keyboard that is used when entering text in Rockbox for example when renaming a file or creating a new directory The virtual keyboard can be easily changed by making a text file with the required layout More information on how to achieve this can be found on the Rockbox w...

Page 25: ... the database uses to sort the songs can be completely customised More information on how to achieve this can be found on the Rockbox website at ZDataBase 4 2 2 Initializing the Database The first time you use the database Rockbox will scan your disk for audio files This can take quite a while depending on the number of files on your player This scan happens in the background so you can choose to ...

Page 26: ... enabled or not Initialize Now You can force Rockbox to rescan your disk for tagged files by using the Initialize Now function in the Database Menu Warning Initialize Now removes all database files removing runtimedb data also and rebuilds the database from scratch Update Now Update now causes the database to detect new and deleted files Note Unlike the Auto Update function Update Now will update ...

Page 27: ...u 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 files in dir browser setting b Settings General Settings System Limits in order to view long lists of tracks in the ID3 database browser There is no option to turn off database completely If you do not want to use it just do not...

Page 28: ...ystem length 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 item can be turned on or off independently Refer to ...

Page 29: ...o previous track Long Left Rewind in track Right Go to next track Long Right Fast forward in track A Toggle play pause Power Stop playback Select Return to the File Browser Long Select Enter WPS Context Menu Menu Enter Main Menu Long Menu Switches to the Quick Screen see sec tion 5 11 page 41 A Up Down Show Pitch Screen see section 4 3 3 page 32 A Menu Enter ID3 Viewer A Right or Short Right Long ...

Page 30: ...llows you quick access to some often used functions Playlist The Playlist submenu allows you to view save search and reshuffle the current playlist To change settings for the Playlist Viewer press Menu while viewing the playlist to bring up the Playlist Viewer Menu Playlist Viewer Menu Show Icons This toggles display of the icon for the currently selected playlist entry and the icon for moving a p...

Page 31: ...ffle repeat party mode study mode and other settings affecting the playback of your music Rating The menu entry is only shown if Gather Runtime Information is enabled It allows the asignment of a personal rating value 0 10 to a track which can be displayed in the WPS and used in the Database browser Press Right to increment the value The value wraps at 10 Bookmarks This allows you to create a book...

Page 32: ...is an octave lower than the normal pitch 200 means double playback speed and the pitch that is an octave higher than the normal pitch It is not possible to change the pitch without changing the playback speed and vice versa Changing the pitch can be done in two modes procentual and semitone Initially after the player is switched on procentual mode is active Key Action Menu Toggle pitch changing mo...

Page 33: ...he only difference between Insert and Queue is that the Queue option removes the song from the playlist once it has been played and the Insert option does not 4 4 2 Creating playlists Rockbox can create playlists in four different ways By selecting playing a song from the File Browser Whenever a song is selected from the File Browser with Select or Right Rockbox will automatically create a playlis...

Page 34: ... in the Playlist Options menu found in the Main Menu The created playlist will be named root m3u and saved in the root of your player s disk 4 4 3 Adding music to playlists Adding music to a dynamic playlist Figure 4 5 The Playlist Submenu The Playlist Submenu is a submenu in the Context Menu see section 4 1 2 page 22 it allows you to put tracks into a dynamic playlist If there is no music current...

Page 35: ...ying track with track s Current playing track is queued The Playlist Submenu can 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 co...

Page 36: ...Menu and select Save Current Playlist Either method will bring you to the Virtual Keyboard see section 4 1 3 page 24 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 T...

Page 37: ...ain Menu press the Menu button All settings are stored on the unit However Rockbox does not spin up the disk solely for the purpose of saving settings Instead Rockbox will save settings when it spins up the disk the next time for example when refilling the MP3 buffer or navigating through the File Browser Changes to settings may therefore not be saved unless the player is shut down safely see sect...

Page 38: ...ore details on configuring bookmarking in Rockbox Note This entry is not shown in the Main Menu when the option is off and the option b is off by default 5 4 Files Browse the files on your player see section 4 1 page 21 5 5 Database Browse by the meta data in your audio files see section 4 2 page 25 5 6 Now Playing Resume Playback Go to the While Playing Screen and resume if music playback is stop...

Page 39: ...details of this menu are covered in section 7 page 48 5 7 3 General Settings The General Settings menu allows you to customise the way Rockbox looks and the way it plays music The details of this menu are covered in section 8 page 54 5 7 4 Manage Settings The Manage Settings option allows the saving and re loading of user configuration settings browsing the hard drive for alternate firmwares and f...

Page 40: ...tery voltage level and estimated time remaining disk total space and disk free space Time and Date Time related menu options Pressing Long Select will voice the cur rent time if voice support is enabled Set Time Date Set current time and date Sleep Timer The Sleep Timer powers off your player after playing for a given time It can be set from Off to 5 hours in 5 minute steps The Sleep Timer is rese...

Page 41: ...at a few of the more commonly used settings are available from the Quick Screen The Quick Screen screen is accessed with Long Menu and exited with Menu It allows rapid access to the Shuffle and Repeat modes section page and the Show Files option section 8 2 page 55 The Rockbox manual Toshiba Gigabeat F Series ...

Page 42: ... your music Like most professional audio gear and many consumer audio products Rockbox uses a decibel scale where 0 dB is a refer ence that indicates the maximum volume that the player can produce without possible distortion clipping All values lower than this reference will be negative and yield a progressively softer volume The volume can be adjusted from a minimum of 73 dB to a maximum of 6 dB ...

Page 43: ... what manner they will be combined Available options are Setting Description Stereo Leave the audio signal unmodified Mono Combine both channels and send the resulting signal to both stereo channels resulting in a monophonic output Custom Allows you to manually specify a stereo width with the Stereo Width setting described later in this chapter Mono Left Plays the left channel in both stereo chann...

Page 44: ... an algorithm to feed a delayed and filtered portion of the signal from the right channel into the left channel and vice versa in order to simulate the spatial cues that the ear and brain receive when listening to a set of loudspeakers placed in front of the listener The result is a more natural stereo image that can be especially appreciated in older rock and jazz records where one instrument is ...

Page 45: ...he low shelf filter boosts or lowers all frequencies below a certain frequency limit much like what a bass control found on ordinary stereo systems does Adjust the cutoff frequency parameter to decide where the shelv ing starts to take effect For example a cutoff frequency of 50 Hz will adjust only very low frequencies A cutoff frequency of 200 Hz on the other hand will adjust a much wider range o...

Page 46: ...h end of the frequency spectrum rather than the low end As a general guide EQ band 0 should be used for low frequencies EQ bands 1 through 3 should be used for mids and EQ band 4 should be used for highs Enable EQ This option controls whether the EQ is on or off Graphical EQ This option brings up a graphic EQ screen which allows adjustment of each of the three parameters described above gain cente...

Page 47: ...t depth to another is simply discarding all the surplus bits This is the default behaviour and adds distortion to the signal that will vary in character along with the desired sound Dithering adds low level noise to the signal prior to throwing away the surplus bits which gives the resulting signal a uniform noise floor which is independent of the sig nal Most people find this noise preferable to ...

Page 48: ...ion set to 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 betwe...

Page 49: ...an 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 ...

Page 50: ...tween 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 your music to fade out once the Fade Out Delay has ended Fade Out Mode If set to Crossfade one song will fade out and the next song will simultaneously fade in If set to Mix the ending song will continue to play as normal until its end while the starting s...

Page 51: ...formation 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 to Yes Reverts to album mode if Shuffle is set to No Pre amp This allows you to adjust the volume when replaygain is applied Replaygain often lowers the volume sometimes quite much so ...

Page 52: ...s option will disable the automatic resumption of playback at startup if the headphones are not connected to the player Note This requires Resume on Startup to be enabled b 7 13 Last fm Log Enables logging of your played tracks for submittal to http www last fm This service was formely known as Audioscrobbler When you enable this option you ll have to reboot to start the logging The log file is ca...

Page 53: ... audio tracks Skip Length changes the behavior of the Left and Right buttons so that they skip by a given number of minutes instead of skipping to a new track Note To skip tracks with this setting set to a time interval press Short Left Long b Right to go forward and Short Right Long Left to go back The Rockbox manual Toshiba Gigabeat F Series ...

Page 54: ... a dynamic 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 Fi...

Page 55: ...ag set are hidden Music The File Browser displays only directories playlists and the supported audio file formats Extensions are stripped Files and directories starting with or with the hidden flag set are hidden Playlists The File Browser displays only directories and playlists for simplified navigation Show Filename Extensions This option controls how file extensions are shown in the File Browse...

Page 56: ...backlight will be turned on and stay on while the Hold switch is engaged Caption Backlight This option turns on the backlight a number of seconds before the start of a new track and keeps it on for the same number of seconds after the beginning so that the display can be read to see song information The amount of time is determined by the value of the backlight timeout setting but is no less than ...

Page 57: ...en scroll should move for each step Paged Scrolling When set to Yes scrolling vertically on pages that surpass the screen size will page up down instead of simply changing lines This can be useful on slow displays Status Scrollbar Settings related to on screen status display and the scrollbar Scroll Bar Enables or disables the scroll bar at the left Status Bar Enables or disables the status bar at...

Page 58: ...eter Default Codepage A codepage describes the way extended characters that are not available within the ASCII character set are encoded ID3v1 tags do not have a codepage encoding contained so Rockbox needs to know what encoding has been used when generating these tags This should be ISO 8859 1 but to support lan guages outside Western Europe most applications use the setting of your operating sys...

Page 59: ... in the file browser by eliminating the slight pause between the time a navigation button is pressed and the time Rockbox responds Turning this setting on activates the directory cache and turning it off deactivates the directory cache Note The first time you enable the directory cache Rockbox will request a reboot b of the player and upon restarting take a few minutes to scan the drive After this...

Page 60: ... either manually or automatically with the Idle Poweroff function it must be powered up manually to resume playback 8 5 7 Button Light Timeout 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 ...

Page 61: ...ning of the track of or from the bookmark When the Load Last Bookmark option is set to No playback always starts from the beginning of the track and the user must play the bookmark or use the Load Bookmark function in the Main Menu while the file is playing to resume at the bookmarked location Maintain a list of Recently Used Bookmarks This list of Most Recent Bookmarks MRB s may be accessed throu...

Page 62: ... speak directory names You can use pre generated talk clips to have directory names spoken properly but you must enable this explicitly see below Use Directory talk Clips This option turns on the use of talk clips for directories On Use special pre recorded MP3 files dirname talk in each directory These must be generated in advance and are typically produced synthetically using a text to speech en...

Page 63: ...od set under Voice Filenames above Say File Type This option turns on voicing of file types when Voice Filenames is set to Spell or Numbers When Voice Directories is set to Spell Directory will be voiced after each spelled out directory Announce Battery 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 ...

Page 64: ...rowse the installed fonts on your player Selecting one will activate it See section 11 1 2 page 133 for further details about fonts Browse WPS files Opens the File Browser in the rockbox wps directory and displays all wps files Selecting one will activate it stop will exit back to the menu For further information about the WPS see section 4 3 page 28 For information about editing a wps file see se...

Page 65: ... for the gradient line selector bar and the colour used for the solid color line selector bar Secondary Colour Set the secondary colour used for the gradient line selec tor bar Text Colour Set the colour of the selected text when using the solid colour or the gradient colour line selection bars Background Colour Sets the background colour for the display Foreground Colour Sets the colour used for ...

Page 66: ...ckbox interface Most plugins will not interfere with music playback but some of them will stop playback while running Plugins have the file extension 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 10 1 Games See also the Chip 8 em...

Page 67: ...1 without going over or simply beat out the dealer for the best hand Although this may not seem difficult blackjack is a game renowned for the strategy involved This version includes the ability to split buy insurance and double down For the full set of rules to the game and other facinating information visit http www blackjackinfo com blackjack rules php The Rockbox manual Toshiba Gigabeat F Seri...

Page 68: ...and Select Double down Menu Save game Power Return to menu or cancel 10 1 2 BrickMania Figure 10 2 BrickMania BrickMania is a clone of the classic game Breakout The aim of the game is to destroy all the bricks by hitting them with the ball once or more Sometimes a special item falls down when you destroy a brick For a special item to take effect you must catch it with The Rockbox manual Toshiba Gi...

Page 69: ...Ball dies lose a life L Life Gain a life F Fire Allows 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 Action Left Right Moves the paddle Select Up Release the ball Fire Power Open menu Quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 70: ...e same type is formed The game is over when any bubbles on the board extend below the bottom line To make things more difficult the 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 Action Power Pause game Left Right Aim the bubble Select Fire bubble Menu Save game Power Exit to menu The Rockbox...

Page 71: ...f the game If the menu is invoked while in the viewer the user is allowed to select a new match from the same file or quit the game Force play while the computer 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 ...

Page 72: ...ls the ceiling or the floor How long can you fly your chopper Key Action Select Make chopper fly Menu Enter menu 10 1 6 Dice Dice is a simple dice rolling simulator Select number and type of dice to roll in a menu and start by choosing Roll Dice The result is shown as individual numbers as well as the total of the rolled dice Key Action A Roll dice again Power Quit The Rockbox manual Toshiba Gigab...

Page 73: ...y 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 doom2 wad or it may be used as an addon in Doom by placing it in the addons directory Menus Rockdoom Menu The Rockdoom menu is shown when D...

Page 74: ...lucency 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 color response statusbar InGame Main Menu This menu can only be accessed from within a running game and is displayed by New Game Start a new game Options In ...

Page 75: ...Change Weapon Playing the game After installation of the wad files is complete you can start the game 10 1 8 Flipit Figure 10 6 Flipit Flipping the colour of the token under the cursor also flips the tokens above below left and right of the cursor The aim is to end up with a screen containing tokens of only The Rockbox manual Toshiba Gigabeat F Series ...

Page 76: ...ple yet addicting game which involves swapping pairs of jewels in order to form connected segments of three or more of the same type The goal of the game is to score as many points as possible before running out of available moves Higher points are awarded to larger combos The game advances to the next level after every one hundred points and randomly clears several jewels The Rockbox manual Toshi...

Page 77: ...ngeon 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 The Rock...

Page 78: ...e aim of the game is to uncover all 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 accidental...

Page 79: ...isplay the current game status Power Exit the game 10 1 12 Pacbox Figure 10 10 Pacbox Pacbox is an emulator of the Pacman arcade machine hardware It is a port of PIE Pacman Instructional Emulator http www ascotti org programming pie pie htm ROMs To use the emulator to play Pacman you need a copy of ROMs for Midway Pacman The Rockbox manual Toshiba Gigabeat F Series ...

Page 80: ...373d4 pacman 6j 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 Action Up Move Up Down Move Down Left Move Left Right Move Right A Insert Coin Select 1 Player Start Power 2 Player Start ...

Page 81: ...o each other they disappear except for triangles which form a solid block and crosses which allow you to choose a replacement block Key Action In game Up Down Left Right to move around Select to select save A to restart level Volume up to go up a level Volume down to go down a level Power to quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 82: ... Pong is a simple two player tennis game Whenever a player misses the ball the other scores Key Action Up Left player up Down Left player down Volume up Right player up Volume down Right player down Power Quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 83: ...t 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 determine if they are kitten or not The game ends when robotfindskitten Key Action Up Down Left Right Move robot Power Quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 84: ...r a row is complete it will be cleared and the game score will increase For every ten lines completed the game level increases making the blocks fall faster If the pile of blocks reach the ceiling the game is over Key Action A Restart game Left Move left Right Move right Down Move down Volume up Rotate left Volume down Rotate right Select Drop Hold switch Pause Power Quit The Rockbox manual Toshib...

Page 85: ...the bricks down No horizontal moving anymore and no need to rotate the brick Key Action Select Move down faster Power Quit 10 1 18 Sliding Puzzle Figure 10 15 Sliding puzzle The classic sliding puzzle game Rearrange the pieces so that you can see the whole picture or switch to number tiles if you like it a little easier Key controls The Rockbox manual Toshiba Gigabeat F Series ...

Page 86: ... Figure 10 16 Snake This is the popular snake game The aim is to grow your snake as large as possible by eating the dots that appear on the screen The game will end when the snake touches either the borders of the screen or itself Key Action Up Down Change levels 1 is slowest 9 is fastest Select Toggle Play Pause The Rockbox manual Toshiba Gigabeat F Series ...

Page 87: ...e game ends when the snake hits a wall or runs into itself Key Action In menu Up Down Set game speed Right Left Select starting maze Menu Select game type A or B Select Start the game In game 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 Rock...

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

Page 89: ...y undone 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 Rockbo...

Page 90: ... games exist 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...

Page 91: ...f the 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 10 1 23 Spacerocks Figure 10 20 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 s...

Page 92: ...ewrite 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 Toshiba Gigabeat F Series ...

Page 93: ...e Browse 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 s...

Page 94: ...r will then be added If the number was already on the scratchpad it will get removed again The column is stored seperatly for every cell on the board The stored values can be displayed inline as small dots by enabling the Show Markings settings Note The scratchpad is not saved when saving the game b Key Action Up Down Left Right Move the cursor Select Change number under the cursor Long Select Con...

Page 95: ...e a hungry little worm Help your worm to find food and to avoid poisoned argh tiles The goal is to turn your tiny worm into a big worm for as long as possible Menu controls Key Action Left Right Controls number of worms in the game Game controls Key Action Left Turn left Right Turn right Up Turn Up Down Turn Down The Rockbox manual Toshiba Gigabeat F Series ...

Page 96: ... worm isn t hurt by the bite It will go on creeping happily and eat all the food you left on the table Walls Don t crash into the walls Walls are not edible Crashing a worm against a wall causes it a headache it doesn t survive Game over The game is over when all worms are dead The longest worm wins the game Pause the game Press to pause the game Press again to resume the game Stop the game There ...

Page 97: ... worm or even itself That s why it is dead now Making traps for other players with a worm is a good way to get them out of the game Hints Initially you will be busy with controlling your worm 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 di...

Page 98: ...ts of the arena with your trail in order to remove that section from the game Be careful not to get in the way of enemy balls because if they hit you or your trail you lose a life To finish a level you have to section off more than 75 Key Action Up Down Left Right Move around the arena A Pause Power Open menu The Rockbox manual Toshiba Gigabeat F Series ...

Page 99: ... a different one scrolling from right to left Key Action Up Down Moves to next previous option Left Right Increases decreases option value A Toggles Scroll mode Power Exits bounce demo Available options are Xdist Ydist The distance to X axis and Y axis respectively Xadd Yadd How fast the code moves on the sine curve on each axis Xsane Ysane Changes the appearance of the bouncing The Rockbox manual...

Page 100: ...ing Version from the System section of the Rockbox main menu Exit at any time by pressing Left or Power 10 2 3 Cube Figure 10 26 Cube This is a rotating cube screen saver in 3D Key Action A Display at 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 The Rockbox manual Toshiba Gigabeat F...

Page 101: ...gins 101 10 2 4 Demystify Figure 10 27 Demystify Demystify is a screen saver like demo Key Action Right Left Increase decrease speed Up Down Add remove polygon Power Quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 102: ...se decrease number of flames Left Toggle flame type Right Toggle moving flames Power Quit 10 2 6 Logo Demo showing the Rockbox logo bouncing around the screen Key Action Right Left Increase decrease speed on the x axis Up Down Increase decrease speed on the y axis Power Quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 103: ...ges from the Mandelbrot set Key Action Direction keys Move about the image Select Zoom in Long Select Zoom out Volume down Decrease iteration depth less detail Volume up Increase iteration depth more detail A Reset and return to the default image Power Quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 104: ...Chapter 10 Plugins 104 10 2 8 Mosaique Figure 10 30 Mosaique This simple graphics demo draws a mosaic picture on the screen of the player Press Power to quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 105: ...er speed rates the player is less responsive to user input and music may start to skip Keys 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 Toshiba Gigabeat F Series ...

Page 106: ...ins 106 10 2 10 Plasma Figure 10 32 Plasma Plasma is a demo displaying a 80 s style retro plasma effect Key Action Up Down Adjust frequency Select Change colours Power Quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 107: ...0 2 11 Snow Figure 10 33 Have you ever seen snow falling This demo replicates snow falling on your screen If you love winter you will love this demo Or maybe not Press Power to quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 108: ...d Figure 10 34 Starfield Starfield simulation like the classic screensaver Key Action Right Left Increase decrease number of stars Up Down Increase decrease speed Select Change colours Power Quit The Rockbox manual Toshiba Gigabeat F Series ...

Page 109: ...lay of small meters 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 Action Power Save settings and quit A Help Menu Settings Up Raise Volume Down Lower Volume 10 3 Viewers Viewers are plugins which are associated with specific file extensions They cannot be run directly but are started by ...

Page 110: ...u a list with the entries in the file Selecting one of them will then exit the plugin and leave you within the directory selected or with the file selected in the file browser You can then play the file or do with it whatever you want The file will not be played automatically If the link file contains only one entry no list will be shown you will directly jump to that location The file shortcuts l...

Page 111: ...ains new key mappings for BLINKY ch8 one writes a BLINKY c8k file That c8k file contains 16 characters describing the mapping from the Chip8 keyboard to the default key mapping that way several Chip8 keys can be pressed using only one Rockbox key For example a file containing the single line Code 0122458469ABCDEF would correspond to the following non default mappings 3 2 6 8 7 4 8 6 The default ke...

Page 112: ...nu From the playback menu you can control the playback of the currently loaded playlist and change the volume of your player Return Returns you to the image Note Progressive scan and other unusual JPEG files are not supported and will result b in various unsupported xx messages Processing could also fail if the image is too big to decode which will be explained by a respective message 10 3 4 Midip...

Page 113: ...le is selected the start Menu will be displayed unless it is disabled via the option start menu see below In the latter case the video will start playing immediately unless a resume point is found in which case the resume menu is presented Start Menu Play from beginning Resume information is discarded and the video plays from the start Resume time min x x Resume video playback at stored resume tim...

Page 114: ...ames option the current time in 100Hz ticks and the time the current frame is due to be displayed Limit FPS default on With this option disabled mpegplayer will display the video as fast as it can Useful for benchmarking Skip frames default on This option causes mpegplayer to attempt to maintain real time playback by skipping the display of frames but these frames are still decoded Disabling this ...

Page 115: ...d on the gnuboy emulator To start a game open a ROM file saved as gb or gbc in the file browser Default keys 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 Toshiba Gigabeat F Series ...

Page 116: ...The results of this search are saved to a new playlist search results m3u within the same directory as the original playlist 10 3 9 Sort This plugin takes a file and sorts it in ascending alphabetical order Case is ignored This is useful for ordering playlists generated by the Create Playlist menu option see section 5 8 page 39 10 3 10 Text Viewer This is a Viewer for text files with word wrap Jus...

Page 117: ...rmal breaks lines at newline characters Wide View toggles between Narrow and Wide Yes sets maximum column to 114 Useful for navigating large files Cur rently Wide and Join cannot be selected together No Narrow sets maximum column to the screen width Show Scrollbar toggles scrollbar for the current View mode If the file fits on one screen there is no scrollbar and toggling this setting has no effec...

Page 118: ... stream used to calculate average bit rate time information and to more accurately fwd rew in the stream This function is especially useful when the playback of a file skips fwd rew does not work correctly or the time display is incorrect Note VBRfix can only run when music is turned off since it uses the same memory as b the player and can take a while to complete if run on big files 10 3 12 ZXBo...

Page 119: ...t into rockbox zxboxq z80 Load Quick Snapshot Loads snapshot from rockbox zxboxq z80 Save Snapshot Saves a snapshot of the current state You would enter the full path and desired name for example games zx snapshots chuckie sna The snapshot format will be chosen after the extension you specified per default z80 will be taken in case you leave it open Toggle Fast Mode Toggles fastest possible emulat...

Page 120: ...the background TSR plu gin reading various info about your battery while you use it Once you finish your ses sion you can find the benchmark output data in a file on your player battery bench txt Please submit your results to the Rockbox wiki ZBatteryRuntime How it works After you load the plug in the operation of your player continues as normal You can do whatever you could do before loading the ...

Page 121: ...nd estimated time left This could help make time left more accurate Voltage The battery voltage the moment the measurement was captured Measure ments are captured when this number changes while benchmarking This column can be used to give quite interesting graphs in a spreadsheet program Excel Calc e t c M DA Measurements per Disk Activity The number of measurements stored tem porarily in memory b...

Page 122: ...culator Pressing the 1st and 2nd buttons will toggle between other available math functions 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 10 4 3 Calendar WARNING Image not found Figure 10 39 Calendar The Rockbox manual Toshiba Gigabeat F Series ...

Page 123: ...onthly and weekly memos 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 10 4 4 Chess Clock Figure 10 40 Chess Clock The chess clock plugin is designed to simulate a chess clock but it can be used in any kind of game with up to ten players The Rockbox manual Toshiba Gigabeat F Series ...

Page 124: ... time below is the time remaining for that round and possibly also the total time left if different Keys are as follows Key Action Power Exit plugin Power Restart round for the current player Select Pause the time press again 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 ...

Page 125: ...s Menu Main Menu Select Start Stop Counter Long Select Reset Counter Power Save Settings if enabled and Exit Clock Menu View Clock Exits the menu and returns to the current clock mode display Mode Selector Opens a menu from which you can select a clock mode to view Counter Settings Opens a menu from which you can adjust settings pertaining to the counter The Rockbox manual Toshiba Gigabeat F Serie...

Page 126: ... The Counter if enabled is displayed at the lower right The second hand if enabled is displayed along with the hour and minute hands Digit display if enabled places 12 3 6 and 9 around the face of the clock in their respective positions Digital mode An imitation of an LCD this mode shows a Clock comprised of digital segments The Date readout if enabled is displayed at the bottom center The Second ...

Page 127: ... takes up nearly the whole LCD 10 4 6 Disk Tidy Disk Tidy deletes junk files left behind by Windows Linux or OS X after a USB connec tion Select the OS s files you want to delete in the Files to Clean menu and select Start Cleaning to begin to process The settings are stored in rockbox rocks apps disktidy config in a plain text file that is user modifiable to allow more entries to be added Availab...

Page 128: ...empty list will be created the next time you select Enter Keybox after prompting for a new master password Entries are automatically saved when the plugin is exited 10 4 8 Lamp Lamp is a simple plugin to use your player as a lamp flashlight torch You get an empty screen with maximum brightness Key Action Left Right Toggle between colours Power Quit 10 4 9 md5sum Open a file a directory or just lau...

Page 129: ... scanned You can have up to 10 directories ignored by the scan by placing a minus sign before them in the list i e CDs will cause everything in the CDs directory to be ignored If you just want CDs to be ignored but want to include the folders 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 fold...

Page 130: ...e stats plugin The stats plugin simply counts the number of files music files and directories on your player Press Power to abort counting and exit the plugin Press it again to quit after counting has finished The Rockbox manual Toshiba Gigabeat F Series ...

Page 131: ...iew 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 22 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 screen You can now edit the file The Text Editor is line based This means you can edit one li...

Page 132: ...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 Action Select or Right Edit Line Select Character Left or Power Exit Abort Editing Menu Show Item Menu Long Select Delete Line The Rockbox manual Toshiba Gigabeat F Series ...

Page 133: ...an be found in the tools directory of the Rockbox source code 11 1 3 Loading Languages Rockbox can load language files at runtime Simply copy the lng file do not use the lang file to the player and play it in the Rockbox directory browser or select Settings General Settings Languages from the Main Menu Note If you want a language to be loaded automatically every time you start up it b must be loca...

Page 134: ... Artist Album etc in the default font as a purely text based layout There are a number of WPS files included in Rockbox and you can load one of these at anytime by selecting it in General Settings Display Browse wps files Note Playing a wps from the file browser has the same effect b File Location Custom WPS files may be located anywhere on the drive The only restriction is that they must end in w...

Page 135: ...each value the tag can have Example enumeration Example mp Stop Play Pause Ffwd Rew The last else part is optional and will be displayed if the tag has no value The WPS parser will always display the last part if the tag has no value or if the list of alternatives is too short Next Song Info You can display information about the next song the song that is about to play after the one currently play...

Page 136: ...s they are separated into different sublines Example subline definition Example s t4 ia s it t3 pc pr Display id3 artist for 4 seconds Display id3 title for 2 seconds Display current and remaining track time for 3 seconds repeat Conditionals can be used with sublines to display a different set and or number of sublines on the line depending on the evaluation of the conditional Example subline with...

Page 137: ... d rep one bmp 16 64 xl e rep shuffle bmp 16 64 mm xdb xdc xdd xde Four images at the same x and y position are preloaded in the example Which image to display is determined by the mm tag the repeat mode Example File Example s in in it it fn ia ia id id pb pc pt That is tracknum title artist album where most fields are only displayed if avail able Could also be rendered as filename or tracknum tit...

Page 138: ... configuration file volume 70 bass 11 treble 12 balance 0 time format 12hour volume display numeric show files supported wps rockbox car wps lang rockbox afrikaans lng Note As you can see from the example configuration files do not need to contain all of b the Rockbox options You can create configuration files that change only certain settings So for example supppose you typically use the player a...

Page 139: ...option writes a cfg file to your player s disk The configuration file has the cfg extension and is used to store all of the user settings that are described throughout this manual Hint Use the Save cfg File feature Main Menu General Settings to save the current settings then use a text editor to customize the settings file See Appendix section C page 150 for the full reference of available options...

Page 140: ...aylist and starts play ing the first file Rockbox firmware gigabeat ROLO will load the new firmware While Playing Screen wps The new WPS display configuration will be loaded Language File lng Loads a language file Text File txt This will display the text file using Rockbox text browser plugin Configuration File cfg The settings file will be loaded Font fnt This font will replace the current one Pl...

Page 141: ...ac3 Supports downmixing for playback of 5 1 streams in stereo ADX adx Speex spx Lossless codecs Waveform audio format wav Audio Interchange File Format aif aiff Free Lossless Audio flac Apple Lossless m4a mp4 Wavpack wv Shorten shn Seeking not supported Monkey s Audio ape mac c1000 to c3000 files de code fast enough to be useful Other codecs Sound Interface Device sid MOD mod NES Sound Format nsf ...

Page 142: ...d on their own line B 2 ID3 Info Tag Description ia ID3 Artist ic ID3 Composer id ID3 Album Name ig ID3 Genre Name in ID3 Track Number it ID3 Track Title iv ID3 Version 1 0 1 1 2 2 2 3 2 4 or empty if no id3 tag iy ID3 Year Remember that this information is not always available so use the conditionals to show alternate information in preference to assuming The Rockbox manual Toshiba Gigabeat F Ser...

Page 143: ...ag Description fb File Bitrate in kbps fc File Codec e g MP3 or FLAC This tag can also be used in a condi tional tag fc mp1 mp2 mp3 aiff wav vorbis flac mpc a52 wavpack alac aac shn sid adx unknown The codec order is as follows MP1 MP2 MP3 AIFF WAV Ogg Vorbis OGG FLAC MPC AC3 WavPack WV ALAC AAC Shorten SHN SID ADX NSF Speex SPC APE ff File Frequency in Hz fm File Name fn File Name without extensi...

Page 144: ...laylist Position pr Remaining Time In Song ps Shuffle Shows s if shuffle mode is enabled pt Total Track Time pv Current volume x dB Can also be used in a conditional pv 0 1 2 N B 6 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 B 7 Sound DSP settings Tag Description Sp Display current playback pitch xf...

Page 145: ...ume Tag Description mv t v if the volume is being changed The tag produces the letter v while the volume is being changed and some amount of time after that i e after the volume button has been released The optional parameter t specifies that amout of time If it is not specified 1 sec is assumed The tag can be used as the switch in a conditional tag to display different things depending on whether...

Page 146: ...volume button has been released After that it will display the volume value B 12 Settings Tag Description St setting name Display the value of any Rockbox setting Example Can be used as a simple tag St skip length or with conditionals St eq enabled Equalizer is enabled Equalizer is disabled The Rockbox manual Toshiba Gigabeat F Series ...

Page 147: ... referencing in xd filename filename relative to rockbox and in cluding bmp x x coordinate y y coordinate nimages optional number of sub images tiled vertically of the same height contained in the bitmap Default is 1 xdn i Display a preloaded image n image ID a z and A Z 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 By default the first...

Page 148: ...s must repect each of the players limits B 14 Alignment Tag Description al Text is left aligned ac Text is center aligned ar Text is right aligned All alignment tags may be present in one line but they need to be in the order left center right If the aligned texts overlap they are merged B 15 Conditional Tags Tag Description xx true false If Else Evaluate for true or false case xx alt1 alt2 alt3 e...

Page 149: ...ercase am pm ca Weekday 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 B 17 Other Tags Tag Description Display a Display a Display a Display a Display a s Indicate that the line should scroll Can occur anywhere in a line given that the text is displayed see conditionals above You can specify up to 10 scrolling lines Scrolling lines can not contain ...

Page 150: ...in 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 0 to 2500 ms scroll st...

Page 151: ...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 seconds disable autoresume if phones not present off on N A Last fm Logging off on N A talk dir off number spell N A talk dir clip off on N A talk file off number spell N A talk fil...

Page 152: ... gain 0 to 60 0 1dB crossfeed cross gain 30 to 120 0 1dB crossfeed hf attenuation 60 to 240 0 1dB crossfeed hf cutoff 500 to 2000 Hz eq enabled on off N A eq precut 0 to 240 0 1dB eq band 0 cutoff 0 to 32768 Hz eq band 1 cutoff 0 to 32768 Hz eq band 2 cutoff 0 to 32768 Hz eq band 3 cutoff 0 to 32768 Hz eq band 4 cutoff 0 to 32768 Hz eq band 0 q 0 to 64 N A eq band 1 q 0 to 64 N A eq band 2 q 0 to ...

Page 153: ...lume display 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 FF...

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

Page 155: ...formed over USB since the USB circuit in the player is strictly made for disk access and does not allow us to play with it the way we d need for any good communication to work Support other file systems than FAT32 like NTFS or ext2 or whatever No support for more file systems will just take away valuable ram for unnecessary features You can partition your player fine just make sure the first one i...

Page 156: ...es 2008 10 03 APE playback optimized 2008 09 21 MP3 playback optimized for dual core targets E 2 What is new since v2 5 E 2 1 New features 2008 07 07 Added keybox plugin 2008 05 04 Added study mode 2008 04 23 Lamp originally flashlight plugin 2008 03 23 New bitmap strips feature in the WPS 2008 03 21 Viewport tag added for WPS 2008 03 18 The Olympus m robe 100 is now a supported target 2007 12 09 ...

Page 157: ...nd format selection added to recording settings Encoders can be configured individually on a menu specific to the encoder in the recording menu 2006 11 06 Pitch adjustment in semitone steps 2006 10 27 Audio dithering option 2006 10 19 last fm audioscrobbler logging support 2006 10 05 FM radio region setting 2006 09 15 ZX spectrum emulator plugin zxbox 2006 08 28 Encoder Codec Interface for recordi...

Page 158: ...disc number tag 2007 04 04 WPS tokenizer Rewritten WPS code 2007 03 20 rockbox file moved inside rockbox directory 2007 01 23 Settings are now saved to rockbox config cfg and the hidden config sector is not used anymore 2006 11 29 Playlists are saved with the extension m3u8 extension m3u is now read using the chosen codepage 2006 09 16 New scheduler Audio playback is now prioritised over other tas...

Page 159: ...Appendix E Changelog 159 AIFF FLAC ALAC Wavpack Shorten Monkey s Audio Other codecs SID MOD NSF NSFE SPC MIDI SAP The Rockbox manual Toshiba Gigabeat F Series ...

Page 160: ...zler Frederic 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 Ha ggqvist Thom Johansen Rinat Zakirov Manue...

Page 161: ...kel Adam Gashlin Robert Kukla David Quesada Jared Stafford Martin Hensel Ste phane Doyon Austin Appel Andre Smith Travis Hyyppa Ian Webber Pavel Gnelitsa Lutz Bo hne Will Robertson Robert Carboneau Ye Wei Bryan Childs Mike Schmitt Chris Taylor Tobias Langhoff Steve Gotthardt Greg White Mattieu Favre aux Malcolm Tyrrell Piotr Jafis zow Gary Allen John BouAntoun Tomasz Mon Jakub Matous ek Al bert Ve...

Page 162: ...us Ry William Poetra Yoga Hadisoeseno Adrian Osoianu Martin Pahl Ori Avtalion Thomas Schott Dennis Ivanov Takumi Suzuki Shunsuke Shimizu Tadayuki Nishizono Jun Gu Daniel Weck Cle ment Pit Claudel Jelle Geerts Tadeusz Pys Rostislav Chekan Florin Popescu Volker Mische Vitja Makarov Francisco Vila Christian Lees Rafae l Carre Denes Balatoni Roy Wallace Eric Lassauge Franc ois Dinel Francesco Rigoni J...

Page 163: ...which is 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...

Page 164: ... copy represented in a format whose specification 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 i...

Page 165: ...f copies you must also follow the conditions in section 3 You may also lend copies under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that...

Page 166: ...e listed in the History section of the Document You may use the same title as a previous version 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 ...

Page 167: ...claimers If the Modified Version includes new front 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 ti...

Page 168: ...uments released 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...

Page 169: ... distribute 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 Licen...

Page 170: ...Sections 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 examp...

Page 171: ...tions that 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 c...

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

Page 173: ... 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 a complete machine readable copy of the corresponding source code to be d...

Page 174: ...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 that contradict the conditions of this License they do not excuse you from the conditions of this License If you c...

Page 175: ...dation 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 copyrighted by the Free Software Foundation write to the Free Software...

Page 176: ... 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 version This program is distributed in the hope that it will be useful but WITHOUT ...

Page 177: ...gram 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 program is a subroutine library you may conside...

Reviews: