Page 2 - Rockbox
2 Rockbox http://www.rockbox.org/ Open Source Jukebox Firmware Rockbox and this manual is the collaborative effort of the Rockbox team andits 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 200...
Page 3 - Contents
Contents 3 Contents 1 Introduction 9 1.1 Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1.2 Getting more help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1.3 Naming conventions and marks . . . . . . . . . . . . . . . . . . . . . . . . 10 2 Ins...
Page 9 - Introduction; Getting more help
Chapter 1. Introduction 9 1 Introduction 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 morefunctional and efficient than your device’s stock firmware while remaining easy to us...
Page 10 - Naming conventions and marks
Chapter 1. Introduction 10 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’llusually get an answer pretty quickly. More information including IRC logs can be foundat http://www...
Page 11 - Installation
Chapter 2. Installation 11 2 Installation 2.1 Overview There are two ways of installing Rockbox: automated and manual. While the manualway is older, more tested and proven to work correctly, the automated installation isbased on a nice graphical application that does almost everything for you. It is...
Page 12 - Installing Rockbox
Chapter 2. Installation 12 2.2 Prerequisites Before installing Rockbox you should make sure you meet the prerequisites. You mayneed some additional tools for installation. In most cases these will already be availableon your computer, but if not, installing some additional software might be necessar...
Page 16 - Uninstalling Rockbox
Chapter 2. Installation 16 overwrite files, choose the “Yes to all” option. The new build will be installed over yourcurrent build. Note: If you use Rockbox Utility be aware that it cannot detect manually installed b components. 2.6 Uninstalling Rockbox 2.6.1 Automatic Uninstallation You can uninsta...
Page 17 - Quick Start
Chapter 3. Quick Start 17 3 Quick 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 approx-imately one second should be performed on that bu...
Page 20 - Customising Rockbox
Chapter 3. Quick Start 20 3.2 Customising Rockbox Rockbox’ User Interface can be customised using “Themes”. Themes usually only affectthe visual appearance, but an advanced user can create a theme that also changes variousother settings like file view, LCD settings and all other settings that can be...
Page 21 - Browsing and playing
Chapter 4. Browsing and playing 21 4 Browsing 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 andexecuting the default action ...
Page 28 - While Playing Screen
Chapter 4. Browsing and playing 28 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 ...
Page 32 - Working with Playlists
Chapter 4. Browsing and playing 32 This screen is accessible from the WPS screen, and provides a detailed view of all theidentity information about the current track. This info is known as meta data and isstored in audio file formats to keep information on artist, album etc. To access thisscreen, Op...
Page 37 - The Main Menu; Introducing the Main Menu
Chapter 5. The Main Menu 37 5 The Main Menu 5.1 Introducing the Main Menu Figure 5.1: The main menu The Main Menu is the screen from which all of the Rockbox functions can be accessed. This is the first screen you will see when starting Rockbox. To return to the Main Menu , press the Menu button. Al...
Page 38 - Navigating the Main Menu
Chapter 5. The Main Menu 38 5.2 Navigating the Main Menu 5.3 Recent Bookmarks Figure 5.2: The list bookmarks screen If the Save a list of recently created bookmarks option is enabled then you can view a list of several recent bookmarks here and select one to jump straight to that track.See section 8...
Page 42 - Sound Settings
Chapter 6. Sound Settings 42 6 Sound Settings Figure 6.1: The sound settings screen The sound settings menu offers a selection of sound settings you may change to customiseyour listening experience. 6.1 Volume This setting adjusts the volume of your music. Like most professional audio gear andmany c...
Page 48 - Playback Settings
Chapter 7. Playback Settings 48 7 Playback Settings The Playback Settings menu allows you to configure settings related to audio play- back. 7.1 Shuffle Turning shuffle on will cause Rockbox to randomly re-order the playlist. Thus, to shuffleall of the audio files on the player, you first need to cr...
Page 49 - Play Selected First
Chapter 7. Playback Settings 49 7.3 Play Selected First This setting controls what happens when you select a file for playback while shuffle modeis on. If the Play Selected First setting is Yes , the file you selected will be played first. If this setting is No , a random file in the directory will ...
Page 52 - Cuesheet Support
Chapter 7. Playback Settings 52 Note: You must have the Repeat option set to No for Auto-Change Directory to b function properly. Note: This feature only works when songs have been played from the file browser. Using b it with the database may cause unexpected behavior. 7.12 Pause on Headphone Unplu...
Page 54 - General Settings
Chapter 8. General Settings 54 8 General Settings Figure 8.1: The general settings screen 8.1 Playlist The Playlist sub menu allows you to configure settings related to playlists. Recursively Insert Directories. If set to On , then when a directory is inserted or queued into a dynamic playlist, all ...
Page 64 - Theme Settings
Chapter 9. Theme Settings 64 9 Theme Settings The Theme Settings menu offers options that you can change to customize the visual apperance of Rockbox. Browse Themes. This option will display all the currently installed themes on the player, press Select or Right to load the chosen theme and apply it...
Page 129 - 1 Random Folder Advance Configuration
Chapter 10. Plugins 129 Key Action Power Exit plugin A Start / Stop Select Tap tempo Left / Right Adjust tempo Up / Down Adjust volume 10.4.11 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 Ra...
Page 133 - 1 Advanced Topics; Customising the User Interface
Chapter 11. Advanced Topics 133 11 Advanced Topics 11.1 Customising the User Interface 11.1.1 Getting Extras Rockbox supports custom fonts. A collection of fonts is available for download in thefont package at http://www.rockbox.org/daily.shtml . 11.1.2 Loading Fonts Rockbox can load fonts dynamical...
Page 134 - Configuring the WPS
Chapter 11. Advanced Topics 134 11.1.5 Changing Filetype Colours Rockbox has the capability to modify the File Browser to show different filetypes indifferent colours depending upon the file extension. See the Z CustomFiletypeColours Wiki page for details. 11.1.6 Loading Backdrops Rockbox supports s...
Page 137 - Managing Rockbox Settings
Chapter 11. Advanced Topics 137 Using Images You can have as many as 52 images in your WPS. There are various ways of displayingimages: 1. Load and always show the image, using the %x tag 2. Preload the image with %xl and show it with %xd . This way you can have your images displayed conditionally. ...
Page 139 - Firmware Loading
Chapter 11. Advanced Topics 139 11.3.3 The Manage Settings menu The Manage Settings menu can be found in the Main Menu . The Manage Set- tings menu allows you to save and load .cfg files. Browse .cfg Files Opens the file browser in the /.rockbox directory and displays all .cfg (configuration) files....
Page 140 - A File formats; A.1 Supported file formats
Appendix A. File formats 140 A File formats A.1 Supported file formats Icon File Type Extension Action when selected Directory none The browser enters thatdirectory Audio file various (see section A.2 (page 141 ) ) Rockbox takes you to theWPS and starts playingthe file Cuesheet .cue View a cuesheet ...
Page 141 - A.2 Supported audio formats
Appendix A. File formats 141 A.2 Supported audio formats Format Extension Notes Lossy codecs MPEG audio .mp1, .mpa, .mp2,.mp3 OGG/Vorbis .ogg, .oga Some old “floor 0” filesmay crash Rockbox. Musepack .mpc Advanced Audio Coding .m4a, .m4b, .mp4 Windows Media Audio .wma, .wmv, .asf ATSC A/52 .a52, .ac...
Page 142 - B WPS Tags
Appendix B. WPS Tags 142 B WPS Tags B.1 Status Bar Tag Description %we Status Bar Enabled %wd Status Bar Disabled These tags override the player setting for the display of the status bar. They must benoted on their own line. B.2 ID3 Info Tag Description %ia ID3 Artist %ic ID3 Composer %id ID3 Album ...
Page 143 - B.3 Power Related Information
Appendix B. WPS Tags 143 B.3 Power Related Information Tag Description %bl Show numeric battery level in percent.Can also be used in a conditional: %?bl < -1 | 0 | 1 | 2 | ... | N > Where the -1 value is used when the battery level isn’t known (it usually is). %bv Show the battery level in vol...
Page 145 - B.10 Playback Mode Tags
Appendix B. WPS Tags 145 B.8 Virtual LED Tag Description %lh “h” if the hard disk is accessed B.9 Repeat Mode Tag Description %mm Repeat mode, 0-4, in the order: Off, All, One, Shuffle Example: %?mm < Off | All | One | Shuffle | A-B > B.10 Playback Mode Tags Tag Description %mp Play status, 0-...
Page 148 - B.15 Conditional Tags
Appendix B. WPS Tags 148 • The images must be in a rockbox compatible format (1 bit per pixel BMP) • The image tag must be on its own line • The ID is case sensitive, giving 52 different ID’s • The size of the LCD screen for each player varies. See table below for appropriatesizes of each device. Th...
Page 150 - C Config file options
Appendix C. Config file options 150 C Config file options Setting Allowed Values Unit volume dB bass dB treble dB balance -100 to +100 % channels stereo, mono, custom, mono left,mono right, karaoke N/A stereo width 0 to 250 % shuffle on, off N/A repeat off, all, one, shuffle, ab N/A play selected on...
Page 154 - D User feedback; D.1.1 Rules for submitting new bug reports
Appendix D. User feedback 154 D User feedback D.1 Bug reports If you experience inappropriate performance from any supported feature, please file abug report on our web page. Do not report missing features as bugs, instead file themas feature ideas (see below). For open bug reports refer to http://w...
Page 156 - E Changelog
Appendix E. Changelog 156 E Changelog E.1 What is new since v3.0? E.1.1 New features ? 2008-12-09: Album Art resizing. ? 2008-12-09: FM radio support on Gigabeat S. ? 2008-11-26: Software controlled backlight fading for targets without hardware fad-ing (e200v1, c200v1, X5, Cowon D2 and H300) E.1.2 E...
Page 160 - F Credits
Appendix F. Credits 160 F Credits People that have contributed to the pro ject, one way or another. Friends! · Bj¨ orn Stenberg · Linus Nielsen Feltz- ing · Andy Choi · Andrew Jamieson · Paul Suade · Joachim Schiffer · Daniel Stenberg · Alan Korr · Gary Czvitkovicz · Stuart Martin · Fe- lix Arends ·...
Page 163 - G Licenses; G.1 GNU Free Documentation License; Preamble
Appendix G. Licenses 163 G Licenses G.1 GNU Free Documentation License Version 1.2, November 2002 Copyright c 2000,2001,2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, bu...
Page 165 - COPYING IN QUANTITY
Appendix G. Licenses 165 A section ”Entitled XYZ” means a named subunit of the Document whose title ei- ther is precisely XYZ or contains XYZ in parentheses following text that translates XYZin another language. (Here XYZ stands for a specific section name mentioned below,such as ”Acknowledgements” ...
Page 169 - FUTURE REVISIONS OF THIS LICENSE
Appendix G. Licenses 169 8. TRANSLATION Translation is considered a kind of modification, so you may distribute translations of theDocument under the terms of section 4. Replacing Invariant Sections with translationsrequires special permission from their copyright holders, but you may include transl...
Page 171 - G.2 The GNU General Public License; GNU General Public License
Appendix G. Licenses 171 G.2 The GNU General Public License Version 2, June 1991 Copyright c 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is...
Page 175 - No Warranty
Appendix G. Licenses 175 decide if he or she is willing to distribute software through any other system anda licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a conse-quence of the rest of this License. 8. If the distribution and/or use of t...
