background image

Chapter 12. Plugins

111

12.1.14. Invadrox

Figure 12.12.: Invadrox

Invadrox is a clone of the classic arcade game Space Invaders. Kill those pesky aliens
before they get to you. Remember, they increase speed, drop down and reverse direction
after every pass!

Key

Action

Left

Move left

Right

Move right

Select

Fire

Power

Quit

The Rockbox manual

(version 3.14)

Sansa Fuze+

Summary of Contents for Sansa Fuze+

Page 1: ...The Rockbox Manual for Sansa Fuze rockbox org April 30 2017...

Page 2: ...03 Jos Maria 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 Documenta...

Page 3: ...8 2 3 Running Rockbox 19 2 4 Updating Rockbox 19 2 5 Uninstalling Rockbox 19 2 5 1 Automatic Uninstallation 19 2 5 2 Manual Uninstallation 19 2 6 Troubleshooting 19 3 Quick Start 21 3 1 Basic Overview...

Page 4: ...playlists 43 4 4 6 Loading saved playlists 43 4 5 Hotkeys 43 5 The Main Menu 44 5 1 Introducing the Main Menu 44 5 2 Navigating the Main Menu 45 5 3 Recent Bookmarks 45 5 4 Files 46 5 5 Database 46 5...

Page 5: ...at 64 7 3 Play Selected First 65 7 4 Fast Forward Rewind 65 7 5 Fade on Stop Pause 65 7 6 Party Mode 65 7 7 Crossfade 65 7 8 Replaygain 66 7 9 Track Skip Beep 67 7 10 Auto Change Directory 67 7 11 Con...

Page 6: ...83 8 9 Language 84 8 10 Voice 84 8 11 Hotkey 85 9 Theme Settings 86 10 Recording Settings 88 10 1 Format 88 10 2 Encoder Settings MP3 only 88 10 3 Frequency 89 10 4 Source 89 10 5 Channels 89 10 6 Mon...

Page 7: ...en 121 12 1 26 Rockblox 122 12 1 27 Rockblox1d 123 12 1 28 Sliding Puzzle 123 12 1 29 Snake 124 12 1 30 Snake 2 125 12 1 31 Sokoban 126 12 1 32 Solitaire 128 12 1 33 Spacerocks 129 12 1 34 Star 130 12...

Page 8: ...ad 162 12 3 14 Text Viewer 163 12 3 15 Theme Remove 168 12 3 16 VBRfix 169 12 3 17 ZXBox 170 12 4 Applications 172 12 4 1 Alarm Clock 172 12 4 2 Battery Benchmark 172 12 4 3 Calculator 174 12 4 4 Cale...

Page 9: ...dditional Fonts 204 13 3 Managing Rockbox Settings 207 13 3 1 Introduction to cfg Files 207 13 3 2 Specifications for cfg Files 207 13 3 3 The Manage Settings menu 208 13 4 Firmware Loading 209 13 4 1...

Page 10: ...Song Info 225 D 10 Playlist Viewer 225 D 11 Runtime Database 226 D 12 Sound DSP settings 226 D 13 Hold 226 D 14 Virtual LED 227 D 15 Repeat Mode 227 D 16 Playback Mode 227 D 17 Current Screen 227 D 1...

Page 11: ...w bug reports 245 G 2 Feature ideas 245 G 2 1 Rules for submitting a new feature idea 245 G 2 2 Features we will not implement 246 H Credits 247 I Licenses 251 I 1 GNU Free Documentation License 251 I...

Page 12: ...en 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 Yo...

Page 13: ...h icons 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 fin...

Page 14: ...firmware 2 2 Installing 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...

Page 15: ...ndows Linux and Mac OS X are available at the ZRockboxUtility wiki page When first starting Rockbox Utility run Autodetect found in the configuration dialog File Configure Autodetection can detect mos...

Page 16: ...to the 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 insta...

Page 17: ...box org bootloader sandisk sansa fuzeplus bootloader fuzeplus sansa The version of mkimxboot for your operating system from Rockbox s server http download rockbox org bootloader sandisk sansa mkimxboo...

Page 18: ...t into the original firmware in order to perform the following step See section 3 1 3 page 22 for details on how to do so Update your player s firmware with the patched bootloader To do this safely ej...

Page 19: ...talled Rockbox manually you can still use Rockbox Utility for uninstallation but will not be able to do this selectively Note Rockbox Utility cannot uninstall the bootloader due to the fact that it re...

