Page 1 The Rockbox Manual Sansa Fuze+ rockbox.org April 30, 2017...
Page 2 Rockbox http://www.rockbox.org/ Open Source Jukebox Firmware Rockbox and this manual is the collaborative eﬀort of the Rockbox team and its contributors. See the appendix for a complete list of contributors. c 2003-2013 The Rockbox Team and its contributors, c 2004 Christi Alice Scarborough, c 2003 José...
Page 3: Table Of Contents
Contents Contents 1. Introduction 1.1. Welcome ........12 1.2.
Page 4: Contents
Contents 4.1.3. Virtual Keyboard ......29 4.2. Database ........30 4.2.1.
Page 5: Contents
Contents 6.2. Bass ........55 6.3.
Page 6: Contents
Contents 8.5.3. Use Shortcuts Menu Instead of Quick Screen ... . 76 8.5.4. Car Adapter Mode ......76 8.5.5.
Page 7 Contents 12.1.8. Clix ........101 12.1.9. Codebuster .
Page 8 Contents 12.2.12.PictureFlow ....... 145 12.2.13.Plasma ....... . . 147 12.2.14.Rocklife .
Page 9: Contents
Contents 12.4.20.Resistor Calculator ......190 12.4.21.Rockpaint ....... . 191 12.4.22.Stats .
Page 10: Contents
Contents B.2.2. Featureset for codec speciﬁc metadata ....218 B.2.3. Limitations of metadata handling ....218 C.
Page 11: Contents
Contents G. User feedback G.1. Bug reports ........245 G.1.1.
Page 12: Introduction
Chapter 1. Introduction 1. Introduction 1.1. Welcome This is the manual for Rockbox. Rockbox is an open source ﬁrmware replacement for a growing number of digital audio players. Rockbox aims to be considerably more functional and eﬃcient than your device’s stock ﬁrmware while remaining easy to use and customisable.
Page 13: Naming Conventions And Marks
Chapter 1. Introduction main channel for Rockbox is #rockbox on irc://irc.freenode.net. Many helpful developers and users are usually around. Just join and ask your question (don’t ask to ask!) – if someone knows the answer you’ll usually get an answer pretty quickly. More information including IRC logs can be found at http://www.rockbox.org/irc/.
Page 14: Installation
Chapter 2. Installation 2. Installation Installing Rockbox is generally a quick and easy procedure. However before beginning there are a few important things to know. 2.1. Before Starting DRM capability. It is possible that installation of the bootloader may lead to you per- manently losing the ability to playback ﬁles with DRM.
Page 15: Automated Installation
Chapter 2. Installation Apart from the required parts there are some addons you might be interested in installing. Fonts. Rockbox can load custom fonts. The fonts are distributed as a separate package and thus need to be installed separately. They are not required to run Rockbox itself but a lot of themes require the fonts package to be installed.
Page 16: Manual Installation
Chapter 2. Installation Choosing a Rockbox version There are three diﬀerent versions of Rockbox available from the Rockbox website: Re- lease version, current build and archived daily build. You need to decide which one you want to install and get the appropriate version for your player. If you select either “Min- imal Installation”...
Page 17: Bootloader Installation From Windows
.rockbox, which contains all the ﬁles needed by Rockbox, in the main directory of your player’s drive. Installing the bootloader In order to install the bootloader, you will need to download the following ﬁles: An original ﬁrmware (OF) from Sansa’s website: http://forums.sandisk.com/t5/ Fuze/bd-p/Fuzeplus The bootloader: http://download.rockbox.org/bootloader/sandisk-sansa/fuzeplus/ bootloader-fuzeplus.sansa The version of mkimxboot for your operating system from Rockbox’s server:...
Page 18: Bootloader Installation From Mac Os X And Linux
Chapter 2. Installation 2.2.4. Bootloader installation from Mac OS X and Linux 1. Create a folder called “rbinstall” in your home directory, and then extract the OF, the bootloader and mkimxboot into it. 2. Open a new terminal, and navigate to the “rbinstall” folder. 3.
Page 19: Running Rockbox
ﬂashing procedure. To uninstall the bootloader completely follow the manual uninstal- lation instructions below. 2.5.2. Manual Uninstallation Copy an unmodiﬁed original ﬁrmware to your player, and then reboot into the Sandisk ﬁrmware. See section 3.1.3 (page 22) for more information.
Page 20 Chapter 2. Installation ﬁlename is correct, including case. Make sure that the patched Sansa ﬁrmware is called firmware.sb and present in the root directory of your player. “File Not Found” If you receive a “File Not Found” from the bootloader, then the bootloader cannot ﬁnd the Rockbox ﬁrmware.
Page 21: Quick Start
Chapter 3. Quick Start 3. Quick Start 3.1. Basic Overview 3.1.1. The player’s controls Power Volume Down Back Play Select Right Down Left Bottom-Left Bottom-Right Throughout this manual, the buttons on the player are labelled according to the picture above. Whenever a button name is preﬁxed by “Long”, a long press of approx- imately one second should be performed on that button.
Page 22: Starting The Original Firmware
Chapter 3. Quick Start 3.1.3. Starting the original ﬁrmware Rockbox has a dual-boot feature. To boot into the original ﬁrmware, when the player is turned oﬀ, press and hold the Volume Down button, and then press and hold the Power button while keeping the Volume Down button pressed. After 5 to 10 seconds the original ﬁrmware should boot.
Page 23: Basic Concepts
Chapter 3. Quick Start select an item. When browsing the ﬁle system selecting an audio ﬁle plays it. The view switches to the “While playing screen”, usually abbreviated as “WPS” (see section (page 33). The dynamic playlist gets replaced with the contents of the current directory. This way you can easily treat directories as playlists.
Page 24: Usb Charging
Chapter 3. Quick Start 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 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 computer and let you continue to use it normally.
Page 25: Browsing And Playing
Chapter 4. Browsing and playing 4. Browsing and playing 4.1. File Browser Figure 4.1.: The ﬁle browser Rockbox lets you browse your music in either of two ways. The File Browser lets you navigate through the ﬁles and directories on your player, entering directories and executing the default action on each ﬁle.
Page 26: File Browser Controls
Chapter 4. Browsing and playing 4.1.1. File Browser Controls Action Up/Down Go to previous/next item in list. If you are on the ﬁrst/last entry, the cursor will wrap to the last/ﬁrst entry. Back or Left Go to the parent directory. Select or Right Execute the default action on the selected ﬁle or enter a directory.
Page 27: Context Menu
Chapter 4. Browsing and playing 4.1.2. Context Menu Figure 4.2.: The Context Menu The Context Menu allows you to perform certain operations on ﬁles or directories. To access the Context Menu, position the selector over a ﬁle or directory and access the context menu with Long Select or Long Right.
Page 28 Chapter 4. Browsing and playing Paste. Only visible if a ﬁle or directory name is on the clipboard. When selected it will move or copy the clipboard to the current directory. Delete. Deletes the currently selected ﬁle. This option applies only to ﬁles, and not to directories.
Page 29: Virtual Keyboard
Chapter 4. Browsing and playing 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 ﬁle or creating a new directory. The virtual keyboard can be easily changed by making a text ﬁle with the required layout.
Page 30: Database
Chapter 4. Browsing and playing Action Bottom-Left / Move the line cursor within the text line. Bottom-Right Back Delete the character before the line cur- sor. Left / Right Move the cursor on the virtual keyboard. If you move out of the picker area, you get the previous/next page of characters (if there is more than one).
Page 31: The Database Menu
Chapter 4. Browsing and playing Ignoring Directories During Database Initialization You may have directories on your player whose contents should not be added to the database. Placing a ﬁle named database.ignore in a directory will exclude the ﬁles in that directory and all its subdirectories from scanning their tags and adding them to the database.
Page 32: Using The Database
Chapter 4. Browsing and playing Import Modiﬁcations. Allows the /.rockbox/database_changelog.txt backup to be conveniently loaded into the database. If Auto Update is enabled this is per- formed automatically when the database is initialized. 4.2.4. Using the Database Once the database has been initialized, you can browse your music by Artist, Al- bum, Genre, Song Name, etc.
Page 33: While Playing Screen
Chapter 4. Browsing and playing Type Origin ﬁlename string system album string id tag albumartist string id tag artist string id tag comment string id tag composer string id tag genre string id tag grouping string id tag title string id tag bitrate numeric...
Page 34 Chapter 4. Browsing and playing The ID3 album name. The ID3 artist name. Bit rate. VBR ﬁles 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 customising your WPS (While Playing Screen).
Page 35: Wps Key Controls
Chapter 4. Browsing and playing 4.3.1. WPS Key Controls Action Volume Up or Volume up/down. Up / Volume Down or Down Left Go to beginning of track, or if pressed while in the ﬁrst seconds of a track, go to the previous track. Long Left Rewind in track.
Page 36: The Wps Context Menu
Chapter 4. Browsing and playing The clip indicator: This is a little black block that is displayed at the very right of the scale when an overﬂow occurs. It usually does not show up during normal playback unless you play an audio ﬁle that is distorted heavily. If you encounter clipping while recording, your recording will sound distorted.
Page 37 Chapter 4. Browsing and playing Sound Settings This is a shortcut to the Sound Settings Menu, where you can conﬁgure volume, bass, treble, and other settings aﬀecting the sound of your music. See section (page 54) for more information. Playback Settings This is a shortcut to the Playback Settings Menu, where you can conﬁgure shuﬄe, repeat, party mode, skip length and other settings aﬀecting the playback of your music.
Page 38 Chapter 4. Browsing and playing This screen is accessible from the WPS screen, and provides a detailed view of all the identity information about the current track. This info is known as meta data and is stored in audio ﬁle formats to keep information on artist, album etc. To access this screen, press Long Bottom-Right.
Page 39: Working With Playlists
Chapter 4. Browsing and playing Action Bottom-Right Toggle pitch changing mode (cycle through all available modes). Up / Down Increase / Decrease pitch by 0.1% (in pro- centual mode) or 0.1 semitone (in semi- tone mode). Long Up / Long Increase / Decrease pitch by 1% (in pro- Down centual mode) or a semitone (in semitone...
Page 40 Chapter 4. Browsing and playing 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 playlist containing all of the songs in that directory and start playback with the selected song.
Page 41: Adding Music To Playlists
Chapter 4. Browsing and playing 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 27)), it allows you to put tracks into a “dynamic playlist”. If there is no music currently play- ing, Rockbox will create a new dynamic playlist and put the selected track(s) into it.
Page 42: Modifying Playlists
Chapter 4. Browsing and playing Queue. Queue is the same as Insert except queued tracks are deleted immediately from the playlist after they have been played. Also, queued tracks are not saved to the playlist ﬁle (see section 5.10 (page 51)). Queue Next.
Page 43: Saving Playlists
Chapter 4. Browsing and playing 4.4.5. Saving playlists To save the current playlist either enter the Playlist submenu in the WPS Context Menu (see section 4.3.3 (page 36)) and select Save Current Playlist or enter the Playlist Options menu in the Main Menu and select Save Current Playlist. Either method will bring you to the Virtual Keyboard (see section 4.1.3 (page 29)),...
Page 44: The Main Menu
Chapter 5. The Main Menu 5. The Main Menu 5.1. Introducing the Main Menu Figure 5.1.: The main menu The Main Menu is the screen from which all of the Rockbox functions can be accessed. This is the ﬁrst screen you will see when starting Rockbox. To return to the Main Menu, press the button.
Page 45: Navigating The Main Menu
Chapter 5. The Main Menu 5.2. Navigating the Main Menu Action Down Select the next option in the menu. Inside a setting, increase the value or choose next option. Select the previous option in the menu. Inside a setting,decrease the value or choose previous option.
Page 46: Files
Chapter 5. The Main Menu does not currently work for tracks launched via the database. In addition, they do not currently work with dynamic playlists. Action Down Select the next bookmark. Select the previous bookmark. Select or Right Resume from the selected bookmark. Back or Left Exit Recent Bookmark menu.
Page 47: Sound Settings
Chapter 5. The Main Menu cursor will jump to the default value for the parameter. You can then conﬁrm or cancel the value. This is useful if you have changed the value of the parameter from the default to some other value and would like to restore the default value. 5.7.1.
Page 48: Recording
Chapter 5. The Main Menu 5.8. Recording 5.8.1. While Recording Screen Figure 5.3.: The while recording screen Selecting the Recording option in the Main Menu enters the Recording Screen, whilst pressing Long Select or Long Right enters the Recording Settings (see sec- tion (page 88)).
Page 49: Fm Radio
Chapter 5. The Main Menu Action Up / Down Select setting. Left / Right Adjust selected setting. Play Start recording. While recording: pause recording (press again to continue). Back Exit Recording Screen. While recording: Stop recording. Open Recording Settings (see sec- tion (page 88)).
Page 50 Chapter 5. The Main Menu it from the ﬁle browser. Rockbox will “remember” and use it in PRESET mode until another ﬁle has been selected. Some preset ﬁles are available here: FmPresets. It is also possible to record the FM radio while listening. To start recording, enter the FM radio settings menu with Long Select and then select Recording.
Page 51: Playlists
Chapter 5. The Main Menu 5.10. Playlists This menu allows you to work with playlists. Playlists can be created in three ways. Playing a ﬁle in a directory causes all the ﬁles in it to be placed in a playlist. Playlists can be created manually by either using the Context Menu (see section 4.1.2 (page 27))
Page 52: Quick Screen
Chapter 5. The Main Menu Top Time: This item shows the cumulative overall runtime of your player since you last manually reset this item. A manual reset is done through pressing any button, followed by pressing Select or Right. Debug (Keep Out!): This sub menu is intended to be used only by Rockbox developers. It shows hardware, disk, battery status and other technical information.
Page 53 Chapter 5. The Main Menu The player can be turned oﬀ Note: Shortcuts into the database are not possible Shortcuts are loaded from the ﬁle /.rockbox/shortcuts.txt which lists each item to be displayed. Each shortcut looks like the following: Example [shortcut] type: <shortcut type>...
Page 54: Sound Settings
Chapter 6. Sound Settings 6. Sound Settings Figure 6.1.: The sound settings screen The sound settings menu oﬀers a selection of sound settings you may change to customise your listening experience. 6.1. Volume This setting adjusts the volume of 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).
Page 55: Bass
Chapter 6. Sound Settings 6.2. Bass This setting emphasises or suppresses the lower (bass) frequencies in the sound. A value of 0 dB means that bass sounds are unaltered (ﬂat response). The minimum setting is -24 dB and the maximum is 24 dB. 6.3.
Page 56: Stereo Width
Chapter 6. Sound Settings Karaoke. Removes all sound that is common to both channels. Since most music is recorded with vocals being equally present in both channels to make the singer sound centrally placed, this often (but not always) has the eﬀect of removing the voice track from a song.
Page 57 Chapter 6. Sound Settings to just one of the speakers. Many people will ﬁnd such records tiring to listen to using earphones and no crossfeed eﬀect. Crossfeed has the following settings: Crossfeed. Selects whether the crossfeed eﬀect is to be enabled or not. Direct Gain.
Page 58: Equalizer
Chapter 6. Sound Settings 6.10. Equalizer Figure 6.2.: The graphical equalizer Rockbox features a parametric equalizer (EQ). In contrast to non-parametric equalizers, a parametric EQ enables adjusting the center frequency, gain, and width of EQ bands separately. The ability to 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 (often 12+) needed in a non-parametric EQ.
Page 59 Chapter 6. Sound Settings In some ways the EQ is similar to the Bass and Treble settings described earlier, but the EQ allows you to control the sound much more carefully. Note that the parameteric EQ bands will be applied in addition to any bass or treble tone controls. Note: A maximum of 10 EQ bands are possible on most devices, but using more than are required will waste battery and introduce additional rounding noise.
Page 60 Chapter 6. Sound Settings quency range is. Higher Q values will aﬀect a narrower band of frequencies, while lower Q values will aﬀect a wider band of frequencies. Band 9: High shelf ﬁlter. A high shelf ﬁlter boosts or lowers all frequencies above a certain frequency limit, much as the “treble”...
Page 61: Dithering
Chapter 6. Sound Settings Save EQ Preset. This option saves the current EQ conﬁguration in a .cfg ﬁle. Browse EQ Presets. This menu displays a list of EQ presets, as well as any EQ con- ﬁgurations saved using the Save EQ Preset option. Users unfamiliar with the operation of a parametric EQ may wish to use the presets instead of trying to conﬁgure the EQ, or use the presets for designing their own custom EQ settings.
Page 62: Perceptual Bass Enhancement
Chapter 6. Sound Settings processing to determine and apply eﬀect to the side channel only. Finally, the Dry/Wet Mix setting adjusts the proportion mixed from the original (dry) and ’eﬀected’ (wet) signals. 6.14. Perceptual Bass Enhancement This setting implements a group delay correction and an additional biophonic EQ to emphasize to boost bass perception.
Page 63 Chapter 6. Sound Settings Limit means essentially a ratio of inﬁnity to one. In this case, the output signal is not allowed to exceed the threshold at all. The Knee setting determines how abrupt the transition is from a non-compressed signal to a compressed signal.
Page 64: Playback Settings
Chapter 7. Playback Settings 7. Playback Settings The Playback Settings menu allows you to conﬁgure settings related to audio play- back. 7.1. Shuﬄe Turning shuﬄe on will cause Rockbox to randomly re-order the playlist. Thus, to shuﬄe all of the audio ﬁles on the player, you ﬁrst need to create a playlist containing all of them.
Page 65: Play Selected First
Chapter 7. Playback Settings 7.3. Play Selected First This setting controls what happens when you select a ﬁle for playback while shuﬄe mode is on. If the Play Selected First setting is Yes, the ﬁle you selected will be played ﬁrst.
Page 66: Replaygain
Chapter 7. Playback Settings Fade In Delay. The “fade in delay” is the length of time between when the crossfade process begins and when the new track begins to fade in. Fade In Duration. The length of time, in seconds, that it takes your music to fade in once the Fade In Delay has ended.
Page 67: Track Skip Beep
Chapter 7. Playback Settings settings) have the same apparent volume. This prevents sudden changes in volume when changing between songs recorded at diﬀerent volume levels. For replaygain to work, the songs must have been processed by a program that adds replaygain information to the ID3 tags (or Vorbis tags).
Page 68: Constrain Auto-Change
Chapter 7. Playback Settings Note: This feature only works when songs have been played from the ﬁle browser. Using it with the database may cause unexpected behaviour. 7.11. Constrain Auto-Change If enabled and you have set Start File Browser Here to a directory other than root, Auto-Change Directory will be constrained to the directory you have chosen and those below it.
Page 69: Prevent Track Skipping
Chapter 7. Playback Settings 7.15. Prevent Track Skipping If this option is enabled, the ability to manually skip tracks is disabled in order to avoid accidental track skips. It does not prevent changing tracks if a track ends, which can be achieved by combining this option with Repeat set to One 7.16.
Page 70: General Settings
Chapter 8. General Settings 8. General Settings Figure 8.1.: The general settings screen 8.1. Playlist The Playlist sub menu allows you to conﬁgure settings related to playlists. Recursively Insert Directories. If set to On, then when a directory is inserted or queued into a dynamic playlist, all subdirectories will also be inserted.
Page 71 Chapter 8. General Settings Sort Case Sensitive. If this option is set to Yes, all ﬁles that start with upper case letters will be listed ﬁrst, followed by all ﬁles that begin with lower case letters. If this option is set to NO, then case will be ignored when sorting ﬁles. Sort Directories.
Page 72: Database
Chapter 8. General Settings Show Filename Extensions. This option controls how ﬁle extensions are shown in the File Browser. Oﬀ. The ﬁle extensions are never shown. On. The ﬁle extensions are always shown. Only unknown types. Only the extensions of unknown ﬁletypes are shown. Only when viewing all types.
Page 73 Chapter 8. General Settings 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 5 seconds.
Page 74 Chapter 8. General Settings Scroll Start Delay. Controls how many milliseconds Rockbox should wait before a new text begins automatically scrolling. Scroll Step Size. Deﬁnes the number of pixels the text should move for each step, as used by the Scroll Speed setting. Bidirectional Scroll Limit.
Page 75: System
Chapter 8. General Settings Clip Counter. Show the number of times the clip indicator went active during recording in front of the peak meters. Scale. Select whether the peak meter displays linear or logarithmic values. The human ear perceives loudness on a logarithmic scale. If the Scale setting is set to Logarithmic (dB) scale, the volume values are scaled logarithmically.
Page 76: Limits
Chapter 8. General Settings 8.5.2. Limits This sub menu relates to limits in the Rockbox operating system. Max Entries in File Browser. This setting controls the limit on the number of ﬁles that you can see in any particular directory in the ﬁle browser. You can conﬁgure the size to be between 50 and 10,000 ﬁles in steps of 50.
Page 77: Keyclick
Chapter 8. General Settings 8.5.5. Keyclick This menu controls key clicks on button presses. Keyclick. This setting controls how strong the keyclicks are. If set to Off, the keyclicks will be disabled. Keyclick repeats. This setting turns keyclick repeats On and Off. If set to On, the keyclicks will be repeated when you hold down a button.
Page 78: Usb Hid
Chapter 8. General Settings Disable Notify. Suppresses the notiﬁcation ’Buttons Locked’ (still will if power button is pressed). Note: This is a pre-requisite for selectivebacklight section (page 73) to work also during key lock. Selected actions are indicated by a leading +. Note: If all options get de-selected, the entire feature is disabled.
Page 79 Chapter 8. General Settings Action Play Slideshow start Long Play Slideshow leave Left Slide previous Right Slide next Long Left Slide ﬁrst Long Right Slide last Bottom-Right Black screen Long White screen Bottom-Right Up/ Down Previous / next link in slide, respectively Select Perform a ‘mouse click’...
Page 80: Usb Hide Internal Drive
Chapter 8. General Settings 8.5.10. USB Hide Internal Drive If this option is turned On, the internal storage drive will not be exposed on the USB Mass Storage Device. This e.g. makes it possible to access the card slot from systems that can not handle USB devices with multiple drives, such as some car audio systems.
Page 81: Sleep Timer
Chapter 8. General Settings 8.6.3. Sleep Timer The Sleep Timer powers oﬀ your player after a given time, whether playing or not. Start Sleep Timer (duration): Shown when the Sleep Timer is inactive, this option will initiate a Sleep Timer with the duration shown in brackets. Cancel Sleep Timer (remaining): Shown when the Sleep Timer is active, this option will cancel the current Sleep Timer.
Page 82 Chapter 8. General Settings Ask. Ask if a bookmark should be created. Yes – Recent Only. Always create a bookmark, but only in the recent bookmarks list. Ask – Recent Only. Ask if a bookmark should be created, but only add it to the recent bookmarks list.
Page 83: Automatic Resume
Chapter 8. General Settings Action Down Selects the next bookmark. Selects the previous bookmark. Select or Right Resumes from the selected bookmark. Back or Left Exits Recent Bookmark menu Long Select Deletes the currently selected bookmark Long Select or Enters the context menu for the selected Long Right bookmark.
Page 84: Language
Chapter 8. General Settings No. Automatic resume works only for manual track selection. Yes. Always attempt to resume – for both manual and automatic track changes. In custom directories only. Conﬁgure directories in which to enable resume on automatic track change. Selecting this option starts the text editor, in which you can enter the (absolute, case-insensitive) directory names separated by colons (“:”).
Page 85: Hotkey
Chapter 8. General Settings On. Use special pre-recorded ﬁles (_dirname.talk) in each directory. These must be generated in advance, and are typically produced synthetically using a text-to-speech engine on a PC. Oﬀ. No checking is made for directory .talk clips; they are not used even if present. This can reduce disk activity.
Page 86: Theme Settings
Chapter 9. Theme Settings 9. Theme Settings The Theme Settings menu oﬀers options that you can change to customize the visual appearance of Rockbox. Browse Theme Files. This option will display all the currently installed themes on the player, press Select or Right to load the chosen theme and apply it. A theme is a conﬁguration ﬁle, stored in a speciﬁc directory, that typically changes the WPS , font used and on some platforms additional information such as back- ground image and text colours.
Page 87 Chapter 9. Theme Settings Status Bar. Allows you to choose where to display the statusbar. Volume Display. Controls whether the volume is displayed as a graphic or a nu- meric value on the Status Bar. If you select a numeric display, volume is displayed in decibels.
Page 88: Recording Settings
Chapter 10. Recording Settings 10. Recording Settings Figure 10.1.: The recording settings screen Note: To change the location where recordings are stored open the Context Menu (see section 4.1.2 (page 27)) on the directory where you want to store them in the File Browser and select Set As Recording Directory.
Page 89: Frequency
Chapter 10. Recording Settings 10.3. Frequency Choose the recording frequency (sample rate). 96 kHz, 88.2 kHz, 64 kHz, 48 kHz, 44.1 kHz, 32 kHz, 24 kHz, 22.05 kHz, 16 kHz, 12 kHz, 11.025 kHz and 8 kHz are available. Higher sample rates use up more disk space, but give better sound quality. Note: The 11.025 kHz setting is not available when using MPEG Layer 3 format.
Page 90: Prerecord Time
Chapter 10. Recording Settings 10.8. Prerecord Time This setting buﬀers a small amount of audio so that when the record button is pressed, the recording will begin from that number of seconds earlier. This is useful for ensuring that a recording begins before a cue that is being waited for. 10.9.
Page 91 Chapter 10. Recording Settings Start Above. The start threshold deﬁnes the minimal volume a sound must have to start the recording. It is displayed numerically in the line “Start Above”. Note that the unit of the threshold depends on the settings of the peak meter. (i.e. When the peak meter displays dB you can adjust the level in dB and when the peak meter is set to linear the threshold is displayed as percentage.) In the peak meter at the bottom of the screen the start threshold is displayed graphically by a little triangle...
Page 92: Time And Date
Chapter 11. Time and Date 11. Time and Date Time related menu options. Pressing Long Select or Long Right will voice the current time if voice support is enabled. Set Time/Date: Set current time and date. Wake-Up Alarm: This option will make the player start up at the speciﬁed time. Use Up and Down to adjust the minutes setting, Left and Right to adjust the hours.
Page 93: Plugins
Chapter 12. Plugins 12. Plugins Plugins are programs that Rockbox can load and run. Only one plugin can be loaded at a time. Plugins have exclusive control over the user interface. This means you cannot switch back and forth between a plugin and Rockbox. When a plugin is loaded, you need to exit it to return to the Rockbox interface.
Page 94 Chapter 12. Plugins 12.1.1. 2048 Figure 12.1.: 2048 2048 is a simple, addictive puzzle game played by moving tiles in around on a 4x4 grid. Tiles slide as far as possible in the direction chosen by the player each turn until they are stopped by either another tile or the edge of the grid.
Page 95: Blackjack
Chapter 12. Plugins 12.1.2. Blackjack Figure 12.2.: Blackjack Blackjack, a game played in casinos around the world, is now available in the palm of your hand! The rules are simple: try to get as close to 21 without going over or simply beat out the dealer for the best hand.
Page 96: Boomshine
Chapter 12. Plugins 12.1.3. Boomshine This is a game coded in Lua that’s a clone of http://www.yvoschaap.com/chainrxn/. It is a rather basic game, but probably a good way to show oﬀ some of Lua’s features in Rockbox. 12.1.4. BrickMania Figure 12.3.: BrickMania BrickMania is a clone of the classic game Breakout.
Page 97: Bubbles
Chapter 12. Plugins Special items Displayed Name Description Normal Returns paddle to normal. Ball dies; lose a life. Life Gain a life. Fire Allows you to shoot bricks with paddle. Glue Ball sticks to paddle each time it hits. Ball Immediately ﬁres another ball.
Page 98: Chessbox
Chapter 12. Plugins The goal of the game is to beat each level as quickly as possible by clearing the board of all bubbles. Bubbles are removed from the board when a cluster of three of more of the same type is formed. The game is over when any bubbles on the board extend below the bottom line.
Page 99 Chapter 12. Plugins to watch. After that, you can scroll back and forth through the moves of the game. If the menu is invoked while in the viewer, the user is allowed to select a new match from the same ﬁle or quit the game. “Force play”...
Page 100: Chopper
Chapter 12. Plugins 12.1.7. Chopper Figure 12.6.: Chopper Navigate a cavernous maze without banging into walls, the ceiling, or the ﬂoor. How long can you ﬂy your chopper? Action Select Make chopper ﬂy Power Enter menu The Rockbox manual Sansa Fuze+ (version 3.14)
Page 101: Clix
Chapter 12. Plugins 12.1.8. Clix Figure 12.7.: Clix The aim is to remove all blocks from the board. 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.
Page 102: Codebuster
Chapter 12. Plugins 12.1.9. Codebuster Figure 12.8.: Codebuster Codebuster is a clone of the classic mastermind game. The computer selects a random combination of coloured pegs and the aim is to guess the correct combination in the smallest number of moves. After each attempt to guess the combination the results are displayed in the form of red and white pegs.
Page 103: Doom
Chapter 12. Plugins Action Select Roll dice again Back Quit 12.1.11. Doom Figure 12.9.: Doom This is the famous Doom game. Getting started For the game to run you need .wad game ﬁles located in /.rockbox/doom/ on your player. Create the directory and save the following ﬁles there: rockdoom.wad.
Page 104 Chapter 12. Plugins Menus Rockdoom Menu. The Rockdoom menu is shown when Doom is ﬁrst launched. This is the only time it can be accessed (before starting the game). To re-adjust Rockdoom options, you will need to quit your current game and restart the plugin. Main Menu.
Page 105: Flipit
Chapter 12. Plugins Keys Action Move Forward Down Down Left Turn Left Right Turn Right Select Shoot Play Open Back InGame Menu Select Enter Bottom-Left Change Weapon Playing the game After installation of the wad ﬁles is complete you can start the game. more description is needed 12.1.12.
Page 106: Goban
Chapter 12. Plugins Flipping the colour of the token under the cursor also ﬂips the tokens above, below, left and right of the cursor. The aim is to end up with a screen containing tokens of only one colour. Action Up / Down / Move the cursor Left / Right...
Page 107 Chapter 12. Plugins net/?SmartGameFormat or the SGF speciﬁcation at http://www.red-bean.com/sgf/. This plugin can load all modern SGF ﬁles (ﬁle format 3 or 4) with few problems. It attempts to preserve SGF properties which it doesn’t understand, and most common SGF properties are handled fully. It is possible to view (and edit if you like) Kogo’s Joseki Dictionary (http://waterﬁre.us/joseki.htm) with this plugin, although the load and save times can be on the order of a minute or two on particularly slow devices.
Page 108 Chapter 12. Plugins Controls Action Move cursor up Down Move cursor down Left Move cursor left Right Move cursor right Select Play a move (or use a tool if play-mode has been changed). Back Retreat one node in the game tree Play Advance one node in the game tree Power...
Page 109 Chapter 12. Plugins Overtime. The overtime settings of the current game. Result. The result of the current game. This text must follow the format speciﬁed http://www.red-bean.com/sgf/properties.html#RE to be read by other SGF readers. Some examples are B+R (Black wins by resignation), B+5.5 (Black wins by 5.5 points), W+T (White wins on Time).
Page 110 Chapter 12. Plugins Play Mode. Play moves normally on the board. If there are child moves from the current node, this mode will let you follow variations by simply playing the ﬁrst move in the sequence. Unless it is following a variation, this mode will not allow you to play illegal moves.
Page 111: Invadrox
Chapter 12. Plugins 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! Action Left Move left...
Page 112: Jackpot
Chapter 12. Plugins 12.1.15. Jackpot 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. Action Select Play Back Exit the game The Rockbox manual Sansa Fuze+ (version 3.14)
Page 113: Jewels
Chapter 12. Plugins 12.1.16. Jewels Figure 12.14.: Jewels Jewels is a simple 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.
Page 114: Mazezam
Chapter 12. Plugins Action Up/Down/Left/Right Navigate maze Back Exit plugin Long Select New Maze Select Display solution (toggle) 12.1.18. MazezaM Figure 12.15.: MazezaM The goal of this puzzle game is to escape a dungeon consisting of ten “mazezams”. These are rooms containing rows of blocks which can be shifted left or right. You can move the rows only by pushing them and if you move the rows carelessly, you will get stuck.
Page 115: Minesweeper
Chapter 12. Plugins 12.1.19. Minesweeper Figure 12.16.: Minesweeper plugin The classic game of minesweeper. The 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.
Page 116: Pacbox
Chapter 12. Plugins 12.1.20. Pacbox Figure 12.17.: Pacbox Pacbox is an emulator of the Pacman arcade machine hardware. It is a port of PIE – Pacman Instructional Emulator by Alessandro Scotti. ROMs To use the emulator to play Pacman, you need a copy of ROMs for “Midway Pacman”. Filename MD5 checksum pacman.5e...
Page 117: Pegbox
Chapter 12. Plugins Keys Action Move Up Down Move Down Left Move Left Right Move Right Play Insert Coin Select 1-Player Start 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 triangles which form a solid block and crosses which allow you to choose a replacement block.
Page 118: Pong
Chapter 12. Plugins Action Up, Down, Left, to move around Right Select to choose peg Back to restart level Volume Up to go up a level Volume Down to go down a level Power to quit 12.1.22. Pong Figure 12.19.: Pong Pong is a simple one or two player “tennis game”.
Page 119: Puzzles
Chapter 12. Plugins 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 Sansa Fuze+ (version 3.14)
Page 120: Reversi
Chapter 12. Plugins Figure 12.21.: “Map” from Puzzles “Puzzles” is a port of Simon Tatham’s Portable Puzzle Collection. For documenta- tion on the games included, please visit (http://www.chiark.greenend.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.
Page 121: Robotﬁndskitten
Chapter 12. Plugins 12.1.25. Robotﬁndskitten Figure 12.22.: Robotﬁndskitten In this game, you are robot (#). Your job is to ﬁnd 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.
Page 122: Rockblox
Chapter 12. Plugins 12.1.26. Rockblox Figure 12.23.: Rockblox Rockblox is a Rockbox version of the classic falling blocks game from Russia. The aim of the game is to make the falling blocks of diﬀerent shapes form full rows. Whenever a row is completed, it will be cleared away, and you gain points. For every ten lines completed, the game level increases, making the blocks fall faster.
Page 123: Rockblox1D
Chapter 12. Plugins 12.1.27. Rockblox1d Rockblox1d is a game for people who ﬁnd rockblox too hard. In this version the second dimension is missing so the user only has to move the bricks down. No horizontal moving anymore and no need to rotate the brick! Action Down Move down faster...
Page 124: Snake
Chapter 12. Plugins Action Left, Right, Up Move Tile and Down Long Play Shuﬄe Long Select Switch between pictures (default puz- zle, album art, and your own image if launched via Open With), and numbered tiles Power Stop the game 12.1.29.
Page 125: Snake 2
Chapter 12. Plugins Action Up / Down / Move snake Left / Right Play Toggle Play/Pause Power Go to the plugin’s menu 12.1.30. Snake 2 Figure 12.26.: Snake 2 – The Snake Strikes Back Another version of the Snake game. Move the snake around, and eat the apples that pop up on the screen.
Page 126: Sokoban
Chapter 12. Plugins 12.1.31. Sokoban Figure 12.27.: Sokoban The object of the game is to push boxes into their correct position in a crowded warehouse with a minimal number of pushes and moves. The boxes can only be pushed, never pulled, and only one can be pushed at a time.
Page 127 Chapter 12. Plugins Action In game Up, Down, Left, Move the “sokoban” up, down, left, or Right right Power Menu Volume Down Back to previous level Back Restart level Volume Up Go to next level Bottom-Left Undo last movement Bottom-Right Redo previously undone move Solution playback Play...
Page 128: Solitaire
Chapter 12. Plugins 12.1.32. Solitaire Figure 12.28.: Klondike solitaire This is the classic Klondike solitaire game for Rockbox. This is probably the best-known solitaire in the world. Many people do not even realize that other 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.
Page 129: Spacerocks
Chapter 12. Plugins Action Up / Down / Move Cursor around. Left / Right Select Select cards, move cards, reveal hidden cards... Back If a card was selected – unselect it, else Draw 3 new cards from the remains stack Bottom-Left Put the card from the top of the remains stack on top of the cursor...
Page 130: Star
Chapter 12. Plugins Action Select Shoot Thrust Left/ Right Turn left/right Back Teleport Play Pause game Power Quit 12.1.34. Star Figure 12.30.: Star game This is a puzzle game. It is actually a rewrite of Star, a game written by CDK designed for the hp48 calculator.
Page 131: Sudoku
Chapter 12. Plugins Action Left Move Left Right Move Right Move Up Down Move Down Play Switch between circle and square Volume Down Previous level Long Back Reset level Volume Up Next level Power Exit the game 12.1.35. Sudoku Figure 12.31.: Sudoku Sudoku in Rockbox can act as both a plugin and a viewer.
Page 132: Superdom
Chapter 12. Plugins You can create and save your own grids under the New menu option. Enter the menu (as described in the key table below) when you have ﬁnished and enter the full path to save to including the .ss extension (e.g. /sudoku/new.ss). The scratchpad When you play Sudoku on paper most people like to mark numbers in cells that are possible candidates for the cells.
Page 133 Chapter 12. Plugins When the game starts the player is given roughly 50two farms, and two factories. To overpower the enemy, you must place resources in adjacent tiles (diagonals do not count), such that your strength is greater than the computers, then attack the square. Each “year”...
Page 134: Wormlet
Chapter 12. Plugins 12.1.37. Wormlet Figure 12.32.: Wormlet game Wormlet is a multi-worm game on a multi-threaded multi-functional Rockbox console. You navigate a hungry little worm. Help your worm to ﬁnd food and to avoid poisoned argh-tiles. The goal is to turn your tiny worm into a big worm for as long as possible. Game controls: Action Left...
Page 135 Chapter 12. Plugins Food. The small square hollow pieces are food. Move the worm over a food tile to eat it. After eating the worm grows. Each time a piece of food has been eaten a new piece of food will pop up somewhere. Unfortunately for each new piece of food that appears two new “argh”...
Page 136 Chapter 12. Plugins your worm has moved 7 steps the food is used up. If another piece of food is eaten while growing it will increase the size of the worm for another 7 steps. Crashed: This indicates that a worm has crashed against a wall. Argh: If the score board entry displays “Argh!”...
Page 137: Xobox
Chapter 12. Plugins 12.1.38. Xobox Figure 12.33.: Xobox Xobox is a simple clone of the well known arcade game Qix. The aim of the game is to section oﬀ parts of the arena with your trail in order to remove that section from the game.
Page 138: Demos
Chapter 12. Plugins Additionally, “extra” data ﬁles that modify the in-game strings and font can be placed in the .rockbox/xworld/ directory with the names xworld.strings and xworld.font, respectively. Action Up and Jump Down Down and Crouch Left / Right Move Left and Right Volume Up Action and Fire Volume Down...
Page 139: Credits
Chapter 12. Plugins Action Up/ Down Moves to next/previous option Right / Left Increases/decreases option value Select Toggles Scroll mode Back or 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.
Page 140: Demystify
Chapter 12. Plugins This is a rotating cube screen saver in 3D. Action Back Display at maximum frame rate Play Pause Select Cycle draw mode Right / Left Select axis to adjust Up / Down Change speed/angle (speed can not be changed while paused) Power Quit...
Page 141: Fft
Chapter 12. Plugins 12.2.5. FFT This plugin is a basic frequency analyzer with 3 diﬀerent frequency-amplitude plots (lines, bars, and spectrogram). 12.2.6. Fire Figure 12.37.: Fire Fire is a demo displaying a ﬁre eﬀect. Action Up / Down Increase / decrease number of ﬂames Left Toggle ﬂame type Right...
Page 142: Fractals
Chapter 12. Plugins 12.2.7. Fractals Figure 12.38.: Fractals: Mandelbrot set This demonstration draws fractal images from the Mandelbrot set. Action Direction keys Move about the image Select Zoom in Play 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...
Page 143: Matrix
Chapter 12. Plugins 12.2.9. Matrix This plugin is a visual demo resembling the scrolling code from “The Matrix” (https: //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. Action Change the gap between the drawing lines.
Page 144: Oscilloscope
Chapter 12. Plugins 12.2.11. Oscilloscope Figure 12.40.: Oscilloscope This demo shows the shape of the sound samples that make up the music being played. At faster speed rates, the player is less responsive to user input and music may start to skip.
Page 145: Pictureflow
Chapter 12. Plugins 12.2.12. PictureFlow Figure 12.41.: PictureFlow PictureFlow provides a visualisation of your albums with their associated cover art. It is possible to start playback of the selected album from PictureFlow. Playback will start from the selected track. The PictureFlow plugin will continue to run while your tracks are played.
Page 146 Chapter 12. Plugins Keys Action Left / Right Scroll through albums Up / Down Scroll through track list Select Enter track list / Play album from se- lected track Left or Back Exit track list long Select Enter menu Power Exit PictureFlow Main Menu Go to WPS.
Page 147: Plasma
Chapter 12. Plugins Rebuild cache. Rebuild the PictureFlow cache. This is needed in order for PictureFlow to pick up new albums, and may occasionally be needed if albums are removed. 12.2.13. Plasma Figure 12.42.: Plasma Plasma is a demo displaying a 80’s style retro plasma eﬀect. Action Up / Down Increase / decrease Frequency...
Page 148: Snow
Chapter 12. Plugins Action Select Play/pause Down Change growth mode Right Next 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 demo.
Page 149: Starﬁeld
Chapter 12. Plugins 12.2.16. Starﬁeld Figure 12.44.: Starﬁeld Starﬁeld simulation (like the classic screensaver). Action Right / Left Increase / decrease number of stars Up / Down Increase / decrease speed Select Change colours Back or Power Quit The Rockbox manual Sansa Fuze+ (version 3.14)
Page 150: Vu Meter
Chapter 12. Plugins 12.2.17. VU meter Figure 12.45.: VU-Meter This is a VU meter, which displays the volume of the left and right audio channels. There are 3 types of meter selectable. The analogue meter is a classic needle style. The digital meter is modelled after LED volume displays, and the mini-meter option allows for the display of small meters in addition to the main display (as above).
Page 151: Shortcuts
Chapter 12. Plugins Note: Some viewer plugins can only be used by selecting the Open With... option from the Context Menu (see section 4.1.2 (page 27)). Viewer Plu- Associated ﬁletype(s) Context Menu only Shortcuts .link Chip-8 Emula- .ch8 Frotz .z1 - .z8 Image Viewer .bmp, .jpg, .jpeg, .png, .ppm scripting...
Page 152: Chip-8 Emulator
Chapter 12. Plugins How to use .link ﬁles, i.e. jump to desired places To use a .link ﬁle just “play” it from the ﬁle browser. This will show you a list with the entries in the ﬁle. Selecting one of them will then exit the plugin and leave you within the directory selected, or with the ﬁle selected in the ﬁle browser.
Page 153: Frotz
Chapter 12. Plugins would correspond to the following non-default mappings: 2, 6 8, 7 4, 8 The default keymappings are: Chip8 Oﬀ Some places where can you can ﬁnd .ch8 ﬁles: The PluginChip8 page on www.rockbox.org has several attached: PluginChip8 Check out the HP48 chip games section: http://www.hpcalc.org/hp48/games/chip/ Links to other chip8 emulators:...
Page 154: Image Viewer
Chapter 12. Plugins The Frotz homepage (for the original Unix port): http://frotz.sourceforge.net/ A Beginner’s Guide to Playing Interactive Fiction: http://www.microheaven.com/ IFGuide/ Action Display keyboard to enter text Select Press enter Back Open Frotz menu (not available at MORE prompts) Power Quit 12.3.4.
Page 155: Lua Scripting Language
Chapter 12. Plugins The menu has the following entries. Return. Returns you to the image Toggle Slideshow Mode. Enables or disables the slideshow mode. Change Slideshow Timeout. You can set the timeout for the slideshow between 1 sec- ond and 20 seconds. Show Playback Menu.
Page 156: Midiplay
Chapter 12. Plugins 12.3.6. Midiplay To get MIDI ﬁle playback, a patchset is required. This ﬁle contains the instruments required to synthesize the music. A sample patchset is available through the wiki at PluginMidiPlay, and needs to be extracted to the .rockbox directory in the root of your player.
Page 157 Chapter 12. Plugins Resume at: mm:ss Resume video playback at stored resume time mm:ss (start of the video if no resume time is found). Set start time A preview screen is presented consisting of a thumbnail preview and a progress bar where the user can select a start time by ‘seeking’ through the video. The video playback is started by pressing the select button.
Page 158: Mp3 Encoder
Chapter 12. Plugins Backlight Brightness (default: Use setting) Choose brightness to use during video play- back. Set to Use setting to use the Brightness setting. Audio Options Menu Tone Controls (default: force oﬀ) Use the bass and treble control settings or force them oﬀ.
Page 159: Rockboy
Chapter 12. Plugins 12.3.9. Rockboy Figure 12.46.: Rockboy Rockboy is a Nintendo Game Boy and Game Boy Color emulator for Rockbox based on the gnuboy emulator. To start a game, open a ROM ﬁle saved as .gb or .gbc in the ﬁle browser.
Page 160: Search
Chapter 12. Plugins Save Game. . . Saves your current state. Options. . . Max Frameskip. Change frameskip setting to improve speed. Sound. Toggle sound on or oﬀ. Stats. Toggle showing fps and current frameskip. Set Keys (BUGGY) Select this option to set a new keymapping. Note: The direction keys are set for the normal screen orientation, not the rotated orientation.
Page 161: Sort
Chapter 12. Plugins There are two modes, edit mode and view mode. The edit mode shows all the items, and it allows you to select which of the items you want to buy. When you have ﬁnished selecting the items, use the menu to go to the view mode, and you will see only the items you wish to buy.
Page 162: Speedread
Chapter 12. Plugins 12.3.13. Speedread Figure 12.47.: speedread This plugin is designed for reading plain-text ﬁles such as ebooks. It works by using a form of Rapid Serial Visual Presentation (RSVP) that has optimized word placement to reduce or eliminate eye movement (saccades) when reading. The Rockbox manual Sansa Fuze+ (version 3.14)
Page 163: Text Viewer
Chapter 12. Plugins 12.3.14. Text Viewer Figure 12.48.: Text Viewer This is a Viewer for text ﬁles with word wrap. Just open a .txt or .nfo ﬁle to display it. The text viewer features controls to handle various styles of text formatting and has top-of-ﬁle and bottom-of-ﬁle buttons.
Page 164 Chapter 12. Plugins Default keys Action Scroll-up Down Scroll-down Left Top of ﬁle (Narrow mode) / One screen left (Wide mode) Right Bottom of ﬁle (Narrow mode) / One screen right (Wide mode) Volume Up One line up Volume Down One line down Bottom-Left One column left...
Page 165 Chapter 12. Plugins Screens Per Page Set the number of screens per page. Available options are 1 to 5 screens per page. Alignment Set the text alignment. Right Set the text alignment to the right. (Useful for displaying right-to-left languages, such as Arabic or Hebrew) Left Set the text alignment to the left.
Page 166 Chapter 12. Plugins Scroll by Page Scroll up or down one full screen. Scroll by Line Scroll up or down one line. Overlap Pages Set whether the last line from the previous screen is re- tained when scrolling pages. No Do not retain previous line. Yes Retain previous line.
Page 167 Chapter 12. Plugins Figure 12.49.: The select bookmark menu Global Settings Set the default settings for the text viewer. The setting items are the same as Viewer Options. The global 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_file.dat.
Page 168: Theme Remove
Chapter 12. Plugins Figure 12.50.: A bookmark 12.3.15. Theme Remove This plugin oﬀers a way to remove a theme. Open the Context Menu (see section 4.1.2 (page 27)) upon a theme.cfg ﬁle and select Open With... theme_remove. Some ﬁles are not removed regardless of the Remove Options such as rockbox_default.wps and the font ﬁle currently in use.
Page 169: Vbrﬁx
Chapter 12. Plugins Always Remove. Selecting this option will remove the ﬁle with no regard to whether it’s used by another theme or not. Font. Speciﬁes how the .fnt ﬁle belonging to a theme .cfg ﬁle is handled. If this option is set to Remove if not Used, the fonts came from rockbox-fonts.zip will not be removed as themes may depend on those fonts.
Page 170: Zxbox
Chapter 12. Plugins 12.3.17. ZXBox Figure 12.51.: ZXBox ZXBox is a port of the “Spectemu” ZX Spectrum 48k emulator for Rockbox (https: //sourceforge.net/projects/spectemu/). To start a game open a tape ﬁle or snapshot saved as .tap, .tzx, .z80 or .sna in the ﬁle browser. Note: As ZXBox is a 48k emulator only loading of 48k z80 snapshots is possible.
Page 171 Chapter 12. Plugins ZXBox menu Vkeyboard. This is a virtual keyboard representing the Spectrum keyboard. Controls are the same as in standard Rockbox, but you just press one key instead of entering a phrase. Play/Pause Tape. Toggles playing of the tape (if it is loaded). Save Quick Snapshot.
Page 172: Applications
Chapter 12. Plugins 12.4. Applications 12.4.1. Alarm Clock This plugin is an alarm clock, which resumes a paused song at a given time. Key conﬁguration Action Left / Right Switch between hours/minutes selection Up / Down Increase/Decrease hours/minutes Select Set the alarm Back Exit Setting an alarm...
Page 173 Chapter 12. Plugins Information explained At the top of the battery_bench.txt ﬁle is various information on how to use the plugin, followed by the data themselves. Time This column reports the total time of operation of the player. It is not the time that you started the plug-in.
Page 174: Calculator
Chapter 12. Plugins 12.4.3. Calculator Figure 12.52.: Calculator This is a simple scientiﬁc calculator for use on the player. It works like a standard calculator. Pressing the “1st” and “2nd” buttons will toggle between other available math functions. Action Left / Right / Move around the keypad Up / Down Select...
Page 175: Calendar
Chapter 12. Plugins 12.4.4. Calendar Figure 12.53.: Calendar This is a small and simple calendar application with memo saving function. Dots indicate dates with memos. The available memo types are: one oﬀ, yearly, monthly, and weekly memos. You can select what day is ﬁrst day of week by the setting First Day of Week in the menu.
Page 176: Chess Clock
Chapter 12. Plugins 12.4.5. Chess Clock Figure 12.54.: 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. Setup Action Right / Left Increase / decrease displayed Value Select Move to next screen...
Page 177: Clock
Chapter 12. Plugins While playing The number of the current player is displayed on the top line. The time below is the time remaining for that round (and possibly also the total time left if diﬀerent). Keys are as follows: Action Power Exit plugin...
Page 178 Chapter 12. Plugins This is a fully featured analogue and digital clock plugin. Key conﬁguration Action Left / Right Cycle through modes Up / Down Cycle through skins Back Main Menu Select Start / Stop Counter Long Select Reset Counter Clock Menu View Clock Exits the menu and returns to the current clock mode display.
Page 179: Dict
Chapter 12. Plugins at the lower left. 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.
Page 180: Disk Tidy
Chapter 12. Plugins folder. The dictionary ﬁles can be created by yourself, or you can get them crafted from the web. More information can be found at PluginDict. Using the plugin Now that you already have the two necessary ﬁles in place, you can launch the dict plugin (under Applications on the Browse plugins menu).
Page 181: Keybox
Chapter 12. Plugins Action Back or Left Exit / Abort 12.4.9. Keybox Keybox is an encrypted password storage using the “Tiny Encryption Algorithm” with a key derived using md5. Using Keybox To get started, start up the plugin and select Enter Keybox. The ﬁrst time you enter Keybox you will be prompted for a master password and for conﬁrmation of the master password.
Page 182 Chapter 12. Plugins 2. .lrc8 3. .snc 4. .txt 5. id3v2 SYLT or USLT tags in mp3 ﬁles .lrc8 ﬁles are the same as .lrc ﬁles except that they are UTF8 encoded. The Lyrics3 tag is not supported. Supported tags and formats for .lrc ﬁles The following tags are supported: [ti:title] [ar:artist]...
Page 183 Chapter 12. Plugins /Music/Artist/Album/Title.ext /Music/Artist/Title.ext /Music/Title.ext /Title.ext /Music/Artist/Album/Lyrics/Title.ext /Music/Artist/Lyrics/Title.ext /Music/Lyrics/Title.ext /Lyrics/Title.ext /Lyrics/Musics/Artist/Album/Title.ext /Lyrics/Musics/Artist/Title.ext /Lyrics/Musics/Title.ext /Lyrics/Title.ext Controls Action Volume Up or Volume up/down. Up / Volume Down or Down Left Go to beginning of track, or if pressed while in the ﬁrst seconds of a track, go to the previous track.
Page 184: Main Menu Conﬁguration
Chapter 12. Plugins Display Settings. Change how the lyrics are displayed. Wrap. Breaks lines at white space. Wipe. Wipes the text. Alignment. Align text to the left, centre, or right. Activate Only Current Line. Activate only the current line, or the current and previous lines.
Page 185: Md5Sum
Chapter 12. Plugins 12.4.13. md5sum Open a ﬁle, a directory or just launch it from the plugin menu to create an md5sum of the ﬁle, the directory’s contents or the whole ﬁlesystem. If the ﬁle’s extension is .md5 or .md5sum, it will check the md5 sums in the ﬁle instead. If the ﬁle’s extension is .md5list it will compute md5 sums for all the ﬁles listed.
Page 186 Chapter 12. Plugins diﬀering tempo (always in quarter beats per minute, default 120) with – one tempo per bar or even one tempo per beat, or – smooth tempo changes with conﬁgurable acceleration, and custom beat patterns (tick/tock/silence on each beat), default being emphasis (tick) on ﬁrst beat, normal sound (tock) on others.
Page 187 Chapter 12. Plugins 0 4/4 90-150*0.25 0 4/4 150-90/4 16 4/4 100-200 The ﬁrst one goes from 90 to 150 bpm in an endless part with 0.25 bpm increase per bar. The second one goes down from 150 to 90 with 4 bars per bpm change, which is the same acceleration as in the ﬁrst line.
Page 188: One-Time Password Client
Chapter 12. Plugins rumbling: 4 3/4 90 X.x # 3/4, first (tick) and last (tock) ramp-up: 8 2/4 90-150 # speeding up to 150 bpm again flow: 4 # steady 4/4 at 150 bpm death: 8 150-60 # going down to 60 final: 1 1/1 60 # one last hit 12.4.15.
Page 189: Advanced Settings
Chapter 12. Plugins must scan the QR code separately, and then enter the string following the “secret=” parameter on your Rockbox device manually. On devices with a real-time clock, like yours, the plugin will ask whether the account is a time-based account (TOTP). If you answer “yes” to this question, it will ask for further information regarding the account.
Page 190: Random Folder Advance Conﬁguration
Chapter 12. Plugins 12.4.19. Random Folder Advance Conﬁguration This plugin is used to conﬁgure the folders which will be considered when the Auto- Change Directory feature is set to Random. Menu Generate Folder List Generates a list of all folders found on the player. You can ﬁlter the directories which are scanned by creating a ﬁle called /.rockbox/folder_advance_dir.txt.
Page 191: Rockpaint
Chapter 12. Plugins Colour to Resistance In Colour to Resistance mode, use the menus to select the colours of the bands of a resistor which you would like to know the resistance of. Resistance to Colour In Resistance to Colour mode, use the menus to select the unit that you would like to use (choose from Ohms, Kiloohms, Megaohms), and use the on-screen keyboard to input the value of the resistor that you would like to know the colour code of.
Page 192 Chapter 12. Plugins Rockpaint is a bitmap (.bmp) editor for Rockbox. It can open any .bmp ﬁle whose di- mensions are the same size as your device’s screen or smaller; it can also create empty bitmaps for you to work with. Opening A File To open a ﬁle, you may use either the context menu option “Open With”...
Page 193 Chapter 12. Plugins Text tool “Draws” text on the image. Filled rectangle Same as the Rectangle tool, but ﬁlls it with colour. Filled circle Same as the Circle tool, but ﬁlls it with colour. Curved Gradient Fill Same as Gradient ﬁll, but you must draw two lines. Rockpaint will draw a curved, gradual change of colour in the region.
Page 194: Stats
Chapter 12. Plugins Action Power Quits Rockpaint immediately. Left / Right / Moves the cursor around. Up / Down Displays the Main Menu. Bottom-Left or Displays the toolbar. Bottom-Right Volume Up Toggles the brush and selects objects. 12.4.22. Stats Figure 12.58.: The stats-plugin The stats plugin counts the directories and ﬁles (the total number as well as the number of audio, playlist, image and video ﬁles) on your player.
Page 195: Stopwatch
Chapter 12. Plugins 12.4.23. Stopwatch Figure 12.59.: Stopwatch A simple stopwatch program with support for saving times. Action Quit Plugin Start / stop Reset timer (only when timer is stopped) Take lap time Scroll through lap times 12.4.24. Text Editor This plugin allows you to view and edit simple text documents on your DAP.
Page 196 Chapter 12. Plugins screen. You can now edit the ﬁle. The Text Editor is line based. This means you can edit one line at a time using the Virtual Keyboard (see section 4.1.3 (page 29)). Move the selection bar to the line you want to edit. Edit the highlighted text line or insert a new one using the Item Menu.
Page 197: Advanced Topics
Chapter 13. Advanced Topics 13. Advanced Topics 13.1. Customising the User Interface 13.1.1. Customising The Main Menu It is possible to customise the main menu, i.e. to reorder or to hide some of its items (only the main menu can be customised, submenus can not). To accomplish this, load a .cfg ﬁle (as described in section 13.3 (page 207)) containing the following line:...
Page 198: Loading Languages
Chapter 13. Advanced Topics Font in the Main Menu. Settings Theme Settings Note: Advanced Users Only: Any BDF font should be usable with Rockbox. To convert from .bdf to .fnt, use the convbdf tool. This tool can be found in the tools directory of the Rockbox source code.
Page 199: Loading Backdrops
Chapter 13. Advanced Topics The permissible extensions are as follows: folder, m3u, m3u8, cfg, wps, lng, rock, bmark, cue, colours, mpa, sansa, mp1, mp2, mp3, ogg, oga, wma, wmv, asf, wav, flac, ac3, a52, mpc, wv, m4a, m4b, mp4, mod, shn, aif, aiff, spx, sid, adx, nsf, nsfe, spc, ape, mac, sap, mpg, mpeg, bmp, fmr, fnt, kbd All ﬁle extensions that are not either speciﬁcally listed in the .colours ﬁles or are not in the list above will be set to the colour given by ???.
Page 200: Ui Viewport
Chapter 13. Advanced Topics Menu (see section 4.1.2 (page 27)) on it and select the option Set As Backdrop. If you want rockbox to remember your backdrop the next time you start your player the backdrop must be placed in the /.rockbox/backdrops directory. 13.1.7.
Page 201: Themes - Create Your Own
Chapter 13. Advanced Topics 13.2.2. Themes – Create Your Own The theme ﬁles are simple text ﬁles, and can be created (or edited) in your favourite text editor. To make sure non-English characters display correctly in your theme you must save the theme ﬁles with UTF-8 character encoding. This can be done in most editors, for example Notepad in Windows 2000 or XP (but not in 9x/ME) can do this.
Page 202 Chapter 13. Advanced Topics Viewport Declaration Syntax %V(x,y,[width],[height],[font]) %Vf([fgcolour]) %Vb([bgcolour]) %Vg(start, end [,text]) %Vf and %Vb set the foreground and background colours respectively. ‘fgcolour’ and ‘bgcolour’ are 6-digit RGB888 colours, e.g. FF00FF. %Vg deﬁnes a gradient ﬁll that can then be used with the %Vs tag. ‘start’ and ‘end’...
Page 203 Chapter 13. Advanced Topics Mode Description clear Restore the default style invert Draw lines inverted color Draw the text coloured by the value given in ‘param’. Functionally equivalent to using the %Vf() tag gradient Draw the next ‘param’ lines using a gradient as de- ﬁned by %Vg.
Page 204: Info Viewport (Sbs Only)
Chapter 13. Advanced Topics 13.2.3. Info Viewport (SBS only) As mentioned above, it is possible to set a UI viewport via the theme .cfg ﬁle. It is also possible to set the UI viewport through the SBS ﬁle, and to conditionally select diﬀerent UI viewports.
Page 205 Chapter 13. Advanced Topics 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.
Page 206 Chapter 13. Advanced Topics Conditionals can be used with sublines to display a diﬀerent set and/or number of sublines on the line depending on the evaluation of the conditional. Example subline with conditionals: Example %?it<%t(8)%s%it|%s%fn>;%?ia<%t(3)%s%ia|%t(0)> The format above will do two diﬀerent things depending if ID3 tags are present. If the ID3 artist and title are present: Display id3 title for 8 seconds, Display id3 artist for 3 seconds,...
Page 207: Managing Rockbox Settings
Chapter 13. Advanced Topics Example File Example %s%?in<%in - >%?it<%it|%fn> %?ia<[%ia%?id<, %id>]> %pb%pc/%pt That is, “tracknum – title [artist, album]”, where most ﬁelds are only displayed if avail- able. Could also be rendered as “ﬁlename” or “tracknum – title [artist]”. 13.3.
Page 208: The Manage Settings Menu
Chapter 13. Advanced Topics show files: supported wps: /.rockbox/car.wps lang: /.rockbox/afrikaans.lng Note: As you can see from the example, conﬁguration ﬁles do not need to contain all of the Rockbox options. You can create conﬁguration ﬁles that change only certain set- tings.
Page 209: Firmware Loading
Chapter 13. Advanced Topics Save Theme Settings This option writes a .cfg ﬁle to your player’s disk. The conﬁg- uration ﬁle has the .cfg extension and is used to store all of the theme related settings. 13.4. Firmware Loading 13.4.1. Using ROLO (Rockbox Loader) Rockbox is able to load and start another ﬁrmware ﬁle without rebooting.
Page 210: Audio Format And Bitrate
Chapter 13. Advanced Topics 13.5.4. Audio format and bitrate In general the fastest decoding audio format will be the best in terms of battery runtime on your player. An overview of diﬀerent codec’s performance on diﬀerent players can be found at CodecPerformanceComparison.
Page 211: A. File Formats
Appendix A. File formats The Rockbox manual Sansa Fuze+ (version 3.14)
Page 212: Supported File Formats
Appendix A. File formats A. File formats A.1. Supported ﬁle formats Icon File Type Extension Action when selected Directory none Enter the directory Audio ﬁle various Start playing the ﬁle and show the (see B.1) Bookmark Display all bookmarks for an audio .bmark ﬁle Game of Life...
Page 213: Audio And Metadata Formats
Appendix B. Audio and metadata formats B. Audio and metadata formats B.1. Supported audio formats B.1.1. Lossy Codecs Format Extension Notes ATSC A/52 (AC3) Supports downmixing for play- .a52, .ac3, back of 5.1 streams in stereo .rm, .ra, .rmvb Encrypted ADX is not sup- .adx ported.
Page 214: Lossless Codecs
Appendix B. Audio and metadata formats mance requirements. B.1.2. Lossless Codecs Format Extension Notes Audio Interchange File Format Linear PCM 8/16/24/32 bit, IEEE .aif, .aiff ﬂoat 32/64 bit, ITU-T G.711 a- law/ -law, QuickTime IMA AD- Monkey’s Audio .ape, .mac Sun Audio Linear PCM 8/16/24/32 bit, IEEE .au, .snd...
Page 215: Other Codecs
Appendix B. Audio and metadata formats B.1.3. Other Codecs Format Extension Notes Atari Sound Format .cmc, .cm3, .cmr, .cms, .dmc, .dlt, .mpt, .mpd Synthetic music Mobile Application Format PCM/ADPCM only .mmf Game Boy Sound Format Progress .gbs seek use subtracks instead of seconds.
Page 216: Codec Featureset
Appendix B. Audio and metadata formats B.1.4. Codec featureset Format Seek Resume Gapless ATSC A/52 (AC3) Advanced Audio Coding MPEG audio Musepack OGG/Vorbis Sony Audio RealAudio Dialogic telephony type Windows Media Audio Standard Windows Media Audio Professional Audio Interchange File Format Monkey’s Audio Sun Audio Free Lossless Audio...
Page 217: Supported Metadata Tags
Appendix B. Audio and metadata formats B.2. Supported metadata tags Rockbox supports diﬀerent metadata formats. In general those tag formats are ID3 (v1.0, v1.1, v2.2, v2.3 and v2.4), APE (v1 and v2), Vorbis, MP4 and ASF. Few codecs use codec speciﬁc tags, several codecs do not use any tags yet. The following table gives an overview about what tag types rockbox supports for which audio ﬁle extension.
Page 218: Featureset For Codec Speciﬁc Metadata
Appendix B. Audio and metadata formats B.2.2. Featureset for codec speciﬁc metadata Feature Codec speciﬁc metadata (ﬁle extension) Embedded .bmp None Embedded .jpg None Embedded .png None Replaygain .mpc Title .tta, .spc, .mmf, .sid, .rm, .ra, .rmvb, .nsf, .nsfe, .mod, .sap, .gbs, .ay, .sgc, .vgm Artist .tta, .spc, .mmf, .sid, .rm, .ra, .rmvb, .nsf, .nsfe, .sap, .gbs,...
Page 219: Album Art
Appendix C. Album Art C. Album Art Rockbox allows you to put the album art, or another image related to the music on your player to display it in the PictureFlow plugin or in the theme. For this feature to work, there are a few requirements.
Page 220 Appendix C. Album Art The following characters will be replaced with an underscore (_) when looking for 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 AlbumArt in the wiki for programs that will help you automate the process of putting album art on your player.
Page 221: Theme Tags
Appendix D. Theme Tags D. Theme Tags Themeing is discussed in detail in section section 13.2 (page 200), what follows is a list of the available tags. Note: The “bar-type tags” (such as %pb, %pv, %bl etc.) can be further themed – see section D.28 (page 235).
Page 222: Information From The Track Tags
Appendix D. Theme Tags D.3. Information from the track tags Description Artist Composer Album Artist Album Name Grouping Genre Name Track Number Track Title Comment ID3 version (1.0, 1.1, 2.2, 2.3, 2.4, or empty if not an ID3 tag) Year Disc Number Remember that this information is not always available, so use the conditionals to show alternate information in preference to assuming.
Page 223: Additional Fonts
Appendix D. Theme Tags D.5. Additional Fonts Description %Fl(’id’,filename) See section 13.2.4. D.6. Misc Coloring Tags Description Color a rectangle. %dr(x,y,width,height,[color1,color2]) width and height can be - to ﬁll the viewport. If no color is speciﬁed the viewports foreground color will be used. If two colors are speciﬁed it will do a gradient ﬁll. D.7.
Page 224: Information About The File
Appendix D. Theme Tags D.8. Information about the ﬁle Description File Bitrate (in kbps) File Codec (e.g. “MP3” or “FLAC”). This tag can also be used in a conditional tag: %?fc<mp1|mp2|mp3|aiff|wav|ogg| flac|mpcsv7|a52|wavpack|alac|aac|shn|sid|adx|nsf| speex|spc|ape|wma|wmpapro|mod|sap|realaudiocook| realaudioaac|realaudioac3|realaudioatrac3|cmc| cm3|cmr|cms|dmc|dlt|mpt|mpd|rmt|tmc|tm8|tm2| omaatrac3|smaf|au|vox|wave64|tta|wmavoice|mpcsv8| aache|ay|gbs|hes|sgc|vgm|kss|unknown>. The codec or- der is as shown above.
Page 225: Playlist/Song Info
Appendix D. Theme Tags D.9. Playlist/Song Info Description Progress Bar. This will replace the entire line with a progress bar. You can set the position, width and height of the progressbar (in pixels) and load a custom image for it: %pb(x,y,[width],[height],image.bmp) Percentage played in song Current time in song...
Page 226: D.11.Runtime Database
Appendix D. Theme Tags ‘start’ is the oﬀset relative to the currently playing track for the playlist to display from (0 the current track, 1 is the next track, etc.). ‘code to render’ is a line of skin code which will be displayed for each line in the viewer.
Page 227: D.14.Virtual Led
Appendix D. Theme Tags D.14. Virtual LED Description “h” if the ﬂash storage is accessed D.15. Repeat Mode Description Repeat mode, 0-4, in the order: Oﬀ, All, One, Shuﬄe, A-B Example: %?mm<Off|All|One|Shuffle|A-B> D.16. Playback Mode Description Play status, 0-4, in the order: Stop, Play, Pause, Fast For- ward, Rewind, Recording, Recording paused, FM Radio play- ing, FM Radio muted Example: %?mp<Stop|Play|Pause|Ffwd|Rew|Rec|Rec pause|FM|FM pause>...
Page 228: D.18.List Title (.Sbs Only)
Appendix D. Theme Tags Number Screen Menus Recording screen FM Radio screen Current Playlist screen Settings menus File browser Database browser Plugin browser Quickscreen Pitchscreen Setting chooser Playlist Catalogue Viewer Plugin Context menu System Info screen Time and Date Screen Bookmark browser Shortcuts menu Track Info screen...
Page 229: D.19.Changing Volume
Appendix D. Theme Tags D.19. Changing Volume Description “v” if the volume is being changed %mv(t) 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 speciﬁes that amount of time, in seconds.
Page 230: D.21.Images
Appendix D. Theme Tags D.21. Images Description Load and set a backdrop image for the WPS. This image must %X(filename.bmp) be exactly the same size as your LCD. %x(n,filename[,x,y])Load and display an image n: image ID for later referencing in %xd filename: ﬁle name relative to /.rockbox/ and including “.bmp”...
Page 231: How To Display The Album Art
Appendix D. Theme Tags 1. Load and display the image /.rockbox/bg.bmp with ID “a” at 37, 109: %x(a,bg.bmp,37,109) 2. Load a bitmap strip containing 5 volume icon images (all the same size) with image ID “M”, and then reference the individual sub-images in a conditional: %xl(M,volume.bmp,134,153,5) %?pv<%xd(Ma)|%xd(Mb)|%xd(Mc)|%xd(Md)|%xd(Me)>...
Page 232: D.22.Fm Radio
Appendix D. Theme Tags 2. Load albumart at position 0,20 and resize it to be at most 100 100 pixels. If the image isn’t square, align it to the bottom-right corner: %Cl(0,20,100,100,r,b) For general information where to put album art see section (page 219).
Page 233: D.23.Alignment And Language Direction
Appendix D. Theme Tags D.23. Alignment and language direction Description Align the text left Align the text left, or to the right if RTL language is in use Centre the text Align the text right Align the text right, or to the left if RTL language is in use The next tag should follow the set language direction.
Page 234: D.25.Subline Tags
Appendix D. Theme Tags %?if(%pv, >=, 0)<Clipping possible|Volume OK> will display “Clipping possible” if the volume is higher than or equal to 0 dB, “Volume OK” if it is lower. %?if(%ia, =, %Ia)<same artist> – this artist and the next artist are the same. Note: When performing a comparison against a string tag such as %ia, only = and != work, and the comparison is not case sensitive.
Page 235: D.27.Text Translation
Appendix D. Theme Tags D.27. Text Translation Description Display the translation of “English” in the current language %Sx(English) “English” must be a phrase used in the language ﬁle. It should match the Source: line in the language ﬁle. Note: checkwps cannot verify that the string is correct, so please check on either the simulator or on target.
Page 236: D.29.Other Tags
Appendix D. Theme Tags noﬁll – don’t draw the bar, only its frame (for use with the “slider” option). noborder – don’t draw the border for image-less bars, instead maximise the ﬁlling over the speciﬁed area. This doesn’t work for bars which specify an image. nobar –...
Page 237 Appendix D. Theme Tags Description The character ‘(’ The character ‘)’ The character ‘,’ The character ‘%’ The character ‘<’ %< The character ‘|’ The character ‘>’ %> The character ‘;’ The character ‘#’ Indicate that the line should scroll. Can occur anywhere in a line (given that the text is displayed;...
Page 238: Conﬁg File Options
Appendix E. Config file options E. Conﬁg ﬁle options Setting Allowed Values Unit volume -99 to +6 bass -24 to +24 treble -24 to +24 balance -100 to +100 channels stereo, mono, custom, mono left, mono right, karaoke stereo_width 0 to 250 shuﬄe on, oﬀ...
Page 239 Appendix E. Config file options Setting Allowed Values Unit bidir limit 0 to 200 % screen scroll paginated on, oﬀ hold_lr_for_scroll_in_list on, oﬀ show path in browser oﬀ, current directory, full path contrast 0 to 63 backlight timeout oﬀ, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45, 60, 90, 120 backlight timeout plugged oﬀ, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10,...
Page 240 Appendix E. Config file options Setting Allowed Values Unit oﬀ, on most-recent-bookmarks pause on headphone oﬀ, pause, pause and resume unplug rewind duration on pause 0 to 15 disable autoresume if oﬀ, on phones not present Last.fm Logging oﬀ, on talk dir oﬀ, number, spell talk dir clip...
Page 241 Appendix E. Config file options Setting Allowed Values Unit crossfade oﬀ, auto track change, man track skip, shuﬄe, shuﬄe or man track skip, always crossfade fade in delay 0 to 7 crossfade fade out delay 0 to 7 crossfade fade in duration 0 to 15 crossfade fade out 0 to 15...
Page 242 Appendix E. Config file options Setting Allowed Values Unit dircache on, oﬀ tagcache_ram on, oﬀ touchpad sensitivity -25 to 25 touchpad deadzone 0 to 100 peak meter release 1 to 126 peak meter hold oﬀ, 200ms, 300ms, 500ms, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 1min peak meter clip hold on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15,...
Page 243 Appendix E. Config file options Setting Allowed Values Unit rec source mic, line, spdif rec channels mono, stereo rec mic gain 0 to 15 rec left gain 0 to 15 rec right gain 0 to 15 editable recordings oﬀ,on rec timesplit oﬀ, 0:05, 0:10, 0:15, 0:30, 1:00, h:mm 2:00, 4:00, 6:00, 8:00, 16:00, 24:00...
Page 244: Menu Overview
Appendix F. Menu Overview F. Menu Overview include an overview of the menu structure here The Rockbox manual Sansa Fuze+ (version 3.14)
Page 245: User Feedback
Appendix G. User feedback G. User feedback G.1. Bug reports If you experience inappropriate performance from any supported feature, please ﬁle a bug report on our web page. Do not report missing features as bugs, instead ﬁle them as feature ideas (see below). For open bug reports refer to http://www.rockbox.org/tracker/index.php?type=2 G.1.1.
Page 246: Features We Will Not Implement
Appendix G. User feedback G.2.2. Features we will not implement This is a list of Feature Requests we get repeatedly that we simply cannot do. View it as the opposite of a TODO! Interfacing with other USB devices (like cameras) or 2 player games over USB. The USB system demands that there is a master that talks to a slave.
Page 247: Credits
Appendix H. Credits H. Credits People that have contributed to the project, one way or another. Friends! Björn Stenberg Linus Nielsen Feltz- Francois Boucher Matthias Wien- Andy Choi Andrew Jamieson tapper Brent Coutts Jens Arnold Paul Suade Joachim Schiffer Gerald Vanbaren Christi Scarbor- Daniel Stenberg Alan Korr...
Page 248 Appendix H. Credits Hand Nick Lanham Sebastian Hen- Austin Appel Andre Smith Travis riksen Martin Scarratt Karl Hyyppa Ian Webber Pavel Gnelitsa Kurbjun Tomasz Malesinski Lutz Böhne Will Robertson drew Pilley Matt v.d. Westhuizen Robert Carboneau Ye Wei Bryan Tim Crist Jvo Studer Dan Ever- Childs...
Page 249 Appendix H. Credits Stepan Moskovchenko John S. Marcin Łukasik Le Jin Alex Ben- Gwynne Brian J. Morey Stijn Hisken Stéphane Quertinmont Bartosz Bertrik Sikken Karim Boucher Fabianowski Adam Hogan Andrew James Espinoza Franz Rühmland Mahone Anton Veretenenko Jordan Anderson Maurus Cuele- cente Ibarra Rui Araújo Brian...
Page 250 Appendix H. Credits Delyan Kratunov Purling Nayuki Wieland Hoffmann Nathan Ko- Marek Salaba Altay Oz Mark Igor Petelin Cástor Muñoz Borgerding Tobias Diedrich Andrew Albert Barca Fukuda Takafumi Engelbrecht Kevin Schoedel Jens Dimitar Dimitrov Osborne Jacobs Theeß Alexey Nemtsev Pascal Be- Marty Miller Eduardo Gonzalez Danny Attar...
Page 251: Licenses
Appendix I. Licenses I. Licenses I.1. GNU Free Documentation License Version 1.2, November 2002 Copyright c 2000,2001,2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
Page 252 Appendix I. Licenses A “Modiﬁed Version” of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modiﬁcations and/or translated into another language. A “Secondary Section” is a named appendix or a front-matter section of the Doc- ument that deals exclusively with the relationship of the publishers or authors of the Document to the Document’s overall subject (or to related matters) and contains nothing that could fall directly within that overall subject.
Page 253 Appendix I. Licenses ther is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a speciﬁc section name mentioned below, such as “Acknowledgements”, “Dedications”, “Endorsements”, or “History”.) To “Preserve the Title” of such a section when you modify the Document means that it remains a section “Entitled XYZ”...
Page 254 Appendix I. Licenses distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
Page 255 Appendix I. Licenses on its Title Page, then add an item describing the Modiﬁed Version as stated in the previous sentence. J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on.
Page 256 Appendix I. Licenses 5. COMBINING DOCUMENTS You may combine the Document with other documents released under this License, under the terms deﬁned in section 4 above for modiﬁed versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodiﬁed, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.
Page 257 Appendix I. Licenses 8. TRANSLATION Translation is considered a kind of modiﬁcation, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections.
Page 258 Appendix I. Licenses Copyright c YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documenta- tion License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back- Cover Texts.
Page 259: The Gnu General Public License
Appendix I. Licenses I.2. The GNU General Public License Version 2, June 1991 Copyright c 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
Page 260 Appendix I. Licenses Terms and Conditions For Copying, Distribution and Modification 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License.
Page 261 Appendix I. Licenses such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modiﬁed work as a whole. If identiﬁable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works.
Page 262 Appendix I. Licenses If distribution of executable or object code is made by oﬀering access to copy from a designated place, then oﬀering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code.
Page 263 Appendix I. Licenses reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a conse- quence of the rest of this License.
Page 264 Appendix I. Licenses and/or redistribute the program as permitted above, be liable to you for damages, including any general, special, incidental or con- sequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs), even if such holder or other party has been advised of the possibility of...
Page 265 Appendix I. Licenses ‘show w’. This is free software, and you are welcome to redistribute it under certain conditions; type ‘show c’ for details. The hypothetical commands show w and show c should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than show w and show c;...

SanDisk Sansa Fuze+ Manual

1 Introduction

2 Installation

3 Quick Start

4 Browsing and Playing

5 The Main Menu

6 Sound Settings

7 Playback Settings

8 General Settings

9 Theme Settings

10 Recording Settings

11 Time and Date

12 Plugins

13 Advanced Topics

A. File Formats

Audio and Metadata Formats

Album Art

Theme Tags

Quick Links

Need help?

Questions and answers

Related Manuals for SanDisk Sansa Fuze+

Summary of Contents for SanDisk Sansa Fuze+