Rockbox is written by users, for users. Not only is it free to use, it is also released under the GNU General Public License (GPL), which means that it will always remain free both to use and to change.
If you think you have found a bug please make sure it actually is a bug and is still present in the most recent version of Rockbox. You should try to confirm that by using the above mentioned support channels first. After that you can submit that issue to our tracker.
2.1. Before Starting USB connection. To transfer Rockbox to your player you need to connect it to your computer. For manual installation/uninstallation, or should autodetection fail during automatic installation, you need to know where to access the player. On Windows this means you need to know the drive letter associated with the player.
Rockbox. The build consists of a directory called .rockbox which contains all of the Rockbox files, and is located in the root of your player’s drive. Apart from the required parts there are some addons you might be interested in installing.
(page 17) Installing the firmware 1. Download your chosen version of Rockbox from the links in the previous section. 2. Connect your player to the computer via USB in MSC mode as described in the manual that came with your player.
Safely eject / unmount the USB drive, unplug the cable and restart. 2.2.4. Enabling Speech Support (optional) If you wish to use speech support you will also need a voice file. Voice files allow Rockbox to speak the user interface to you. Rockbox Utility can install an English voice file, or you can download it from https://www.rockbox.org/daily.shtml...
UMS mode. If you wish to clean up your disk, you may also wish to delete the .rockbox directory and its contents. Turn the Packard Bell off. Turn the player back on and the original Packard Bell software will load.
Page 19
Rockbox has been installed with Rockbox Utility. To fix this, either install Rockbox with the Rockbox Utility which will take care of this for you, or recheck the Manual Install section to see where the files need to be located.
The Hold switch is located on the left hand side of the player. Note that when the Hold switch is moved towards the top of the player, hold is turned on and all the other The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Reset hole. 3.1.3. Starting the original firmware Rockbox has a dual-boot feature where it is possible to load the original firmware from the file /System/OF.mi4. To boot into the original firmware press and release Power and then immediately after the backlight turns on, press the OK button and keep it pressed until the original firmware starts.
3.1.7. Basic concepts Playlists Rockbox is playlist oriented. This means that every time you play an audio file, a so- called “dynamic playlist” is generated, unless you play a saved playlist. You can modify the dynamic playlist while playing and also save it to a file. If you do not want to use playlists you can simply play your files directory based.
Rockbox distribution comes with some themes that should look nice on your player. Note: Some of the themes shipped with Rockbox need additional fonts from the fonts 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.
4.1. File Browser Figure 4.1.: The file browser Rockbox lets you browse your music in either of two ways. The File Browser lets you navigate through the files and directories on your player, entering directories and executing the default action on each file. To help differentiate files, each file format is displayed with an icon.
Note: The Context Menu is a context sensitive menu. If the Context Menu is invoked on a file, it will display options available for files. If the Context Menu is invoked on a directory, it will display options for directories. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 26
(page 47)). If the file does not already exist it will be created in your Rockbox directory. Note that if you create a shortcut to a file, Rockbox will not open it upon selecting, but simply bring you to its location in the File Browser.
4.1.3. Virtual Keyboard Figure 4.3.: The virtual keyboard This is the virtual keyboard that is used when entering text in Rockbox, for example when renaming a file or creating a new directory. The virtual keyboard can be easily changed by making a text file with the required layout. More information on how to achieve this can be found on the Rockbox website at LoadableKeyboardLayouts.
DataBase. 4.2.2. Initializing the Database The first time you use the database, Rockbox will scan your disk for audio files. This can take quite a while depending on the number of files on your player. This scan happens in the background, so you can choose to return to the Main Menu and continue to listen to music.
Auto Update If Auto update is set to on, each time the player boots, the database will automatically be updated. Initialize Now You can force Rockbox to rescan your disk for tagged files by using the Initialize Now function in the Database Menu.
Unlike Initialize Now, the Update Now function does not remove runtime database information. Gather Runtime Data When enabled, rockbox will record how often and how long a track is being played, when it was last played and its rating. This information can be displayed in the WPS and is used in the database browser to, for example, show the most played, unplayed and most recently played tracks.
In contrast to all other items, the status bar is always at the top of the screen. • (Scrolling) path and filename of the current song. • The ID3 track name. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Show current Playlist. Activate the Hotkey function (see sec- tion (page 40)). Short Next + Skip to the next directory. Long Next Short Prev + Skip to the previous directory. Long Prev The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Show Indices. This toggles display of the line numbering for the playlist Track Display. This toggles between filename only and full path for playlist entries The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 34
Note: If you’ve enabled options for queuing tracks (see section 4.4.3 (page 38)), keep in mind that those are not saved to a playlist file. When saving, Rockbox will offer to remove queued tracks, so that bookmarking the current playlist becomes possible. Refer to section (page 77) for more information on bookmarks.
Page 35
In timestretch mode there are separate displays for pitch and speed, and each can be altered independently. Due to the limitations of the algorithm, speed is limited to be The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
4.4. Working with Playlists 4.4.1. Playlist terminology Directory. Rockbox always considers the song that is playing to be part of a playlist, and will create a playlist automatically when you are playing the contents of a directory. Meaning, just about anything that is described in this chapter with respect to playlists also applies to directories.
File Browser, Database, or even PictureFlow: Play Next. Track(s) will play immediately after the currently playing track. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 38
Show Shuffled Adding Options or Show Queue Options to customize the displayed set of options. If Playing Next... is invoked on a directory, Rockbox adds all of the tracks in that directory to the playlist. Note: You can control whether or not Rockbox includes the contents of subdirectories when adding an entire directory to a playlist.
The Playlist catalogue offers a shortcut to all playlists in your player’s specified playlist directory. It can be used like the File Browser but will display the content of a playlist when one is selected. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
The hotkey assignments are changed for the What’s Playing Screen (see section (page 65)) and browsers (see section (page 66)) separately. The default assignment for the File Browser hotkey is Off, while the default for the WPS hotkey is View Playlist. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
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 first screen you will see when starting Rockbox. To return to the Main Menu, press the Menu button.
Delete will remove the currently selected bookmark entry from the list. This entry is not shown in the Main Menu when the option is off (the default setting). See section (page 77) for more details on configuring bookmarking in Rockbox. 5.4. Files Browse the files on your player (see section (page 24)).
The details of this menu are covered in section (page 58). 5.7.3. General Settings The General Settings menu allows you to customise the way Rockbox looks and the way it plays music. The details of this menu are covered in section (page 65).
This is expected behaviour, and nothing to worry about. The recording continues during the spin up. The frequency and channels settings are shown in the status bar. The controls for this screen are: The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Both automatically and manually created playlists can be edited using this menu. 5.9.1. The Playlist Catalogue Context Menu Create Playlist: Rockbox will create a playlist with all tracks from the directory that is currently selected in the File Browser, including all of its sub-directories. If you have selected the root level or your Playlist Catalogue directory, Rockbox will instead create a playlist with all tracks from all directories.
Warning: It is not recommended that users access this menu unless instructed to do so in the course of fixing a problem with Rockbox. If you think you have messed up your settings by use of this menu please try to reset all settings before asking for help.
<number of the theme icon to use (see CustomIcons)> talkclip: <full path to a talk clip to speak when voice menus are enabled> (example: /.rockbox/filename.ta Only “type” and “data” are required (except if type is “separator” in which case “data”...
Page 48
“Add to shortcuts”. A reboot is needed for manual changes to shortcuts.txt to be applied. Shortcuts can be manually removed by selecting the one you wish to remove and pressing Long Menu. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
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).
(but not always) has the effect of removing the voice track from a song. This setting also very often has other undesirable effects on the sound. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
High-Frequency Attenuation. 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 setting. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
6.9. Equalizer Figure 6.2.: The graphical equalizer Rockbox features a parametric equalizer (EQ). In contrast to non-parametric equalizers, a parametric EQ enables adjusting the center frequency, gain, and width of EQ bands separately. The ability to 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 53
Bands 1-8: Peaking filters. Peaking EQ filters boost or lower a frequency range cen- tered at the centre frequency chosen. Graphic equalizers in home stereos are usually peaking filters. The peaking filters in Rockbox’s EQ lets you adjust three different parameters for EQ bands 1 through 8. The “centre” parameter controls the centre frequency of the frequency range that is affected as described above.
Page 54
Advanced EQ. This sub menu provides options for adjusting the same parameters as the Graphical EQ. The only difference is that the parameters are adjusted through textual menus rather than through a graphic interface. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
This setting controls the dithering and noise shaping functionality of Rockbox. Most of Rockbox’ audio file decoders work at a higher bit depth than the 16 bits used for output on the player’s audio connectors. The simplest way to convert from one bit depth to another is simply discarding all the surplus bits.
For example, the 2:1 setting means that for each two decibels of input signal above the threshold, the compressor will only allow the output to appear as one decibel. The higher the ratio, the harder the signal is compressed. The ratio setting of The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 57
“pumping.” Instead, the gain is allowed to return to normal at the chosen rate. Release Time is the time for the gain to recover by 10 dB. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
7.1. Shuffle Turning shuffle on will cause Rockbox to randomly re-order the playlist. Thus, to shuffle all of the audio files on the player, you first need to create a playlist containing all of them. For more information on creating playlists refer to section (page 36).
A longer Anti-Skip Buffer helps prevent skips in music playback if Rockbox has trouble reading from the disk. This can happen if the player is knocked, shaken or jogged heavily while Rockbox is trying to read the hard drive.
Out Duration is less then Fade In Delay (which would create a gap in the audio). In this case, the Fade In Delay is reduced to eliminate the gap. The graphic below illustrates how the different settings work in practice. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Off. Do not process replaygain information, i.e. turn off the replaygain function. Prevent Clipping. Avoid clipping of a song’s waveform. If a song would clip during playback, the volume is lowered for that song. Replaygain information is needed for this to work. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
The beep is disabled when set to Off. 7.12. Auto-Change Directory Control what Rockbox does when it reaches the end of a directory. If Auto-Change Di- rectory is set to Yes, Rockbox will continue to the next directory. If Auto-Change Directory is set to No, playback will stop at the end of the current playlist.
7.19. Rewind on Pause This option rewinds the current track by a small amount whenever it is paused (not stopped). The amount to rewind can be set between 0 and 15 seconds. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Album art will not be loaded or displayed when set to Off. To prefer loading album art that is stored in a separate image file, set to Prefer Image File. The default behavior is to Prefer Embedded album art. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
WPS Hotkey. Sets the hotkey function for the WPS (see section (page 40)). The default is View Playlist. Set WPS Context Plugin. This option will allow you to run a Rockbox plugin from the WPS context menu. 8.2. Playlists The Playlists submenu allows you to configure settings related to playlists.
If set to No, the current track will be interrupted and new tracks will start playing immediately. Show Shuffled Adding Options. If set to No, Rockbox will not offer to add shuf- fled tracks in the Playing Next Submenu.
Page 67
Show Path. If this setting is set to Full Path the full path to the current directory will be displayed on the first line in the File Browser. If set to Current Directory Only only the name of the current directory will be displayed. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Screen and FM screen to not turn on the backlight in order to save power. Enabled. Enables/disables the feature. Settings. Allows to select actions that will not activate backlight. Exempt Volume. Volume up/down. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 69
Rockbox chooses which method it should use depending of how much it has to scroll to the left. This setting lets you tell Rockbox where that limit is, expressed in percentage of the line length.
Page 70
If the Scale setting is set to Logarithmic (dB) scale, the volume values are scaled logarithmically. The volume meters of digital audio devices usually are scaled this way. On The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
8.6.2. Disk Options relating to the hard disk. Disk Spindown. Rockbox has a timer that makes it spin down the hard disk after it is idle for a certain amount of time. This setting controls the amount of time between the last user activity and the time that the disk spins down.
Chapter 8. General Settings Directory Cache. Rockbox has the ability to cache the contents of your drive in RAM. The Directory Cache takes a small amount of memory away from Rockbox that would otherwise be used to buffer music, but it speeds up navigation in the file browser by eliminating the slight pause between the time a navigation button is pressed and the time Rockbox responds.
This setting control the keypad mode when the player is attached to a computer through USB. Pressing a key on the player sends a keystroke the computer the player is attached The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 74
Browser. This mode lets you control a web browser (e.g. Firefox). It uses the player’s keys to navigate through the web page and different tabs, navigate through history, and to control zoom. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
The Startup/Shutdown sub menu allows you to configure items which are run at startup, or initiate a shutdown when conditions are met. Show Shutdown Message. If set, a message will be displayed and the display will light up before the device shuts down. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Chapter 8. General Settings 8.7.1. Start Screen Set the screen that Rockbox will start in. The default is the main menu but the following options are available: Previous Screen. Start Rockbox in the same screen as when it was shut off.
Note: If the current playlist has been modified or is unsaved, such as when playing tracks from the Database, Rockbox will automatically offer to save the playlist to a file when you attempt to create a bookmark. Queued tracks (see section 4.4.3...
Page 78
In this case you should set the setting 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.
Next to skip across tracks in a playlist without losing their resume position. Automatic resume. This option enables or disables automatic resume globally. When Rockbox detects that the database (which is needed for this feature) has not been initialized yet, it asks whether it should be initialized right away.
/.rockbox/langs/ directory on the player. Voice files 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.voice.
Page 81
Voice Volume Level. This allows you to specify the relative volume of the voice prompts as a percentage of the main audio volume. It defaults to 100%. VoiceHowto for more details on configuring speech support in Rockbox. The Rockbox manual Packard Bell Vibe 500...
For information about editing a .wps file see section 13.2 (page 187). Show Icons. Rockbox has the ability to display an icon to the left of the file in the File Browser. For details of these icons, see section (page 199). These icons can also be customised.
Page 83
Bar (Gradient Colour). A bar with a colour gradient, the colours are set in the Colours submenu. Colours. The options in this menu sets the colours for visual elements in Rockbox. Line Selector Colours. These options sets the colours for the line selector bars.
11.025 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. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
This setting buffers 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. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
In the peak meter at the bottom of the screen the start threshold is displayed graphically by a little triangle The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 87
By specifying a short presplit gap you still can split the recording into separate tracks whenever the trigger start condition is met. More information can be found at VolumeTriggeredRecording. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Alarm Wake Up Screen: This option controls what the player does when it is woken up by the alarm. Time Format: Choose 12 or 24 hour clock. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
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.
Although this may not seem difficult, blackjack is a game renowned for the strategy involved. This version includes the ability to split, buy insurance, and double down. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Sometimes a special item falls down when you destroy a brick. For a special item to take effect, you must catch it with the paddle. Look out for the bad ones. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
To make things more difficult, the entire board is shifted down every time a certain number of shots have been fired. Points are awarded depending on how quickly the level was completed. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
When you quit the game the current state will be saved and restored when you resume the game. The menu also allows the user to reload the last game saved, save the current position and start a new game without having to quit the game. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Figure 12.7.: Chopper Navigate a cavernous maze without banging into walls, the ceiling, or the floor. How long can you fly your chopper? Action Play / Scroll Up Make chopper fly Enter menu The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
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 The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Figure 12.10.: Doom This is the famous Doom game. Getting started For the game to run you need .wad game files located in /.rockbox/doom/ on your player. Create the directory and save the following files there: The Rockbox manual Packard Bell Vibe 500...
Page 97
Main Menu. The Doom plugin has a main menu, which is brought up before a game is started. It has the following entries: Game. Select which (official) wad to launch Addon. Select which unofficial addon wad to launch (From /.rockbox/doom/addons directory) Demos. Select which demo file to play on game start Options.
12.1.13. Duke3D Figure 12.11.: “Hollywood Holocaust”, the first level of Duke Nukem 3D This is a port of Duke Nukem 3D, derived from Fabien Sanglard’s Chocolate Duke. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 99
Chapter 12. Plugins Installation The .GRP and .CON files from an original installation of the game must be placed in the /.rockbox/duke3d/ on your device. The shareware files work as well, and are available PluginDuke3D. Music In-game music will not work by default. For it to work, you must install a modified Timidity patchset in the /.rockbox/timidity/ directory on your device.
Action Scroll Up / Move the cursor Scroll Down / Prev / Next Flip Play Shuffle Menu Solve Cancel Solve step by step Quit the game 12.1.15. Goban Figure 12.13.: Goban The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 101
Context Menu or the Cancel button. There is a comment at the current node. It can be viewed/edited using the Add/Edit Comment menu option of the Context Menu. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 102
Basic Info. Shows a quick view of the basic game metadata, if any has been set (otherwise does nothing). This option does not allow editing. Time Limit. The time limit of the current game. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 103
Disable Idle Poweroff? Enable this if you do not want the player to turn off after a certain period of inactivity (depends on your global Rockbox settings). Idle Autosave Time. Set the amount of idle time to wait before automatically saving any unsaved changes.
Page 104
To remove a label, click on it until it cycles through the allowed letters and disappears. Add/Edit Comment. Add or edit a comment at the current node. Done. Go back to the previous screen. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Quit 12.1.17. Jackpot Figure 12.15.: 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. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Prev/Next/ Move the cursor around the jewels Scroll Up/Scroll Down Select a jewel Menu 12.1.19. Maze This is a simple maze generator that creates perfect mazes that have only one solution. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
You can have another go by selecting “retry level” from the menu, but this will cost you a life. You start the game with three lives. Luckily, there are checkpoints at levels four and eight. Action Scroll Up, Scroll Move Character Down, Prev, Next Menu Menu The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Scroll Down / Prev / Next Play Toggle flag on / off Reveal the contents of the current square Menu Display the current game status Exit the game 12.1.22. Pacbox Figure 12.19.: Pacbox The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 109
33c0e197be4c787142af6c3be0d8f6b0 These need to be stored in the /.rockbox/pacman/ directory on your player. In the MAME ROMs collection the necessary files can be found in pacman.zip and puckman.zip. The MAME project itself can be found at http://www.mame.net. Keys...
12.1.24. Pixel Painter Figure 12.21.: Pixel Painter This game is written in LUA and based on the game of the same name by Pavel Bakhilau (http://js1k.com/2010-first/demo/453). The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
For a two player game, both players should just press the appropriate buttons for their side. Action Menu Left player up Prev Left player down Play Right player up Next Right player down Quit The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
This is id Software’s Quake, first released in 1996. The game features a Gothic atmo- sphere and full 3D graphics. Installation Copy the game data files into /.rockbox/quake on your device. There should be an id1/ directory with a .pak file. The shareware version is known to work. Configuration It is possible to customize the game controls through the Options >...
12.1.29. Rockblox Figure 12.24.: 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 different shapes form full rows. Whenever a row is completed, it will be cleared away, and you gain points. For every ten lines completed, the game level increases, making the blocks fall faster.
Puzzle Documentation For documentation on the games included, please see the “Extensive Help” menu option from inside the plugin to read puzzle-specific instructions or visit their official website The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 115
This font pack is available from https://download.rockbox.org/useful/sgt-fonts.zip. To install, simply extract the contents of this file to the /.rockbox/fonts/ directory on your device. Once this has been done, each game will dynamically load and use properly- sized fonts whenever needed.
Scroll Up and Scroll Down Cancel Shuffle Menu Switch between pictures (default puz- zle, album art, and your own image if launched via Open With), and numbered tiles Stop the game The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Another version of the Snake game. Move the 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. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Sokoban may be used as a viewer for viewing saved solutions and playing external level sets with the .sok extension. Level sets should be in the standard Sokoban text format or RLE (Run Length Encoded). For more information about the level format, http://sokobano.de/wiki/index.php?title=Level_format The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
12.1.36. Solitaire Figure 12.31.: 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...
Spacerocks is a clone of the old arcade game Asteroids. The goal of the game is to blow up the asteroids and avoid being hit by them. Once in a while, a UFO will appear – shoot this for extra points. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Prev Move Left Next Move Right Scroll Up Move Up Scroll Down Move Down Play Switch between circle and square Cancel Previous level Menu Reset level Next level Exit the game The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
12.1.39. Sudoku Figure 12.34.: Sudoku Sudoku in Rockbox can act as both a plugin and a viewer. When starting Sudoku from 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.
Each year you are allocated an amount of food based on the number of farms you control. Food is used to feed your men, but if you do not have enough food to feed your The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Also note that the colour of the adjacent tiles also count towards your strength. 12.1.41. Wolf3D This is a port of Wolfenstein 3-D, derived from Wolf4SDL. Installation Copy the original data files (e.g. *.WL6) into the /.rockbox/wolf3d/ directory. Sound should work by default. 12.1.42. Wormlet Figure 12.35.: Wormlet game...
Page 125
Chapter 12. Plugins Wormlet is a multi-worm game on a multi-threaded multi-functional Rockbox console. You navigate a hungry little worm. Help your worm to find food and to avoid poisoned argh-tiles. The goal is to turn your tiny worm into a big worm for as long as possible.
Page 126
1 pixel wide U-turn. You also could move from food to food and make sure you keep between your opponent and the food. So you can always reach it before your opponent. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Xrick is a clone of the platform game ’Rick Dangerous’ (http://en.wikipedia.org/wiki/ Rick_Dangerous), originally written by ’BigOrno’ (http://www.bigorno.net/xrick/), modi- fied and ported to Rockbox by Pierluigi Vicinanza (https://github.com/pierluigi-vicinanza/ xrick). Walk through the maps, avoid traps, kill the Bad Guys... and try to stay alive long...
After an experiment goes awry the hero must team up with an unlikely ally, when they both become fugitives on another world. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
12.2.1. Bounce Figure 12.38.: Bounce This demo is of the word “Rockbox” bouncing across the screen. There is also an analogue clock in the background. In Scroll mode the bouncing text is replaced by a different one scrolling from right to left.
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 contributors after displaying the Rockbox logo and version. This plugin is called when selecting Version from the System section of the Rockbox main menu. Exit at any time by pressing Prev or Cancel.
Increase / decrease speed Scroll Up / Add / remove polygon Scroll Down Menu Quit 12.2.5. FFT This plugin is a basic frequency analyzer with 3 different frequency-amplitude plots (lines, bars, and spectrogram). The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Increase / decrease number of flames Scroll Down Prev Toggle flame type Next Toggle moving flames Menu Quit 12.2.7. Fractals Figure 12.42.: Fractals: Mandelbrot set This demonstration draws fractal images from the Mandelbrot set. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Increase iteration depth (more detail) Long Cancel Reset and return to the default image Quit 12.2.8. Logo Demo showing the Rockbox logo bouncing around the screen. Action Next / Prev Increase / decrease speed on the x-axis Scroll Up /...
Toggle whether to scroll or not Toggle drawing orientation Play Pause the demo Scroll Up / Increase / decrease volume Scroll Down Next / Prev Increase / decrease speed Exit demo The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
(page 206)) and database (see section (page 28)) features of Rockbox. These need to be working correctly before PictureFlow can be used. PictureFlow does not support embedded album art. Note: It is strongly recommended you enable the database’s "Load to RAM" feature (and restart your player afterwards)! See section 4.2.3...
Page 136
Show year in album title. Set whether a year will be displayed next to each album title (determined by the release year of the latest track on an album). The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
WPS integration. Integrate PictureFlow with the While Playing Screen. Backlight. Force backlight on while running pictureflow. 12.2.13. Plasma Figure 12.46.: Plasma Plasma is a demo displaying a 80’s style retro plasma effect. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Rockbox can open files with a configuration description (.cells files). Just “play” such file and the game configuration stored in it will be loaded into this plugin. A .cells file is a text file. A capital ‘O’ marks a live cell, a dot marks a dead cell, all other characters are ignored.
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). From the The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
“playing” the associated file. Viewers are stored in the /.rockbox/rocks/viewers/ directory. Note: Some viewer plugins can only be used by selecting the Open With... option from the Context Menu (see section 4.1.2 (page 25)). The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Or you can use the context menu on either a file or a directory in the file browser tree, and use the “Add to shortcuts” menu option. This will append a The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Only relative links across the same volume are supported. Note: You may like to use native Rockbox shortcuts instead. These can be created from within Rockbox itself and have advanced capabilities. See section 12.3.1...
.c8k file contains 16 characters describing the mapping from the Chip8 keyboard to the default key mapping (that way, several Chip8 keys can be pressed using only one Rockbox key). For example, a file containing the single line: Code 0122458469ABCDEF...
Open Frotz menu (not available at MORE prompts) Long Rec Quit 12.3.5. Image Viewer This plugin opens image files from the File Browser to display them. Supported formats are as follows. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 145
Greyscale option or set the method of dithering used in the Dithering submenu. These settings only take effect for JPEG images. Quit. Quits the viewer and returns to the File Browser. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
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. There should now be a /.rockbox/patchset/ directory, with the patchset directory containing several .pat files and two .cfg files.
MPEG audio multiplexed into .mpg files. To play a video file, you just select it in the Rockbox File Browser. If your file does not have the .mpg extension but is encoded in the supported format, you will need to use the Open With...
Page 148
Resume Options (default: Start menu) Enable/disable the start menu. Play Mode (default: Single) Set to All to play multiple .mpg files in the directory continuously. Clear all resumes: x Discard all x resume points. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Equalizer (default: force off) Use the Equalizer setting or force the equalizer off. Dithering (default: force off) Use the Dithering setting or force audio dithering off. See this page in the Rockbox wiki for information on how to encode your videos to the supported format.
12.3.11. Rockboy Figure 12.50.: 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 file saved as .gb or .gbc in the file browser.
‘#’. To open a .shopper file just “play” it from the file browser. Example #groceries bananas cucumber 4 apples 6 apples #dairy milk cheese The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
This plugin takes a file and sorts it in ascending alphabetical order. Case is ignored. This is useful for ordering playlists generated by the Create Playlist menu option (see section (page 45)). 12.3.15. Speedread Figure 12.51.: speedread The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
(Wide mode) Scroll Up One line up Scroll Down One line down Play Toggle autoscroll Power Set/Reset bookmarks Menu Enter menu Exit text viewer Menu Return Return to the file being viewed. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 154
Show Statusbar Select whether to show the status bar. If you select a theme settings that the status bar does not display (see section (page 82)), the status bar is not displayed even if you select Yes. No Do not display the status bar. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 155
Reflow Lines. Available options are 0 to 5 spaces. If you select 0, a blank line is displayed as an indent. Show Playback Menu Display the playback menu to allow control of the currently play- ing music without leaving the plugin. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Figure 12.53.: 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.
Font. Specifies how the .fnt file belonging to a theme .cfg file 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.
12.3.19. ZXBox Figure 12.55.: 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 file or snapshot saved as .tap, .tzx, .z80 or .sna in the file browser.
Page 159
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).
The file is written to the root directory of your player and is called battery_bench.txt. The plugin will continue to log info until: • Another plugin is loaded. • The player is shut down. • The battery is empty. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 161
As Battery Benchmark needs to write the data held in memory to disk in order to save them, it is possible that should Rockbox shut down due to low battery then there will not be enough power remaining to write the data to disk. Therefore all measurements since the previous save will be lost.
Prev / Next / Move around the keypad Scroll Up / Scroll Down Select a button Cancel Delete last entered digit or clear after cal- culation Play Calculate Quit 12.4.4. Calendar Figure 12.57.: Calendar The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Setup Action Scroll Up / Increase / decrease displayed Value Scroll Down Move to next screen Cancel Move to previous screen • First enter the number of players (1–10) The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
“TIME UP!”is shown. The player will then be removed from the timer. 12.4.6. Clock Figure 12.59.: Clock This is a fully featured analogue and digital clock plugin. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 165
PM will be displayed at the upper right. The Date readout, if enabled, is displayed at the lower left. The Counter, if enabled, is displayed at the lower right. The second The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
This mode shows a “plain” clock in large text that takes up nearly the whole LCD. 12.4.7. Dart Scorer The dart scorer plugin allows scoring a game of darts (301/501) for two players. It supports modifiers for double/triple hits, bullseye, undo, and game saving and resuming. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Prerequisites for using the plugin To use the plugin, firstly you need to have the dictionary files which contain the words (in- dex) and their description – dict.index and dict.desc, respectively – on /.rockbox/rocks/apps/ folder. The dictionary files can be created by yourself, or you can get them crafted from the web.
Entries are automatically saved when the plugin is exited. 12.4.11. Lamp Lamp is a simple plugin to use your player as a lamp (flashlight, torch). You get an empty screen with maximum brightness. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
The time tag must be in the form [mm:ss], [mm:ss.xx], or [mm:ss.xxx] where mm is minutes, ss is seconds, xx is tenth of milliseconds, and xxx is milliseconds. Any other tags and lines without time tags are ignored. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 170
.ext is one of the supported extensions from the list above, and will be searched for in the same order as in that list. /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 The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 171
Encoding. Sets the codepage used in the plugin. Read ID3 tag. Read lyrics from id3 tags in mp3 files. Lrc Directory. Set the directory where lyrics files are stored, must be a maximum of 63 bytes. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
In addition, the display also indicates the beats while playing so that you can discreetly place the device in your sight for checking the tempo instead of wearing headphones at a concert. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 173
• custom beat patterns (tick/tock/silence on each beat), default being emphasis (tick) on first beat, normal sound (tock) on others. The button mapping is different to enable navigation in the programmed track. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 174
The syntax of programmed tracks in tempomap files follows the format defined by http://das.nasophon.de/klick/. Actually, the goal is to keep compatibility between klick and this Rockbox metronome. The parts of a track are specified one line each in this scheme (pieces in [] optional): [name:] bars [meter ]tempo[-tempo2[*accel|/accel] [pattern] [volume] The bar count and tempo always have to be specified, the rest is optional.
Page 175
It seems to work reasonably on some other models in the simulator. At last, a more complete tempomap file: # An example track exercising the programmable Rockbox metronome # or also http://das.nasophon.de/klick/. lead-in: 1 4/4 120 XXXX 0.5 # 4 emphasized but less loud ticks...
QR code. In these cases, you 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).
Open menu Long Rec Exit 12.4.20. Random Folder Advance Configuration This plugin is used to configure the folders which will be considered when the Auto- Change Directory feature is set to Random. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Generate Folder List Generates a list of all folders found on the player. You can filter the directories which are scanned by creating a file called /.rockbox/folder_advance_dir.txt. Only the directories in this file and any contained directories will be scanned. You can have up to 10 directories ignored by the scan by placing a minus sign before them in the list (i.e.
12.4.22. Rockpaint Figure 12.61.: Rockpaint Rockpaint is a bitmap (.bmp) editor for Rockbox. It can open any .bmp file 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.
Page 180
Text tool “Draws” text on the image. Filled rectangle Same as the Rectangle tool, but fills it with colour. Filled circle Same as the Circle tool, but fills it with colour. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 181
Quits Rockpaint immediately. Prev / Next / Moves the cursor around. Scroll Up / Scroll Down Menu Displays the Main Menu. Displays the toolbar. Play Toggles the brush and selects objects. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
A simple stopwatch program with support for saving times. Action Quit Plugin Play Start / stop Reset timer (only when timer is stopped) Menu Take lap time Scroll Up / Scroll through lap times Scroll Down The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Note: When you have not changed the file the Text Editor will quit immediately. Action Next or OK Edit Line / Select Character Prev or Cancel Exit / Abort Editing Menu Show Item Menu Long Menu Delete Line The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
13.1.2. Open Plugin Menu Items Rockbox allows you to choose a plugin to run for select menu options. Simply choose the option in the setting menu and choose the plugin you would like to run.
13.1.5. Loading Languages Rockbox can load language files at runtime. Simply copy the .lng file (do not use the .lang file) to the player and “play” it in the Rockbox directory browser or select Set- Language from the Main Menu.
Page 186
.colours file format, but an external text editor can also be used. To edit the .colours file using Rockbox, “play” it in the File Browser. The file will open in the Text Editor. Upon selecting a line, the following choices will appear:...
WPS and FMS. The SBS also allows you to control certain aspects of the appearance of the menus/browsers. There are a number of themes included in Rockbox, and you can load one of these at any time by selecting it in Settings Browse Theme Files.
.sbs. The main theme file has the extension .cfg. All files should have the same name. The theme .cfg file should be placed in the /.rockbox/themes directory, while the .wps, .fms and .sbs files should be placed in the /.rockbox/wps directory. Any images used by the theme should be placed in a subdirectory of /.rockbox/wps...
Page 189
Viewport Line Text Styles Description Set the viewport text style to ‘mode’ from this point forward %Vs(mode[,param]) Mode can be the following: The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 190
Otherwise a red flashing warning will be displayed in viewport ‘b’. Note: The tag to display conditional viewports must come before the tag to preload the viewport in the .wps file. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
• ‘id’ is the number you want to use in viewport declarations, 0 and 1 are reserved and so can’t be used. • ‘filename’ is the font filename to load. Fonts should be stored in /.rockbox/fonts/ • ‘glyphs’ is an optional specification of how many unique glyphs to store in memory.
Page 192
Example subline definition: Example %s%t(4)%ia;%s%it;%t(3)%pc %pr : Display id3 artist for 4 seconds, Display id3 title for 2 seconds, Display current and remaining track time for 3 seconds, repeat... The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 193
%xl(c,rep_all.bmp,16,64) %xl(d,rep_one.bmp,16,64) %xl(e,rep_shuffle.bmp,16,64) %?mm<%xd(b)|%xd(c)|%xd(d)|%xd(e)> Four images at the same x and y position are preloaded in the example. Which image to display is determined by the %mm tag (the repeat mode). The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
13.3.2. Specifications for .cfg Files The Rockbox configuration file is a plain text file, so once you use the Save .cfg file option to create the file, you can edit the file on your computer using any text editor program.
A special case configuration file can be used to force a particular setting or settings every time Rockbox starts up (e.g. to set the volume to a safe level). Format a new configuration file as above with the required setting(s) and save it into the /.rockbox directory with the filename fixed.cfg.
13.5. Optimising battery runtime Rockbox offers a lot of settings that have high impact on the battery runtime of your player. The largest power savings can be achieved through disabling unneeded hardware components – for some of those there are settings available.
In general all kinds of sound processing will need more CPU time and therefore consume more power. The less sound processing you use, the better it is for the battery runtime (for options see section (page 49)). The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 198
Appendix A. File formats The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Start the plugin .rock Text File Display the text file using the text .txt viewer plugin Voice file Allow Rockbox to speak menus .voice While Playing Screen Load the new WPS display config- .wps uration The Rockbox manual Packard Bell Vibe 500...
.oma, .aa3, .rm, .ra, .rmvb RealAudio Supports RealAudio .rm, .ra, (Cook) .rmvb Speex .spx Dialogic telephony type .vox Windows Media Audio Standard .wma, .wmv, .asf Windows Media Audio Professional .wma, .wmv, .asf The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
2/3/4/5 bit, Dialogic OKI AD- PCM, YAMAHA ADPCM, Adobe SWF ADPCM Wavpack Note: Free Lossless Audio multichannel tracks may not play in realtime on all devices due to CPU performance requirements. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Sound Interface Device Progress .sid seek use subtracks instead of seconds. SPC700 .spc Note: NSF, VGM, and SID might not play in realtime on all devices due to CPU performance requirements. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Boy Sound Format, AY Sound Chip Music, Hudson Entertainment System Sound, For- mat, MSX Konami Sound System and SMS/GG/CV Sound Format use subtracks instead of seconds, whereas each subtrack equals a second. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
The following table gives an overview about what tag types rockbox supports for which audio file extension. Note: There is always only one tag type supported for each file extension.
2. Only one tag type is supported for each audio format. 3. Overall there are 1800 bytes available to load metadata strings. 4. The maximum size of each metadata item (e.g. Artists) is limited to 500 bytes. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
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 207
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. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
When used conditionally, the “true” branch is completely ignored if it does not apply. Example: %?cc<%cH:%cM|No clock detected> The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
%V tag explained above. See section 13.2.2. Set the Info Viewport to use the viewport called label, as %VI(’label’) declared with the previous tag. Draw this viewport on the backdrop layer. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
“c” if the unit is currently charging the battery (only on tar- gets that have software charge control or monitoring) Remaining time of the sleep timer (if it is set) The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
%d(1) is “Isola”, %d(2) is “Kent” and %d(3) is “Rock”. These tags, when written with the first letter capitalized (e.g. %Fn or %D(2)), produce the information for the next file to be played. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
10 seconds if no number is specified. %?pE(7)<in the last 7 seconds of track|in the rest of the track> Current playback pitch D.10. Playlist Viewer Description Display the playlist viewer in the current viewport. %Vp(start,code to render) The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Crossfade setting, in the order: Off, Auto Skip, Man Skip, Shuffle, Shuffle and Man Skip, Always ReplayGain value (x.y dB). used conditional, Replaygain type use: %?rg<Off|Track|Album|TrackShuffle|AlbumShuffle|No tag> D.13. Hold Description “h” if the main unit keys are locked The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Play status, 0-4, in the order: Stop, Play, Pause, Fast For- ward, Rewind, Recording, Recording paused, FM Radio play- ing, FM Radio muted Example: %?mp<Stop|Play|Pause|Ffwd|Rew|Rec|Rec pause|FM|FM pause> D.17. Current Screen Description The current screen, 1-20, in the order shown below The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
%?Lt<%Lt> to display the title within the viewport. If %Lt is present anywhere in the .sbs, then the %Vi viewport will not show the title. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
2.5 seconds after the volume button has been released. After that, it will display the volume value. D.20. Settings Description The value of the Rockbox setting with the specified name. See %St(<setting section (page 224) for the list of the available settings.
LCD. %x(n,filename[,x,y])Load and display an image n: image ID for later referencing in %xd filename: file name relative to /.rockbox/ and including “.bmp” x: x coordinate (defaults to 0 if both x and y are not specified) y: y coordinate.
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)
All alignment tags may be present in one line, but they need to be in the order left – centre – right. If the aligned texts overlap, they are merged. Example: %ax%V(...) The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Split items on a line into separate sublines Allows grouping of several items (sublines) onto one line, with the display cycling round the defined sublines. See section 13.2.4 (page 192) for details. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Some tags can be used to display a bar which draws according to the value of the tag. To use these tags like a bar you need to use the following parameters (%XX should be replaced with the actual tag). The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Note: If the slider option is used, the bar will be shrunk so that the slider fits inside the specified width and height. Example: A 100px bar image with a 16px slider image The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
(given that the text is displayed; see conditionals above). You can specify up to ten scrolling lines. Scrolling lines can not contain dynamic content such as timers, peak meters or progress bars. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 226
The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 227
4 cutoff (in Hz), q (0 to 64), gain cutoff (in Hz), q ( 240 to 240) (0 to 64), gain eq peak filter 5 ( 240 to 240) The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 228
3 to LCD width / 10 (devise a pixels way to get ranges from config-*.h) volume display graphic, numeric battery display graphic, numeric font /path/filename.fnt /path/filename.kbd invert on, off The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 229
0:05, 0:10, 0:15, 0:30, 1:00, h:mm 2:00, 4:00, 6:00, 8:00, 16:00, 24:00 pre-recording time off, 1 to 30 rec path /path/to/dir clear settings on hold off, on The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Appendix F. Menu Overview F. Menu Overview include an overview of the menu structure here The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
To suggest an idea for a feature or to read those made by others, see https://forums. rockbox.org/index.php?board=49.0. Please keep in mind that this forum is for the dis- cussion of feature ideas – they are not requests and there is no guarantee they will be acted upon.
• Implementing the ability to playback DRM files. Firstly, this would be extremely difficult to implement legally – Rockbox is not legal entity as such, and therefore is unable to enter into license agreements with providers of DRM technology. Secondly, Rockbox is open source, which would mean that any DRM technology we incorporated into our codebase would sud- denly become visible to the whole world, completely defeating its purpose.
Tat Tang Toshi- lore Huw Smith Garrett Derner hiko Itoh David J. Song Jeong Taek Barry McIntosh Leslie Donald- Anders Kagerin Peter D’Hoye Lee Pilgrim Zakk Roberts Ben Basha Brandon Low Nathan The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 234
Thilo-Alexander ulea Peter Harley Max Kel- Ginkel Adam Gashlin Robert Kukla Alexander Eickhoff Ken Faz- David Quesada Jared Stafford zone David Bishop Hein-Pieter Martin Hensel Stéphane Doyon van Braam Przemysław Hołubowski The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 235
Denes Balatoni Hughes Laurent Gautier Simon Wallace Eric Lassauge François Zhukovsky Daniel Kluz Phinit- Dinel Francesco Rigoni Joël Puik nun Chanasabaeng Tse-Hsien Chiang Klaas Bosteels Teruaki Kawashima Szymon Dziok Domenico Di Misa The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 236
Andrew Ryabinin Adrián Tinoco Boris Kovačević Maksim Postolati Stanislav Chizhik Stéphane Moutard-Martin Rune Desu Rozen Olivier Kaloudoff Pade Michael Rey Yuxuan Shui Kessia Pinheiro Jean-Louis Biasini James Buren Issa Beganović Georg The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 237
The libtomcrypt team The microtar libmpeg2 team The Game_Music_Emu team (rxi and others) The UnifontEX team The OpenSPC DSP emulator and GNU Unifont teams The xrick team The ALAC decoder team team The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Any member of the public is a licensee, and is addressed as “you”. You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 239
A section “Entitled XYZ” means a named subunit of the Document whose title ei- The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 240
Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 241
Modified Version as given on the Title Page. If there is no section Entitled “History” in the Document, create one stating the title, year, authors, and publisher of the Document as given The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 242
The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 243
Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 244
To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 245
If your document contains nontrivial examples of program code, we recommend re- leasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
The precise terms and conditions for copying, distribution and modification follow. GNU General Public License The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 247
License. (Exception: if the Program itself is interactive but does not normally print The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 248
(in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 249
Many people have made generous contributions to the wide range of software distributed through that system in The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 250
12. In no event unless required by applicable law or agreed to in writ- ing will any copyright holder, or any other party who may modify The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 251
If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) <year> <name of author> Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Page 252
If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License. The Rockbox manual Packard Bell Vibe 500 (version 3891bcf3b9-240713)
Need help?
Do you have a question about the Packard Bell Vibe 500 and is the answer not in the manual?
Questions and answers