Page 20: ...hen the bootloader cannot find the Rockbox firmware This is usually a result of not extracting the contents of the zip file to the proper location and should not happen when Rockbox has been installed...

Page 21: ...by Long a long press of approx imately one second should be performed on that button The buttons are described in detail in the following paragraph Additional information for blind users is available...

Page 22: ...t them in any other folder e g music or audio The default directory structure that is assumed by some parts of Rockbox album art searching and missing tag fallback in some WPSes uses the parent direct...

Page 23: ...re some special menus for quick access to frequently used functions Context Menu Some views especially the file browser and the WPS have a context menu From the file browser this can be accessed with...

Page 24: ...ded fonts installed as otherwise the theme may not display properly 3 3 USB Charging To charge your player over USB hold any button while plugging it in This will prevent it from connecting to your co...

Page 25: ...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...

Page 26: ...r Right Execute the default action on the selected file or enter a directory Play If there is an audio file playing return to the While Playing Screen WPS without stopping playback Long Play Stop audi...

Page 27: ...voked on a directory 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 t...

Page 28: ...en if the file has a non standard extension i e the file has an extension of something other than txt See section 12 3 page 150 for more details on viewers Create Directory Create a new directory in t...

Page 29: ...ard 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 website at ZLoadableKeyboardLayouts Also you can switch to...

Page 30: ...x 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...

Page 31: ...ted 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 runti...

Page 32: ...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 sett...

Page 33: ...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 r...

Page 34: ...it rate VBR files display average bitrate and avg Elapsed and total time A slidebar progress meter representing where in the song you are Peak meter See section 13 2 page 200 for details of customisin...

Page 35: ...tch on off Long Bottom Left Show Pitch Screen see section 4 3 3 page 38 Long Bottom Right Enter ID3 Viewer Bottom Right Activate the Hotkey function see sec tion 4 5 page 43 tbd or Short Right Long Ri...

Page 36: ...ows you to view save search and reshuffle the current playlist These and other operations are detailed in section 4 4 page 39 To change settings for the Playlist Viewer press Long Select or Long Right...

Page 37: ...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 Gather Runtime Information is enabled It allows the a...

Page 38: ...ormal playback speed and a pitch that is an octave lower than the normal pitch 200 means double playback speed and a pitch that is an octave higher than the normal pitch The rate can be changed in two...

Page 39: ...nts of a directory Rockbox will automatically create a playlist containing all songs in it This means that just about anything that is described in this chapter with respect to playlists also applies...

Page 40: ...laylist By using the Playlist catalogue The Playlist catalogue makes it possible to modify and create playlists that are not currently playing To do this select Playlist catalogue in the Context Menu...

Page 41: ...newly selected tracks are added to the playlist is determined by the following options Insert Add track s immediately after any tracks added via the most recent Insert operation If no tracks have yet...

Page 42: ...dding an entire directory to a playlist Set the Settings General Settings Playlist Recursively Insert Directories setting to Yes if you would like Rockbox to include tracks in subdirectories as well a...

Page 43: ...the current dynamic playlist Through the Playlist catalogue The Playlist catalogue offers a shortcut to all playlists in your player s specified playlist directory It can be used like the File Browser...

Page 44: ...press the tbd button All settings are stored on the unit However Rockbox does not access the flash storage solely for the purpose of saving settings Instead Rockbox will save settings when it accesses...

Page 45: ...revious option Select or Right Select option Back or Left 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 b...

Page 46: ...n the Main Menu when the option is off the default setting See section 8 7 page 81 for more details on configuring bookmarking in Rockbox 5 4 Files Browse the files on your player see section 4 1 page...

Page 47: ...ral 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 70 5 7 4 Theme Settings The Theme...

Page 48: ...e being recorded A peak meter is present to allow you set gain correctly There is also a volume setting this will only affect the output level of the player and does not affect the recorded sound If e...

Page 49: ...switches to the radio screen The FM radio has the ability to remember station frequency settings presets Since stations and their frequencies vary depending on location it is possible to load these s...

Page 50: ...u Play Mute radio playback Select Switch between SCAN and PRESET mode Long Bottom Right Open a list of radio presets You can view all the presets that you have and switch to the station Long Select Di...

Page 51: ...o maintain several playlists see sec tion 4 4 page 39 5 11 Plugins With this option you can load and run various plugins that have been written for Rock box There are a wide variety of these supplied...

