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 File Browser, the Show Files setting lets you select what types of files you wish to view. See section 8.2 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. The remainder of this section deals with the File Browser.
Key | Action |
Up/Down | Go to previous/next item in list. If you are on the first/last entry, the cursor will wrap to the last/first entry. |
On+Up/ Down | Move one page up/down in the list. |
Left | Go to the parent directory. |
Right | Execute the default action on the selected file or enter a directory. |
On | If there is an audio file playing, return to the While Playing Screen (WPS) without stopping playback. |
Off | Stop audio playback. |
Long Play | Enter the Context Menu. |
F1 | Enter the Main Menu. |
F2 | Switch to the Quick Screen (see section 5.13). |
F3 | Switch to the Quick Screen. |
F2 | Activate the Hotkey function (see section 4.6). |
|
The functions of the F keys are also summarised on the button bar at the bottom of the screen.
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 Play.
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):
Note: If you have Auto-Change Directory and Constrain Auto-Change enabled, the directories returned will be constrained to the directory you have chosen here and those below it. See section 7.9
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.
Also you can switch to Morse code input mode by changing the Use Morse Code Input setting.
Note: When the cursor is on the input line, Play deletes the preceding character
Key | Action |
On + Left / On + Right | Move the line cursor within the text line. |
F3 | Delete the character before the line cursor. |
Left / Right | Move the cursor on the virtual keyboard. If you move out of the picker area, you get the previous/next page of characters (if there is more than one). |
Up / Down | Move the cursor on the virtual keyboard. If you move out of the picker area you get to the line edit mode. |
F1 | Flip to the next page of characters (if there is more than one). |
Play | Insert the selected keyboard letter at the current line cursor position. |
F2 | Exit the virtual keyboard and save any changes. |
Off | Exit the virtual keyboard without saving any changes. |
Play | Tap to select a character in Morse code input mode. |
|
This chapter describes the Rockbox music database system. Using the information contained in the tags (ID3v1, ID3v2) 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 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.
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.
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.
Warning: Initialize Now removes all database files (removing runtimedb data also) and rebuilds the database from scratch.
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 Entries in File 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.
Tag | Type | Origin |
filename | string | system |
album | string | id tag |
albumartist | string | id tag |
artist | string | id tag |
comment | string | id tag |
composer | string | id tag |
genre | string | id tag |
grouping | string | id tag |
title | string | id tag |
bitrate | numeric | id tag |
discnum | numeric | id tag |
year | numeric | id tag |
tracknum | numeric | id tag/filename |
autoscore | numeric | runtime db |
lastplayed | numeric | runtime db |
playcount | numeric | runtime db |
Pm (play time - min) | numeric | runtime db |
Ps (play time - sec) | numeric | runtime db |
rating | numeric | runtime db |
commitid | numeric | system |
entryage | numeric | system |
length | numeric | system |
Lm (track len - min) | numeric | system |
Ls (track len - sec) | numeric | system |
|
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 items can be turned on or off independently. Refer to section C for details on how to change the display of the WPS.
Note:
See section 13.2 for details of customising your WPS (While Playing Screen).
Key | Action |
Up / Down | Volume up/down. |
Left | Go to beginning of track, or if pressed while in the first seconds of a track, go to the previous track. |
Long Left | Rewind in track. |
Right | Go to the next track. |
Long Right | Fast forward in track. |
Play | Toggle play/pause. |
Off | Stop playback. |
On | Return to the File Browser / Database. |
Long Play | Enter WPS Context Menu. |
F1 | Enter Main Menu. |
Long F2 | Switch to the Quick Screen (see section 5.13). |
F1+Down | Key lock (software hold switch) on/off. |
F3 | Toggles Display quick screen. |
F1+Play | Mute on/off. |
On + Up/Down | Show Pitch Screen (see section 4.3.3). |
F1 + On | Enter ID3 Viewer. |
F2 | Activate the Hotkey function (see section 4.6). |
On + Left or Short Right + Long Right | Skip to the next directory. |
On + Right or Short Left + Long Left | Skip to the previous directory. |
|
The peak meter can be displayed on the While Playing Screen and consists of several indicators. For a picture of the peak meter, please see the While Recording Screen in section 5.8.1.
Note: Note that the clip detection is not very precise. Clipping might occur without being indicated.
Like the context menu for the File Browser, the WPS Context Menu allows you quick access to some often used functions.
The Playlist submenu allows you to view, save, search and reshuffle the current playlist. These and other operations are detailed in section 4.5. To change settings for the Playlist Viewer press Long Play while viewing the current playlist to bring up the Playlist Viewer Menu. In this menu, you can find the Playlist Viewer Settings.
This is a shortcut to the Sound Settings Menu, where you can configure volume, bass, treble, and other settings affecting the sound of your music. See section 6 for more information.
This is a shortcut to the Playback Settings Menu, where you can configure shuffle, repeat, party mode, skip length and other settings affecting the playback of your music.
The menu entry is only shown if Gather Runtime Information is enabled. It allows the assignment of a personal rating value (0 – 10) to a track which can be displayed in the WPS and used in the Database browser. The value wraps at 10.
This allows you to create a bookmark in the currently-playing track.
This screen is accessible from the WPS screen, and provides a detailed view of all the identity information about the current track. This info is known as meta data and is stored in audio file formats to keep information on artist, album etc. To access this screen, press F1 + On. Use Left and Right to move through the information.
This Open With function is the same as the Open With function in the file browser’s Context Menu.
Delete the currently playing file. The file will be deleted but the playback of the file will not stop immediately. Instead, the part of the file that has already been buffered (i.e. read into the player’s memory) will be played. This may even be the whole track.
The Pitch Screen allows you to change the rate of playback (i.e. the playback speed and at the same time the pitch) of your player. The rate value can be adjusted between 50% and 200%. 50% means half the normal playback speed and a pitch that is an octave lower than the normal pitch. 200% means double playback speed and a pitch that is an octave higher than the normal pitch.
The rate can be changed in two modes: procentual and semitone. Initially, procentual mode is active.
The value of the rate is not persistent, i.e. after the player is turned on it will always be set to 100%.
Key | Action |
F1 | Toggle pitch changing mode. |
Up / Down | Increase / Decrease pitch by 0.1% (in procentual mode) or by 0.1 semitone (in semitone mode). |
Long Up / Long Down | Increase / Decrease pitch by 1% (in procentual mode) or a semitone (in semitone mode). |
Left / Right | Temporarily change pitch by 2% (beatmatch). |
On | Reset rate to 100%. |
Off | Leave the Pitch Screen. |
|
Warning: Changing the pitch can cause audible ‘Artifacts’ or ‘Dropouts’.
Rockbox handles function buttons in a different way to the Archos software. F1 is always bound to the menu function, while F2 and F3 enable two quick screens.
F2 displays some browse and play settings which are likely to be changed frequently. This settings are Shuffle mode, Repeat mode and the Show files options
Shuffle mode plays each track in the currently playing list in a random order rather than in the order shown in the browser.
Repeat mode repeats either a single track (One) or the entire playlist (All).
Show files determines what type files can be seen in the browser. This can be just MP3 files and directories (Music), Playlists, MP3 files and directories (Playlists), any files that Rockbox supports (Supported) or all files on the disk (All).
See section ?? for more information about these settings.
Key | Action |
Left | Control Shuffle mode setting. |
Right | Control Repeat mode setting. |
Down | Control Show file setting. |
|
F3 controls frequently used display options.
Scroll bar turns the display of the Scroll bar on the left of the screen on or off.
Status bar turns the status display at the top of the screen on or off. Upside down inverts the screen so that the top of the display appears nearest to the buttons. This is sometimes useful when storing the player in a pocket. Key assignments swap over with the display orientation where it is logical for them to do so.
See section 8.4 for more information about these settings.
Key | Action |
Left | Control scroll bar display. |
Right | Control status bar display. |
Down | Control upside down screen setting. |
|
Some common terms that are used in Rockbox when referring to playlists:
Rockbox can create playlists in four different ways.
Whenever a song is selected from the File Browser with Right, Rockbox will automatically create a playlist containing all of the songs in that directory and start playback with the selected song.
Note: If you already have created a dynamic playlist, playing a new song will erase the current dynamic playlist and create a new one. If you want to add a song to the current playlist rather than erasing the current playlist, see the section below on how to add music to a playlist.
If playback is stopped, the Insert and Queue functions can be used as described in 4.5.3 to create a new playlist instead of adding to an existing one. This will erase any dynamic playlist.
The Playlist catalogue makes it possible to modify and create playlists that are not currently playing. To do this select Playlist catalogue in the Context Menu. There you will have two choices, Add to playlist adds the selected track or directory to an existing playlist and Add to a new playlist creates a new playlist containing the selected track or directory.
Note: All playlists in the Playlist catalogue are stored by default in the /Playlists directory in the root of your player’s disk and playlists stored in other locations are not included in the catalogue. It is however possible to move existing playlists there (see section 4.1.2).
To create a playlist containing all music on your player, you can use the Create Playlist command in the Playlists menu found in the Main Menu. The created playlist will be named root.m3u8 and saved in the root of your player’s disk.
The Playlist Submenu is a submenu in the Context Menu (see section 4.1.2), it allows you to put tracks into a “dynamic playlist”. If there is no music currently playing, Rockbox will create a new dynamic playlist and put the selected track(s) into it. If there is music currently playing, Rockbox will put the selected track(s) into the current playlist. The place in which the newly selected tracks are added to the playlist is determined by the following options:
The Playlist Submenu can be used to add either single tracks or entire directories to a playlist. If the Playlist Submenu is invoked on a single track, it will put only that track into the playlist. On the other hand, if the Playlist Submenu is invoked on a directory, Rockbox adds all of the tracks in that directory to the playlist.
Note: You can control whether or not Rockbox includes the contents of subdirectories when adding an entire directory to a playlist. Set the Settings → General Settings → Playlist → Recursively Insert Directories setting to Yes if you would like Rockbox to include tracks in subdirectories as well as tracks in the currently-selected directory.
Dynamic playlists are saved so resume will restore them exactly as they were before shutdown.
Note: To view, save or reshuffle the current dynamic playlist use the Playlist sub menu in the WPS context menu or in the Main Menu.
Reshuffling the current playlist is easily done from the Playlist sub menu in the WPS, just select Reshuffle.
To move or remove a track from the current playlist enter the Playlist Viewer by selecting View Current Playlist in the Playlist submenu in the WPS context menu or the Main Menu. Once in the Playlist Viewer open the context menu on the track you want to move or remove. If you want to move the track, select Move in the context menu and then move the blinking cursor to the place where you want the track to be moved and confirm with Right or On. To remove a track, simply select Remove in the context menu.
To save the current playlist either enter the Playlist submenu in the WPS Context Menu (see section 4.3.3) and select Save Current Playlist or enter the Playlist Options menu in the Main Menu and select Save Current Playlist. Either method will bring you to the Virtual Keyboard (see section 4.1.3), enter a filename for your playlist and accept it and you are done.
Playlist files, like regular music tracks, can be selected through the File Browser. When loading a playlist from disk it will replace the current dynamic playlist.
The Playlist catalogue offers a shortcut to all playlists in your player’s specified playlist directory. It can be used like the File Browser.
Hotkeys are shortcut keys for use in the File Browser and WPS screen. To use one, press F2 within the File Browser or F2 within the WPS screen. The assigned function will launch with reference to the current file or directory, if applicable. Each screen has its own assignment. If there is no assignment for a given screen, the hotkey is ignored.
The default assignment for the File Browser hotkey is Off, while the default for the WPS hotkey is View Playlist.
The hotkey assignments are changed in the Hotkey menu (see section 8.10) under General Settings.