Rockbox and this manual is the collaborative effort of the Rockbox team and
its contributors. See the appendix for a complete list of contributors.
c
2003-2008 The Rockbox Team and its contributors,c 2004 Christi Alice
Scarborough,c 2003 Jos´e Maria Garcia-Valdecasas Bernal & Peter Schlenker.
Version r19569-081223. Built using pdfLATEX.
Permission is granted to copy, distribute and/or modify this document under
the terms of the GNU Free Documentation License, Version 1.2 or any later
version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
is included in the section entitled “GNU Free Documentation License”.
G.2 The GNU General Public License . . . . . . . . . . . . . . . . . . . . . . . 171
The Rockbox manualToshiba Gigabeat F Series
Chapter 1.Introduction9
1Introduction
1.1 Welcome
This is the manual for Rockbox. Rockbox is an open source firmware replacement
for a growing number of digital audio players. Rockbox aims to be considerably more
functional and efficient than your device’s stock firmware while remaining easy to use
and customisable. 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.
Rockbox has been in development since 2001, and receives new features, tweaks and
fixes each day to provide you with the best possible experience on your digital audio
player. A major goal of Rockbox is to be simple and easy to use, yet remain very
customisable and configurable. We believe that you should never need to go through a
series of menus for an action you perform frequently. We also believe that you should
be able to configure almost anything about Rockbox you could want, pertaining to
functionality. Another top priority of Rockbox is audio playback quality – Rockbox,
for most models, includes a wider range of sound settings than the device’s original
firmware. A lot of work has been put into making Rockbox sound the best it can, and
improvements are constantly being made. All models have access to a large number
of plugins, including many games, applications, and graphical “demos”. You can load
different configurations quickly for different purposes (e.g. a large font for in your car,
different sound settings for at home). Rockbox features a very wide range of languages,
and all supported models also have the ability to talk to you – menus can be voiced and
filenames spelled out or spoken.
1.2 Getting more help
This manual is intended to be a comprehensive introduction to the Rockbox firmware.
There is, however, more help available. The Rockbox website at http://www.rockbox.org/
contains very extensive documentation and guides written by members of the Rockbox
community and this should be your first port of call when looking for further help.
If you cannot find the information you are searching for on the Rockbox website there
are a number of support channels you should have a look at. You can try the Rockbox
forums located at http://forums.rockbox.org/. Another option are the mailing lists which
can be found at http://www.rockbox.org/mail/. From that page you can subscribe to the
lists and browse the archives. For searching the list archives simply use the search field
that is located on the left side of the website. Also you can ask on IRC. The main
The Rockbox manualToshiba Gigabeat F Series
Chapter 1.Introduction10
channel for Rockbox is #rockbox on irc://irc.freenode.net. A bunch of helpful developers
and users are usually around. Just join and 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/. We also have a web client for joining the rockbox IRC
channel so there is no need for you to install additional software to your computer.
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. Refer to section D (page 154) for details on how to use the tracker.
1.3 Naming conventions and marks
We have some conventions especially on naming that are intended to be consistent
throughout this manual.
Manufacturer and product names are formatted in accordance with the standard rules
of English grammar, e.g. “Toshiba playback is currently unsupported”. Manufacturer
and model names are proper nouns, and thus are written beginning with a capital letter.
This manual has some parts that are marked with icons on the margin to help you
finding important parts or parts you could skip. The following icons are used:
Note: This indicates a note. A note starts always with the text “Note”. For easier
finding of notes we have put this an icon in the margin like here. Notes are used to
mark information that could help you or indicate a possible “weirdness” in rockbox that
would be explained.
Warning: This is a warning. In contrast to notes mentioned above, a warning should be
taken more seriously. While ignoring notes will not cause any serious damage ignoring
warnings could cause serious damage. If you are new to rockbox you should really read
the warnings before doing anything that is warned about.
This icon marks a section that is intended especially for the blind and visually impaired.
As they cannot read the manual in the same way sighted people do we have added some
additional descriptions. If you are not blind or visually impaired you most likely can
completely skip these blocks. To make this easier, there is an icon shown in the margin
on the right.
Links to the wiki are abbreviated by the name of the wiki page. Those names are still
linked so you can simply follow them like any other link in this manual. If you want to
access a wiki page manually go to Z http://www.rockbox.org/wiki/ and type the page
name in the “Go” box at the top of the page. Links to wiki pages are also indicated by
the symbol Z in front of the page name.
b
!
¸
The Rockbox manualToshiba Gigabeat F Series
Chapter 2.Installation11
2Installation
2.1 Overview
There are two ways of installing Rockbox: automated and manual. While the manual
way is older, more tested and proven to work correctly, the automated installation is
based on a nice graphical application that does almost everything for you. It is still
important that you have an overview of the installation process to be able to select the
correct installation options.
There are three separate components, two of which need to be installed in order to
run Rockbox:
The Toshiba bootloader. The Toshiba bootloader is the program that tells your player
how to load and start the original firmware. It is also responsible for any emergency,
recovery, or disk modes on your player. This bootloader is stored in special flash
memory in your Toshiba and comes factory-installed. It is not necessary to modify
this in order to install Rockbox.
The Rockbox bootloader. The Rockbox bootloader is loaded from disk by the Toshiba
bootloader. It is responsible for loading the Rockbox firmware and for providing
the dual boot function. It directly replaces the Toshiba firmware in the player’s
boot sequence.
Note: Dual boot does not currently work on the Gigabeat.
The Rockbox firmware. Similar to the Toshiba firmware, most of the Rockbox code is
contained in a “build” that resides on your player’s drive. This makes it easy to
update 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.
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.
Themes. The view of Rockbox can be customized by themes. Depending on your taste
you might want to install additional themes to change the look of Rockbox.
b
The Rockbox manualToshiba Gigabeat F Series
Chapter 2.Installation12
2.2 Prerequisites
Before installing Rockbox you should make sure you meet the prerequisites. You may
need some additional tools for installation. In most cases these will already be available
on your computer, but if not, installing some additional software might be necessary.
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 figure out the drive letter associated with the
player. On Linux you need to know the mount point of your player.
Warning: During installation, do not connect your player using the cradle but
plug the USB cable directly to the player.
For manual installation and customization additional software is required.
ZIP utility. Rockbox is distributed as a compressed archive using the .zip format. Your
computer will normally already have a means of handling such archive files. Windows XP has built-in support for .zip files and presents them to you as directories
unless you have installed a third party program that handles compressed files. For
other operating systems this may vary. If the .zip file format is not recognised on
your computer you can find a program to handle them at http://www.info-zip.org/
or http://sevenzip.sf.net/, both of which can be downloaded and used free of charge.
Text editor. As you will see in the following chapters, Rockbox is highly configurable.
In addition to saving configurations, Rockbox also allows you to create customised
configuration files. If you would like to edit custom configuration files on your
computer, you will need a text editor like Windows’ “Wordpad”.
2.3 Installing Rockbox
2.3.1 Automated Installation
To automatically install Rockbox, download the official installer and housekeeping tool
Rockbox Utility. It allows you to:
!
• Automatically install all needed components for using Rockbox (“Small Installation”)
• Automatically install all suggested components (“Full Installation”)
• Selectively install optional components
• Install additional themes
• Install voice files and generate talk clips
The Rockbox manualToshiba Gigabeat F Series
Chapter 2.Installation13
• Uninstall all components you installed using Rockbox Utility
Prebuilt binaries for Windows, Linux and MacOS X are available at the ZRockboxUtility
wiki page.
Warning: When first starting Rockbox Utility run “Autodetect”, found in the con-
figuration dialog (File → Configure). Autodetection can detect most player types. If
autodetection fails or is unable to detect the mountpoint, make sure to enter the correct
values. The mountpoint indicates the location of the player in your filesystem. On Windows, this is the drive letter the player gets assigned, on other systems this is a path in
the filesystem.
Note: Rockbox Utility currently lacks some guiding messages. Please have a look at the
manual installation instructions if you are stuck during installation.
2.3.2 Manual Installation
Choosing a Rockbox version
There are three different types of firmware binaries available from the Rockbox website:
Release version, current build and daily build. You need to decide which one you want
to install and get the appropriate version for your player.
Release. The release version is the latest stable release, free of known critical bugs. The
current stable release of Rockbox, version 3.1, is available at http://www.rockbox.
org/download/.
Current Build. The current build is built at each source code change to the Rockbox
SVN repository and represents the current state of Rockbox development. This
means that the build could contain bugs but most of the time is safe to use. You
can download the current build from http://build.rockbox.org/.
!
b
Archived Build. In addition to the release version and the current build, there is also
an archive of daily builds available for download. These are built once a day from
the latest source code in the SVN repository. You can download archived builds
from http://www.rockbox.org/daily.shtml.
Warning: Because current builds and daily builds are development versions which
change frequently, they may behave differently than described in this manual, or they
may introduce new (and maybe annoying) bugs. If you do not want to get undefined
behaviour from your player, you should stick to the current stable release if there is one
for your player. If you want to help with project development, you can try development
builds and help by reporting bugs. Just be aware that these are development builds that
are highly functional but not perfect!
The Rockbox manualToshiba Gigabeat F Series
!
Chapter 2.Installation14
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 as described in the manual that
came with your player.
3. Take the .zip file that you downloaded and use the “Extract all” command of
your unzip program to extract the files onto your player.
Note: The entire contents of the .zip file should be extracted directly to the root
of your player’s drive. Do not try to create a separate directory on your player
for the Rockbox files! The .zip file already contains the internal structure that
Rockbox needs.
Note: If the contents of the .zip file are extracted correctly, you will have a directory
called .rockbox, which contains all the files needed by Rockbox, in the main directory
of your player’s drive. If you receive a “-1” error when you start Rockbox, you have not
extracted the contents of the .zip file to the proper location.
Installing the fonts package
Rockbox has a fonts package that is available at http://www.rockbox.org/daily.shtml or
from the extras link in the menu on the Rockbox website. While the current builds
and daily builds change frequently, the fonts package rarely changes and is therefore not
included in these builds. When installing Rockbox for the first time, you should install
the fonts package. The release version, on the other hand, does not change, so fonts are
included with it.
1. Download the fonts package from the link above.
2. Take the file that you downloaded above, and use the “Extract all” command
of your unzip program to extract the files in the .zip file onto your player. As
with the firmware installation, the entire contents of the fonts .zip should be
extracted directly to the root of your player’s drive. Do not try to create a separate
directory on your player for the fonts! The .zip already contains the correct
internal structure.
b
b
Installing the bootloader
Installing the bootloader is only needed once. It simply requires you to replace a file
on your player with the Rockbox bootloader. To be able booting the original firmware
please make sure to rename the original file properly. If you ever wish to uninstall
Rockbox you should keep a backup copy of the original file.
• Download the Rockbox bootloader from http://download.rockbox.org/bootloader/
gigabeat/
The Rockbox manualToshiba Gigabeat F Series
Chapter 2.Installation15
• Starting at the root directory of your player browse into the directory GBSYSTEM
and from that into the subdirectory FWIMG. These directories are hidden. Make
sure that you have configured your browser to show hidden files or you may be
unable to see FWIMG.
• In that directory you’ll find a file called FWIMG01.DAT. This too may be hidden.
Rename the file to FWIMG01.DAT.ORIG. Make sure you spelled that name correctly
as it is needed for booting the Toshiba firmware.
• Now copy the file FWIMG01.DAT you downloaded to that directory. Make sure the
spelling is correct.
Warning: After installing the bootloader you need to power-cycle the player by doing
the following steps. Failure to do so may result in problems.
• Eject / unmount USB drive and unplug the USB cable.
• Unplug any power adapter.
• Hold the Power button to turn off the player.
• Slide the battery switch located on the bottom of the player from ‘on’ to ‘off’
• Slide the battery switch back from ‘off’ to ‘on’
2.3.3 Enabling Speech Support (optional)
If you wish to use speech support you will also need a voice file, English ones are available
from http://www.rockbox.org/daily.shtml. Download the “voice” package for your player
and unzip it directly to the root of your player. You should now find an english.voice
in the /.rockbox/langs directory on your player. Voice menus are enabled by default
and will come into effect after a reboot. See section 8.8 (page 62) for details on voice
settings.
2.4 Running Rockbox
!
Remove your player from the computer’s USB port. Unplug any connected power supply
and turn the unit off. When you next turn the unit on, Rockbox should load.When
you see the Rockbox splash screen, Rockbox is loaded and ready for use.
2.5 Updating Rockbox
Updating Rockbox is easy even if you do not use the Rockbox Utility. Download a
Rockbox build. (The latest release of the Rockbox software will always be available
from http://www.rockbox.org/download/). Unzip the build to the root directory of your
player like you did in the installation stage. If your unzip program asks you whether to
The Rockbox manualToshiba Gigabeat F Series
Chapter 2.Installation16
overwrite files, choose the “Yes to all” option. The new build will be installed over your
current build.
Note: If you use Rockbox Utility be aware that it cannot detect manually installed
components.
2.6 Uninstalling Rockbox
2.6.1 Automatic Uninstallation
You can uninstall Rockbox automatically by using Rockbox Utility. If you installed
Rockbox manually you can still use Rockbox Utility for uninstallation but will not be
able to do this selectively.
2.6.2 Manual Uninstallation
If you wish to clean up your disk, you may also wish to delete the .rockbox directory
and its contents. Turn the Toshiba off. Turn the player back on and the original Toshiba
software will load.
b
The Rockbox manualToshiba Gigabeat F Series
Chapter 3.Quick Start17
3Quick Start
3.1 Basic Overview
3.1.1 The player’s controls
Throughout this manual, the buttons on the player are labelled according to the
picture above. Whenever a button name is prefixed by “Long”, a long press of approximately one second should be performed on that button. The buttons are described in
detail in the following paragraph.
Additional information for blind users is available on the Rockbox website at ZBlindFAQ.
Hold the player with the screen on top and the controls on the right hand side. Below
the screen is a cross-shaped touch sensitive pad which contains the Up, Down, Left
and Right controls. On the top of the unit from left to right are the power socket, the
Hold switch, and the headphone socket. The Hold switch puts the player into hold
mode when it is switched to the right of the unit. The buttons will have no effect when
this is the case.
Starting from the left hand side on the bottom of the unit, nearer to the front than
the back, is a recessed switch which controls whether the battery is on or off. When this
switch is to the left, the battery is disconnected. This can be used for a hard reset of
the unit, or if the player is being placed in storage. Next to that is a connector for the
The Rockbox manualToshiba Gigabeat F Series
¸
Chapter 3.Quick Start18
docking station and finally on the right hand side of the bottom of the unit is a mini
USB socket for connecting directly to USB.
Finally on the right hand side of the unit are some control buttons. Going from the
bottom of the unit to the top there is a small round A buttton then a rocker volume
switch with of the Volume down button below the Volume up button. Above that is
are two more small round buttons, the Menu button and nearest to the top of the unit
the Power button, which is held down to turn the player on or off.
3.1.2 Turning the player on and off
To turn on and off your Rockbox enabled player use the following keys:
KeyAction
PowerStart Rockbox
Long PowerShutdown Rockbox
On shutdown, Rockbox automatically saves its settings.
If you have problems with your settings, such as accidentally having set the colours to
black on black, they can be reset at boot time. See the Reset Settings in section 11.3.3
(page 139) for details.
In the unlikely event of a software failure, hardware poweroff or reset can be performed
by holding down the battery switch until the player shuts off or reboots.
3.1.3 Putting music on your player
With the player connected to the computer as an MSC/UMS device (like a USB Drive),
music files can be put on the player via any standard file transfer method that you would
use to copy files between drives (e.g. Drag ’n’ Drop). The default directory structure
that is assumed by some parts of Rockbox (album art searching, and missing-tag fallback
in some WPSes) uses the parent directory of a song as the Album name, and the parent
directory of that folder as the Artist name. While files may be organized however you
like, the ZAlbumArt wiki page explains the requirement for Album Art to work properly,
and WPSes may display information incorrectly if your files are not properly tagged, and
you have your music organized in a way different than they assume when attempting to
guess the Artist and Album names from your filetree.See section A.2 (page 141) for
a list of supported audio formats.
3.1.4 The first contact
After you have first started the player you’ll be presented by the Main Menu. From
this menu you can reach every function of Rockbox, for more information (see section 5.1
(page 37)). To browse the files on you player select Files (see section 4.1 (page 21)), and
The Rockbox manualToshiba Gigabeat F Series
Chapter 3.Quick Start19
to browse in a view that is based on the meta-data1of your audio files, select Database
(see section 4.2 (page 25)).
3.1.5 Basic controls
When browsing files and moving through menus you usually get a list view presented.
The navigation in these lists are usually the same and should be pretty intuitive. In the
tree view use Down and Up to move around the selection. Use Select or Right to
select an item. When browsing the file system selecting an audio file plays it. The view
switches to the “While playing screen”, usually abbreviated as “WPS” (see section 4.3
(page 28). The dynamic playlist gets replaced with the contents of the current directory.
This way you can easily treat directories as playlists. The created dynamic playlist can
be extended or modified while playing. This is also known as “on-the-fly playlist”. To
go back to the File Browser stop the playback with the Power button or return to
the file browser while keeping playback running using Select. In list views you can go
back one step with Left.
3.1.6 Basic concepts
Playlists
Rockbox is playlist oriented. This means that every time you play an audio file, a socalled “dynamic playlist” is generated, unless you play a saved playlist. You can modify
the dynamic playlist while playing and also save it to a file. If you do not want to use
playlists you can simply play your files directory based. Playlists are covered in detail
in section 4.4 (page 32).
Menu
From the menu you can customise Rockbox. Rockbox itself is very customisable. Also
there are some special menus for quick access to frequently used functions.
Context Menu
Some views, especially the file browser and the WPS have a context menu. From the file
browser this can be accessed with Long Select. The contents of the context menu vary,
depending on the situation it gets called. The context menu itself presents you with
some operations you can perform with the currently highlighted file. In the file browser
this is the file (or directory) that is highlighted by the cursor. From the WPS this is
the currently playing file. Also there are some actions that do not apply to the current
file but refer to the screen from which the context menu gets called. One example is the
playback menu, which can be called using the context menu from within the WPS.
1
ID3 Tags, Vorbis comments, etc.
The Rockbox manualToshiba Gigabeat F Series
Chapter 3.Quick Start20
3.2 Customising Rockbox
Rockbox’ User Interface can be customised using “Themes”. Themes usually only affect
the visual appearance, but an advanced user can create a theme that also changes various
other settings like file view, LCD settings and all other settings that can be modified
using .cfg files. This topic is discussed in more detail in section 11.3 (page 137). The
Rockbox distribution comes with some themes that should look nice on your player.
Note: Some of the themes shipped with Rockbox need additional fonts from the fonts
package, so make sure you installed them. Also, if you downloaded additional themes
from the Internet make sure you have the needed fonts installed as otherwise the theme
may get displayed garbled.
3.3 Charging
The player can be powered over USB without connecting to your computer by holding
Menu while plugging in. This allows you to continue using the player normally.
b
The Rockbox manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing21
4Browsing and playing
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.
The Database Browser, on the other hand, allows you to navigate through the
music on your player using categories like album, artist, genre, etc.
You can select whether to browse using the File Browser or the Database Browser
by selecting either Files or Database in the Main Menu. If you choose the FileBrowser, the Show Files setting lets you select what types of files you wish to view.
See section 8.2 (page 55) for more information on the Show Files setting.
Note: The File Browser allows you to manipulate your files in ways that are not
available within the Database Browser. Read more about Database in section 4.2
(page 25). The remainder of this section deals with the File Browser.
The Rockbox manualToshiba Gigabeat F Series
b
Chapter 4.Browsing and playing22
4.1.1 File Browser Controls
KeyAction
Up/DownGo to previous/next item in list. If you
are on the first/last entry, the cursor will
wrap to the last/first entry.
LeftGo to the parent directory.
Select or RightExecutes the default action on the se-
lected file or enters a directory.
AIf there is an audio file playing, returns
to the While Playing Screen (WPS)
without stopping playback.
PowerStops audio playback.
Long SelectEnter the Context MenuMenuEnter the Main Menu
Long MenuSwitches to the Quick Screen (see sec-
tion 5.11 (page 41))
4.1.2 Context Menu
Figure 4.2: The Context Menu
The Rockbox manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing23
The Context Menu allows you to perform certain operations on files or directories.
To access the Context Menu, position the selector over a file or directory and access
the context menu with Long Select.
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 Context Menu contains the following options (unless otherwise noted, each
option pertains both to files and directories):
Playlist. Enters the Playlist Submenu (see section 4.4.3 (page 34)).
Playlist Catalog. Enters the Playlist Catalog Submenu (see section 4.4.2 (page 33)).
Rename. This function lets the user modify the name of a file or directory.
Cut. Copies the name of the currently selected file or directory to the clipboard and
marks it to be ‘cut’.
Copy. Copies the name of the currently selected file or directory to the clipboard and
marks it to be ‘copied’.
b
Paste. Only visible if a file 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 file. This option applies only to files, and not to
directories. Rockbox will ask for confirmation before deleting a file. Press Select
to confirm deletion or any other key to cancel.
Delete Directory. Deletes the currently selected directory and all of the files and subdi-
rectories it may contain. Deleted directories cannot be recovered. Use this feature
with caution!
Set As Backdrop. Set the selected bmp file as background image. The bitmaps need to
meet the conditions explained in section 11.1.6 (page 134).
Open with. Runs a viewer plugin on the file. Normally, when a file is selected in Rock-
box, Rockbox automatically detects the file type and runs the appropriate plugin.
The Open With function can be used to override the default action and select a
viewer by hand. For example, this function can be used to view a text file even if
the file has a non-standard extension (i.e., the file has an extension of something
other than .txt). See section 10.3 (page 109) for more details on viewers.
Create Directory. Create a new directory in the current directory on the disk.
Properties. Shows properties such as size and the time and date of the last modification
for the selected file. If used on a directory, the number of files and subdirectories
will be shown, as well as the total size.
The Rockbox manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing24
Add to Shortcuts. Adds a link to the selected item in the shortcuts.link file. If the
file does not already exist it will be created in the root directory. Note that if you
create a shortcut to a file, Rockbox will not open it upon selecting, but simply
bring you to it’s location in the File Browser.
4.1.3 Virtual Keyboard
Figure 4.3: The virtual keyboard
This is the virtual keyboard that is used when entering text in Rockbox, for example
when renaming a file or creating a new directory. The virtual keyboard can be easily
changed by making a text file with the required layout. More information on how to
achieve this can be found on the Rockbox website at ZLoadableKeyboardLayouts.
The Rockbox manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing25
KeyAction
Left / Right /
Up / Down
A + Left or A +
Right
SelectInserts the selected keyboard letter at the
PowerExits the virtual keyboard without saving
AExits the virtual keyboard and saves any
MenuDeletes the character before the line cur-
A + PowerEnters Morse input mode
SelectTap to select a character in Morse input
Move about the virtual keyboard (moves
the solid cursor)
Move the line cursor within the text line
current cursor position
any changes
changes
sor
mode
4.2 Database
4.2.1 Introduction
This chapter describes the Rockbox music database system.Using the information
contained in the tags (ID3v1, ID3v2, Vorbis Comments, Apev2, etc.) in your audio
files, Rockbox builds and maintains a database of the music files on your player and
allows you to browse them by Artist, Album, Genre, Song Name, etc. The criteria the
database uses to sort the songs can be completely customised. More information on how
to achieve this can be found on the Rockbox website at ZDataBase.
4.2.2 Initializing the Database
The first time you use the database, Rockbox will scan your disk for audio files. This can
take quite a while depending on the number of files on your player. This scan happens
in the background, so you can choose to return to the Main Menu and continue to listen
to music. If you shut down your player, the scan will continue next time you turn it on.
After the scan is finished you may be prompted to restart your player before you can
use the database.
Ignoring Directories During Database Initialization
You may have directories on your player whose contents should not be added to the
database. Placing a file named database.ignore in a directory will exclude the files in
that directory and all its subdirectories from scanning their tags and adding them to the
database. This will speed up the database initialization.
The Rockbox manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing26
If a subdirectory of an ’ignored’ directory should still be scanned, place a file named
database.unignore in it. The files in that directory and its subdirectories will be
scanned and added to the database.
4.2.3 The Database Menu
Load To RAM The database can either be kept on disk (to save memory), or loaded into
RAM (for fast browsing). Setting this to Yes loads the database to RAM, allowing
faster browsing and searching. Setting this option to No keeps the database on
the disk, meaning slower browsing but it does not use extra RAM and saves some
battery on boot up.
Note: If you browse your music frequently using the database, you should load
to RAM, as this will reduce the overall battery consumption because the disk will
not need to spin on each search.
Auto Update If Auto update is set to on, each time the player boots, the database
will automatically be updated.
Note: The Auto Update will only check for deleted files if the Directory
Cache (Settings → General Settings → System → Disk → Directory
Cache) is enabled. Update now includes that check whether dircache has been
enabled or not.
Initialize Now You can force Rockbox to rescan your disk for tagged files by using the
Initialize Now function in the Database Menu.
Warning: Initialize Now removes all database files (removing runtimedb data
also) and rebuilds the database from scratch.
Update Now Update now causes the database to detect new and deleted files
Note: Unlike the Auto Update function, Update Now will update the database
regardless of whether the Directory Cache is enabled. Thus, an update using
Update now may take a long time.
Unlike Initialize Now, the Update Now function does not remove runtime
database information.
b
b
!
b
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.
Export Modifications This allows for the runtime data to be exported to the file
/.rockbox/database changelog.txt, which backs up the runtime data in ASCII
format. This is needed when database structures change, because new code cannot
read old database code. But, all modifications exported to ASCII format should
be readable by all database versions.
The Rockbox manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing27
Import Modifications. 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, Album, Genre, Song Name, etc. To use the database, go to the Main Menu and select
Database.
Note: You may need to increase the value of the Max files in dir browser setting
(Settings → General Settings → System → Limits) in order to view long lists
of tracks in the ID3 database browser.
There is no option to turn off database completely. If you do not want to use it just
do not do the initial build of the database and do not load it to RAM.
b
The Rockbox manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing28
TagTypeOrigin
filenamestringsystem
albumstringid tag
albumartiststringid tag
artiststringid tag
commentstringid tag
composerstringid tag
genrestringid tag
groupingstringid tag
titlestringid tag
bitratenumericid tag
discnumnumericid tag
yearnumericid tag
tracknumnumericid tag/filename
autoscorenumericruntime db
lastplayednumericruntime db
playcountnumericruntime db
Pm (play time min)
Ps (play time - sec)numericruntime db
ratingnumericruntime db
commitidnumericsystem
entryagenumericsystem
lengthnumericsystem
Lm (tracklen min)
Ls (track len - sec)numericsystem
numericruntime db
numericsystem
4.3 While Playing Screen
The While Playing Screen (WPS) displays various pieces of information about the currently playing audio file. The appearance of the WPS can be configured using WPS
configuration files. The items shown depend on your configuration – all item can be
turned on or off independently. Refer to section B (page 142) for details on how to
change the display of the WPS.
• Status bar: The Status bar shows Battery level, charger status, volume, play mode,
repeat mode, shuffle mode and clock. 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 manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing29
• The ID3 album name.
• The ID3 artist name.
• Bit rate. VBR files display average bitrate and “(avg)”
• Elapsed and total time.
• A slidebar progress meter representing where in the song you are.
• Peak meter.
See section 11.2 (page 134) for details of customising your WPS (While Playing
Screen).
4.3.1 WPS Key Controls
KeyAction
Up / DownVolume up/down.
LeftGo to beginning of track, or if pressed
while in the first seconds of a track, go
to previous track.
Long LeftRewind in track.
RightGo to next track.
Long RightFast forward in track.
AToggle play/pause.
PowerStop playback.
SelectReturn to the File Browser.Long SelectEnter WPS Context Menu.
MenuEnter Main Menu.
Long MenuSwitches to the Quick Screen. (see sec-
tion 5.11 (page 41))
A + Up/DownShow Pitch Screen (see section 4.3.3
(page 32)).
A + MenuEnter ID3 Viewer.
A + Right or
Short Right +
Long Right
A + Left or Short
Left + Long Left
Skip to the next directory.
Skip to the previous directory.
4.3.2 Peak Meter
The peak meter can be displayed on the While Playing Screen and consists of several
indicators.
The Rockbox manualToshiba Gigabeat F Series
Chapter 4.Browsing and playing30
The bar: This is the wide horizontal bar. It represents the current volume value.
The peak indicator: This is a little vertical line at the right end of the bar. It indicates
the peak volume value that occurred recently.
The clip indicator: This is a little black block that is displayed at the very right of the
scale when an overflow occurs. It usually does not show up during normal playback
unless you play an audio file that is distorted heavily.
Note: Note that the clip detection is not very precise. Clipping might occur
without being indicated.
The scale: Between the indicators of the right and left channel there are little dots.
These dots represent important volume values. In linear mode each dot is a 10%
mark. In dbfs mode the dots represent the following values (from right to left):
0db, -3db, -6db, -9db, -12db, -18db, -24db, -30db, -40db, -50db, -60db.
4.3.3 The WPS Context Menu
Like the context menu for the File Browser, the WPS Context Menu allows you
quick access to some often used functions:
Playlist
The Playlist submenu allows you to view, save, search and reshuffle the current playlist.
To change settings for the Playlist Viewer press Menu while viewing the playlist to
bring up the Playlist Viewer Menu.
Playlist Viewer Menu
Show Icons. This toggles display of the icon for the currently selected playlist entry and
the icon for moving a playlist entry
b
Show Indicies. This toggles display of the line numbering for the playlist
Track Display. This toggles between filename only and full path for playlist entries
Save Current Playlist. Allows the current playlist to be saved as a .m3u playlist file
Playlist catalog
View catalog. This lists all playlists that are part of the Playlist catalog. You can load
a new playlist directly from this list.
Add to playlist. Adds the currently playing file to a playlist. Select the playlist you
want the file to be added to and it will get appended to that playlist.
Add to new playlist. Similar to the previous entry this will add the currently playing
track to a playlist. You need to enter a name for the new playlist first.
The Rockbox manualToshiba Gigabeat F Series
Loading...
+ 147 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.