Page 52: ...tions navigate through the menus to the setting you want to add and press Long Select or Long Right In the menu which appears you will be given options to place the setting on the Quick Screen Press t...

Page 53: ...he possible settings debug data is the name of the debug menu item to display separator data is ignored name can be used to display text or left blank to make the list more accessible with visual gaps...

Page 54: ...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 vo...

Page 55: ...setting controls the balance between the left and right channels The default 0 means that the left and right outputs are equal in volume Negative numbers increase the volume of the left channel relat...

Page 56: ...rossfeed attempts to make the experience of listening to music on headphones more similar to listening to music with stereo speakers When you listen to music through speakers each ear will hear sound...

Page 57: ...tenuation How much the upper frequencies of the cross path audio will be dampened Note that the total level of the higher frequencies will be a combination of both this setting and the Cross Gain sett...

Page 58: ...n and width of EQ bands separately The ability to adjust the frequency and width of bands enables more precise control of the EQ frequency response while avoiding the use of a large number of bands of...

Page 59: ...only very 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 Po...

Page 60: ...to the next EQ band Select Toggles the cursor among the three pa rameters gain centre frequency Q for the selected EQ band Back Exits the graphic EQ screen Pre cut If too much positive gain is added...

Page 61: ...ency spectrum 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 occur...

Page 62: ...iet sections 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 t...

Page 63: ...d the threshold 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 af...

Page 64: ...ry option 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 finis...

Page 65: ...gs and launching plugins 7 7 Crossfade This section controls the behavior of the crossfader The crossfader when enabled smoothly fades one track into the next This can occur in two situations an autom...

Page 66: ...out and the next song will simultaneously fade in If set to Mix the ending song will not fade out at all and will continue to play as normal until its end with the starting song fading in from under i...

Page 67: ...ould clip during playback the volume is lowered for that song Replaygain information is needed for this to work Pre amp This allows you to adjust the volume when replaygain is applied Replaygain often...

Page 68: ...kers are displayed on the progressbar and it is possible to skip between the tracks within the cuesheet Also the information found in the cuesheet file will replace the information from the ID3 tags W...

Page 69: ...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 dep...

Page 70: ...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 Rockbo...

Page 71: ...ecutive digits 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 t...

Page 72: ...r effect 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...

Page 73: ...so perform its appropriate action Selective Backlight This option allows some selected actions in While Playing Screen and FM screen to not turn on the backlight in order to save power Enabled Enables...

Page 74: ...pages that 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...

Page 75: ...t 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 k...

Page 76: ...er for changes to Max Entries in File b Browser or Max Playlist Size to take effect while Glyphs To Cache will affect the next font load 8 5 3 Use Shortcuts Menu Instead of Quick Screen This option ac...

Page 77: ...een virtual keys are ignored If set to 0 there is effectively no deadzone If set to 100 the deadzones between each virtual button are set to a maximuim 400px 8 5 7 Advanced Key Lock This option allows...

Page 78: ...on the player sends a keystroke the computer the player is attached to according to the mapping set by the keypad mode There are different modes which provide different functionality Switching modes...

Page 79: ...page and different tabs navigate through history and to control zoom Key Action Up Down Scroll up down respectively Long Bottom Right Zoom in out respectively Long Play Zoom reset Left Right Tab previ...

Page 80: ...ile browser starting in the root directory of your player Database Show the default database view Resume Playback Go to the WPS and and resume playback from where it was before turning off if there is...

Page 81: ...tial duration 8 7 Bookmarking Bookmarks allow you to save your current position within a track so that you can return to it at a later time Bookmarks also store rate pitch and speed information from t...

Page 82: ...ting Bookmark on Stop to No and the setting Update on Stop to Yes Load Last Bookmark This option controls if Rockbox should automatically load a bookmark for a file when that file is played No Always...

Page 83: ...mark the playback position saved in the bookmark takes precedence Optionally you can also enable automatic resume for automatic track transitions In this case the next track will be resumed as well in...

Page 84: ...iles are large and are not shipped with Rockbox by default The voice file is the name of the language for which it is made followed by the extension voice So for English the file name would be english...

Page 85: ...ile This functions the same as for directories except that the talk clip file must have the same name as the described file with an extra talk extension e g Punkadiddle mp3 would require a file called...

Page 86: ...ed fonts on your player Selecting one will activate it See section 13 1 3 page 197 for further details about fonts While Playing Screen Opens the File Browser in the rockbox wps directory and displays...

Page 87: ...ith a solid colour the colour is set in the Colours submenu Bar Gradient Colour A bar with a colour gradient the colours are set in the Colours submenu Colours The options in this menu sets the colour...

Page 88: ...tory where you want to store them in the File Browser and select Set As Recording Directory 10 1 Format Choose which format to save your recording in The available choices are the two un compressed fo...

Page 89: ...reated Options are L R and L R 10 7 File Split Options This sub menu contains options for file splitting which can be used to split up long recordings into manageable pieces The splits are seamless fr...

Page 90: ...ock concert the murmur of the audience might be considered background noise which is much louder compared to rustling paper Also the duration of the signal matters When you record speech you want to r...

Page 91: ...he sound level drops below the stop threshold the recording is stopped It is displayed numerically in the line Stop Below Just like the start threshold the unit of the stop threshold depends on the se...

Page 92: ...player start up at the specified time Use Up and Down to adjust the minutes setting Left and Right to adjust the hours Select confirms the alarm and Back cancels setting an alarm If the player is turn...

Page 93: ...not interfere 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 plugin...

Page 94: ...the two tiles that collided The resulting 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 t...

Page 95: ...is 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 othe...

Page 96: ...ures in Rockbox 12 1 4 BrickMania Figure 12 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...

Page 97: ...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 t...

Page 98: ...arded depending on how quickly the level was completed Key Action Up Pause game Left Right Aim the bubble Select Fire bubble Back or Power Exit to menu 12 1 6 Chessbox Figure 12 5 Chessbox Chessbox is...

Page 99: ...p 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 stat...

Page 100: ...opper Figure 12 6 Chopper Navigate a cavernous maze without banging into walls the ceiling or the floor How long can you fly your chopper Key Action Select Make chopper fly Power Enter menu The Rockbo...

Page 101: ...d You can only 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 Action Left Right Up Down Move the curs...

Page 102: ...e form of red and white pegs A red peg signifies a correct peg in the correct position and a white peg signifies a correct peg in the wrong position Key Action Back Show menu Select Check suggestion a...

Page 103: ...from 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 dir...

Page 104: ...e speed on 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 Dis...

Page 105: ...t Turn Right Select Shoot Play Open Back InGame Menu Select Enter Bottom Left Change Weapon Playing the game After installation of the wad files is complete you can start the game more description is...

Page 106: ...y Shuffle Back Solve Bottom Left Solve step by step Power Quit the game 12 1 13 Goban Figure 12 11 Goban Goban is a a plugin for playing viewing and recording games of Go also known as Weiqi Baduk Igo...

Page 107: ...are 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 chan...

Page 108: ...nfo 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 se...

Page 109: ...ther 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...

Page 110: ...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...

Page 111: ...ne of the classic arcade game Space Invaders Kill those pesky aliens before they get to you Remember they increase speed drop down and reverse direction after every pass Key Action Left Move left Righ...

Page 112: ...Figure 12 13 Jackpot This is a jackpot slot machine game At the beginning of the game you have 20 Payouts are given when three matching symbols come up Key Action Select Play Back Exit the game The R...

Page 113: ...ble moves Higher points are awarded to larger combos The game advances to the next level after every one hundred points and randomly clears several jewels In puzzle mode the aim of the game is to conn...

Page 114: ...ese 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...

Page 115: ...he 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 st...

Page 116: ...455babaf26e0b396c78d2b45f8f6 pacman 5f 9240f35d1d2beee0ff17195653b5e405 pacman 6e 290aa5eae9e2f63587b5dd5a7da932da pacman 6f 19a886fcd8b5e88b0ed1b97f9d8659c0 pacman 6h d7cce8bffd9563b133ec17ebbb6373d4...

Page 117: ...t Bottom Right 2 Player Start Power Menu 12 1 21 Pegbox Figure 12 18 pegbox To beat each level you must destroy all of the pegs If two like pegs are pushed into each other they disappear except for tr...

Page 118: ...me Whenever a player misses the ball the other scores The game starts in demo mode with the CPU controlling both sides As soon as a button to control one of the paddles is pressed control of that padd...

Page 119: ...119 Key Action Back Left player up Bottom Left Left player down Play Right player up Bottom Right Right player down Power Quit 12 1 23 Puzzles Figure 12 20 Cube from Puzzles The Rockbox manual versio...

Page 120: ...org uk sgtatham puzzles 12 1 24 Reversi This is a simple implementation of the Reversi game The objective of the game is to have a majority of own coloured pieces showing at the end of the game The ga...

Page 121: ...ot 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 robotfin...

Page 122: ...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 t...

Page 123: ...g Puzzle Figure 12 24 Sliding puzzle The classic sliding puzzle game Rearrange the pieces so that you can see the whole picture or switch to number tiles if you like it a little easier Includes one pi...

Page 124: ...image if launched via Open With and numbered tiles Power Stop the game 12 1 29 Snake Figure 12 25 Snake This is the popular snake game The aim is to grow your snake as large as possible by eating the...

Page 125: ...snake around and eat the apples that pop up on the screen Each time an apple is eaten the snake gets longer The game ends when the snake hits a wall or runs into itself Key Action Up Down Left Right S...

Page 126: ...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 b...

Page 127: ...previously undone move Solution playback Play 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 set...

Page 128: ...r 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...

Page 129: ...top of the cursor Play Put the card under the cursor on one of the 4 final colour stacks Long Play Put the card on top of the remains stack on one of the final colour stacks Power Show menu 12 1 33 Sp...

Page 130: ...rewrite 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 fi...

Page 131: ...the 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 generat...

Page 132: ...mn is stored separately 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...

Page 133: ...man player If you attack a square owned by the computer player where your strength is greater than the computer s you will win the tile and take control of any building that were on it If the strength...

Page 134: ...urn your tiny worm into a big worm for as long as possible Game controls 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 aro...

Page 135: ...he game Press 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 The game will stop imme diatel...

Page 136: ...ng 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 catc...

Page 137: ...off more than 75 Key Action Up Down Left Right Move around the arena Play Pause Power Open menu 12 1 39 XWorld In this cinematic award winning platform game by ric Chahi you must evade capture and do...

Page 138: ...tion Up Up and Jump Down Down and Crouch Left Right Move Left and Right Volume Up Action and Fire Volume Down Menu 12 2 Demos 12 2 1 Bounce Figure 12 34 Bounce This demo is of the word Rockbox bouncin...

Page 139: ...How fast the code moves on the sine curve on each axis Xsane Ysane Changes the appearance of the bouncing 12 2 2 Credits The credits plugin scrolls the entire list of the names of all the Rockbox con...

Page 140: ...Cycle draw mode Right Left Select axis to adjust Up Down Change speed angle speed can not be changed while paused Power Quit 12 2 4 Demystify Figure 12 36 Demystify Demystify is a screen saver like d...

Page 141: ...ferent frequency amplitude plots lines bars and spectrogram 12 2 6 Fire Figure 12 37 Fire Fire is a demo displaying a fire effect Key Action Up Down Increase decrease number of flames Left Toggle flam...

Page 142: ...lay Zoom out Bottom Left Decrease iteration depth less detail Bottom Right Increase iteration depth more detail Back Reset and return to the default image Power Quit 12 2 8 Logo Demo showing the Rockb...

Page 143: ...en wikipedia org wiki The_Matrix 12 2 10 Mosaique Figure 12 39 Mosaique This simple graphics demo draws a mosaic picture on the screen of the player Key Action Up Change the gap between the drawing l...

Page 144: ...r speed rates the player is less responsive to user input and music may start to skip Keys Key Action Select Toggle filled curve plot Back Toggle whether to scroll or not Up Toggle drawing orientation...

Page 145: ...to run while your tracks are played Requirements PictureFlow uses both the album art see section C page 219 and database see section 4 2 page 30 features of Rockbox It is therefore important that thes...

Page 146: ...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...

Page 147: ...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 Rockbox can open files with a configuration descripti...

Page 148: ...t generation Left Status only when paused Back Exit 12 2 15 Snow Figure 12 43 Have you ever seen snow falling This demo replicates snow falling on your screen If you love winter you will love this dem...

Page 149: ...gure 12 44 Starfield Starfield simulation like the classic screensaver Key Action Right Left Increase decrease number of stars Up Down Increase decrease speed Select Change colours Back or Power Quit...

Page 150: ...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 Back Save settings and quit...

Page 151: ...just a text 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 shoul...

Page 152: ...to hide common 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...

Page 153: ...are supported Z Machine 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 t...

Page 154: ...lay 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...

Page 155: ...ion about PPM files see http netpbm sourceforge net doc ppm html 12 3 5 Lua scripting language To quote from the Lua website http www lua org Lua is a powerful fast lightweight embeddable scripting la...

Page 156: ...12 3 7 MPEG Player 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 i...

Page 157: ...mpg files 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 avai...

Page 158: ...r PCM with 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...

Page 159: ...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 Select S...

Page 160: ...e 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 or...

Page 161: ...h items you have se lected 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 t...

Page 162: ...is plugin 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 movemen...

Page 163: ...fo file to 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...

Page 164: ...ISO 8859 7 Greek 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 Ko...

Page 165: ...is not displayed 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...

Page 166: ...ht Key Narrow 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...

Page 167: ...l settings are 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_fil...

Page 168: ...leted and 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...

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

Page 170: ...ator only loading 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 Spec...

Page 171: ...the Spectrum 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...

Page 172: ...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 fo...

Page 173: ...r 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 usin...

Page 174: ...t works like a standard calculator 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 Back...

Page 175: ...ate dates with memos The 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 Action Left Righ...

Page 176: ...t Increase decrease displayed Value Select Move to next screen Back 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...

Page 177: ...ain to continue Up Switch to next player Down Switch to previous player Long Select Open menu Select to select From the menu it is possible to delete a player modify the round time for the current pla...

Page 178: ...eset 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 e...

Page 179: ...ettings available in this mode are exactly the same as Digital Mode but they are independent of Digital Mode For example you can have the Date Readout enabled in Digital Mode and disabled in LCD Mode...

Page 180: ...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 ro...

Page 181: ...ries 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...

Page 182: ...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...

Page 183: ...while in the first seconds of a track go to the previous track Long Left Rewind in track Right Go to the next track Long Right Fast forward in track Play Toggle play pause Long Play or Select Exit the...

Page 184: ...ime to the current position of the track To set a specific time or to adjust the time press Long Select or Long Right to bring up a screen to adjust the time Changes will be saved automatically when t...

Page 185: ...po instead of 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 a...

Page 186: ...l 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 seco...

Page 187: ...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 120 Xxxx rockon2 0 4 4 120 xXxX solea 0 12 4 180 xxXxx...

Page 188: ...to be on a line by itself in the following format otpauth hotp OR totp account name secret Base32 secret counter X period X di An example is shown below provisioning a TOTP key for an account called...

Page 189: ...e synchronized with UTC time and second that the plugin knows what time zone the clock is using The plugin will prompt you on its first run for this piece of information However should this setting ne...

Page 190: ...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 folder_advance_list txt...

Page 191: ...hically and 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...

Page 192: ...he ready 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...

Page 193: ...he current 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...

Page 194: ...lume Up Toggles the brush and selects objects 12 4 22 Stats Figure 12 58 The stats plugin The stats plugin counts the directories and files the total number as well as the number of audio playlist ima...

Page 195: ...through lap times 12 4 24 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 27 Us...

Page 196: ...to edit Edit the highlighted 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...

Page 197: ...ast item then The 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 latt...

Page 198: ...and the filename 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 13 1...

Page 199: ...x themes directory 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 12 4 24 page 195 automatically unde...

Page 200: ...15px from 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 Se...

Page 201: ...ments and 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...

Page 202: ...t them to 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 display...

Page 203: ...ay 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 Viewports can share identifiers so that...

Page 204: ...g the menu 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...

Page 205: ...more groups 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 wi...

Page 206: ...Using Images 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...

Page 207: ...player through headphones See section 13 3 2 page 207 below for an explanation of the format for configuration files See section 13 3 3 page 208 for an explanation of how to create edit and load confi...

Page 208: ...fixed cfg 13 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 Browse...

Page 209: ...audio codecs The following provides a short overview of the most relevant settings and rules of thumb 13 5 1 Display backlight The active backlight consumes a lot of power Therefore choose a setting...

Page 210: ...wer consumption Therefore the bitrate of the audio files does have an impact on the battery runtime as well Lower bitrate audio files will result in longer battery runtime Please do not re encode any...

Page 211: ...Appendix A File formats 211 The Rockbox manual version 3 14 Sansa Fuze...

Page 212: ...Cuesheet cue View the cuesheet file FM Presets fmr Load the FM Presets previous are discarded Font fnt Change the user interface font to this one Image jpg View the JPEG image Link link Display list...

Page 213: ...2 5 Layer 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 wil...

Page 214: ...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 Wavefo...

Page 215: ...ubtracks instead 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 Progre...

Page 216: ...format x 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...

Page 217: ...SF wma wmv 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 gene...

Page 218: ...spc sid nsf 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 Mu...

Page 219: ...sive and multi 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 T...

Page 220: ...albumtitle bmp or albumartist albumtitle bmp Doublequotes will be replaced by single quotes If no album artist is set artist will be used instead See ZAlbumArt in the wiki for programs that will help...

Page 221: ...line which 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 In...

Page 222: ...wports Tag Description V x y width height font Vf fgcolour Vb bgcolour Vg start end text See section 13 2 2 Vs mode param See section 13 2 2 Vl identifier Preloads a viewport for later display identif...

Page 223: ...used in a 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...

Page 224: ...e mpcsv8 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...

Page 225: ...track time 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 T...

Page 226: ...y the playlist 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 playc...

Page 227: ...mple mm Off 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 Exam...

Page 228: ...radio some 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...

Page 229: ...anged It 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...

Page 230: ...aults to 0 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...

Page 231: ...e present 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 Maximu...

Page 232: ...e presets list usable in playlist viewer Tn Current preset name usable in playlist viewer Tf Current preset frequency usable in playlist viewer Tc Preset count i e the number of stations in the curren...

Page 233: ...n the order left centre right If the aligned texts overlap they are merged Example ax V D 24 Conditional Tags Tag Description xx true false If Else Evaluate for true or false case xx alt1 alt2 alt3 el...

Page 234: ...ems sublines onto one line with the display cycling round the defined sublines See section 13 2 4 page 205 for details D 26 Time and Date Tag Description cd Day of month from 01 to 31 ce Zero padded d...

Page 235: ...ar to make the bar appear on the line of the tag as if it was a text tag width width of the bar for the full viewport width height height of the bar to set to the font height for horizontal bars and t...

Page 236: ...ote If the slider option is used the bar will be shrunk so that the slider fits inside b the specified width and height Example A 100px bar image with a 16px slider image needs the bar to be 116px wid...

Page 237: ...acter 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 specify up to ten scrolling lines...

Page 238: ...low N A antiskip 5s 15s 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...

Page 239: ...ry capacity devise a way to get ranges from config h mAh car adapter mode on off N A usb hid on off N A usb keypad mode multimedia presentation browser mouse N A usb skip first drive on off N A qs top...

Page 240: ...uffled N A sort files alpha oldest newest type N A sort dirs alpha oldest newest N A sort interpret number digits numbers N A tagcache_autoupdate on off N A warn when erasing dynamic playlist on off N...

Page 241: ...to 240 eq peak filter 2 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 3 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 4 cutoff in Hz q 0 to 64 gain 240 to 240 eq peak filter 5 cutoff...

Page 242: ...10 devise a way to get ranges from config h pixels volume display graphic numeric N A battery display graphic numeric N A font path filename fnt N A kbd path filename kbd N A invert on off N A flip d...

Page 243: ...N A rec mic gain 0 to 15 N A rec left gain 0 to 15 N A rec right gain 0 to 15 N A editable recordings off on N A rec timesplit off 0 05 0 10 0 15 0 30 1 00 2 00 4 00 6 00 8 00 16 00 24 00 h mm pre rec...

Page 244: ...Appendix F Menu Overview 244 F Menu Overview include an overview of the menu structure here The Rockbox manual version 3 14 Sansa Fuze...

Page 245: ...u did and 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 ide...

Page 246: ...o understand 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 connec...

Page 247: ...er 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 C...

Page 248: ...r Ginkel 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...

Page 249: ...Wallace 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 Ant...

Page 250: ...av Chizhik 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...

Page 251: ...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 sho...

Page 252: ...ification 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 draw...

Page 253: ...pies 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...

Page 254: ...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 M...

Page 255: ...s 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 invarian...

Page 256: ...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...

Page 257: ...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 lice...

Page 258: ...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...

Page 259: ...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...

Page 260: ...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 f...

Page 261: ...hat you also 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 customa...

Page 262: ...erms and conditions 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 Licens...

Page 263: ...that version 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 S...

Page 264: ...ve at least 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...

Page 265: ...r school if 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...

Reviews: