User manual ARCHOS PLAYER - THE ROCKBOX MANUAL

D RA rockbox.org June 6, 2008 FT V ER The Rockbox Manual for Archos Jukebox 5000, 6000, Studio 10 and 20 SI O N 2 Rockbox http://www.rockbox.org/ Open Source Jukebox Firmware c 2003-2008 The Rockbox Team and its contributors, c 2004 Christi Alice Scarborough, c 2003 Jos´ Maria Garcia-Valdecasas Bernal & Peter Schlenker. e RA D 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". THE ROCKBOX MANUAL FT Rockbox and this manual is the collaborative effort of the Rockbox team and its contributors. See the appendix for a complete list of contributors. A Version r17694-080606. Built using pdfL TEX. V ER SI O N ARCHOS STUDIO/PLAYER CONTENTS 3 Contents RA 3 Quick Start 3.1 Basic overview . . . . . . . . . . . . . 3.1.1 The player's controls . . . . . 3.1.2 Turning the player on and off 3.1.3 The first contact . . . . . . . . 3.1.4 Basic controls . . . . . . . . . 3.1.5 Basic concepts . . . . . . . . . 3.2 Customising Rockbox . . . . . . . . 3.3 Menu overview . . . . . . . . . . . . V ER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Installation 2.1 Overview . . . . . . . . . . . . . . . . . . . . 2.2 Prerequisites . . . . . . . . . . . . . . . . . . 2.3 Installing Rockbox . . . . . . . . . . . . . . 2.3.1 Automated Installation . . . . . . . 2.3.2 Manual Installation . . . . . . . . . . 2.3.3 Enabling Speech Support (optional) 2.4 Running Rockbox . . . . . . . . . . . . . . . 2.5 Updating Rockbox . . . . . . . . . . . . . . 2.6 Uninstalling Rockbox . . . . . . . . . . . . . 2.6.1 Automatic Uninstallation . . . . . . 2.6.2 Manual Uninstallation . . . . . . . . 4 Browsing and playing 4.1 File Browser . . . . . . . . . . . 4.1.1 File Browser Controls . 4.1.2 Context Menu . . . . . . 4.1.3 Virtual Keyboard . . . . 4.2 Database . . . . . . . . . . . . . 4.2.1 Introduction . . . . . . . 4.2.2 Initializing the database 4.2.3 The Database Menu . . FT D THE ROCKBOX MANUAL SI O N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 10 10 11 11 11 12 13 13 13 13 13 14 14 14 14 15 15 15 16 16 17 17 18 18 19 20 20 20 21 ARCHOS STUDIO/PLAYER 1 Getting started 1.1 Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 Getting more help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.3 Naming conventions and marks . . . . . . . . . . . . . . . . . . . . . . . 8 8 8 9 CONTENTS 4.2.4 Using the database . . . . While Playing Screen . . . . . . . 4.3.1 WPS Key Controls . . . . 4.3.2 The WPS Context Menu . Working with Playlists . . . . . . 4.4.1 Playlist terminology . . . 4.4.2 Creating playlists . . . . . 4.4.3 Adding music to playlists 4.4.4 Modifying playlists . . . . 4.4.5 Saving playlists . . . . . . 4.4.6 Loading saved playlists . 4.4.7 Helpful Hints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 21 22 23 23 25 25 25 26 27 28 28 28 4.3 4.4 RA 6 Sound Settings 6.1 Volume . . . 6.2 Bass . . . . . 6.3 Treble . . . . 6.4 Balance . . . 6.5 Channels . . 6.6 Stereo Width 7 General Settings 7.1 Playback . . 7.2 Playlist . . . 7.3 File View . . 7.4 Database . . 7.5 Display . . . FT 5 The Main Menu 5.1 Introducing the Main Menu . . . 5.2 Navigating the Main Menu . . . 5.3 Recent Bookmarks . . . . . . . . 5.4 Files . . . . . . . . . . . . . . . . . 5.5 Database . . . . . . . . . . . . . . 5.6 Now Playing/Resume Playback 5.7 Settings . . . . . . . . . . . . . . . 5.7.1 Sound Settings . . . . . . 5.7.2 General Settings . . . . . . 5.7.3 Manage Settings . . . . . 5.7.4 Theme Settings . . . . . . 5.8 Playlist . . . . . . . . . . . . . . . 5.9 Plugins . . . . . . . . . . . . . . . 5.10 System . . . . . . . . . . . . . . . 5.11 Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . V ER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D . . . . . . . . . . . . . . . . . . . . . . . . . THE ROCKBOX MANUAL SI O N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 29 29 30 30 30 30 30 31 31 31 31 31 32 32 32 33 33 33 33 34 34 34 35 35 37 37 38 38 ARCHOS STUDIO/PLAYER CONTENTS 7.6 System . . . . . . . . . . . 7.6.1 Start Screen . . . . 7.6.2 Battery . . . . . . . 7.6.3 Disk . . . . . . . . 7.6.4 Idle Poweroff . . . 7.6.5 Limits . . . . . . . 7.6.6 Line In . . . . . . . 7.6.7 Car Adapter Mode Bookmarking . . . . . . . Language . . . . . . . . . . Voice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 40 40 40 40 40 41 41 41 41 43 43 7.7 7.8 7.9 8 Theme Settings 9 Plugins 9.1 Games . . . . . . . . . . . . . . . . . 9.1.1 Flipit . . . . . . . . . . . . . . 9.1.2 Jackpot . . . . . . . . . . . . . 9.1.3 Nim . . . . . . . . . . . . . . 9.1.4 Rockblox . . . . . . . . . . . . 9.2 Demos . . . . . . . . . . . . . . . . . 9.2.1 Credits . . . . . . . . . . . . . 9.2.2 Cube . . . . . . . . . . . . . . 9.2.3 Logo . . . . . . . . . . . . . . 9.2.4 Mosaique . . . . . . . . . . . 9.2.5 Snow . . . . . . . . . . . . . . 9.3 Viewers . . . . . . . . . . . . . . . . . 9.3.1 Shortcuts . . . . . . . . . . . . 9.3.2 Search . . . . . . . . . . . . . 9.3.3 Sort . . . . . . . . . . . . . . . 9.3.4 Text Viewer . . . . . . . . . . 9.3.5 VBRfix . . . . . . . . . . . . . 9.4 Applications . . . . . . . . . . . . . . 9.4.1 Alpine CD changer emulator 9.4.2 Battery Benchmark . . . . . . 9.4.3 Chess Clock . . . . . . . . . . 9.4.4 Dice . . . . . . . . . . . . . . . 9.4.5 Disk Tidy . . . . . . . . . . . 9.4.6 Euro Converter . . . . . . . . 9.4.7 Lamp . . . . . . . . . . . . . . 9.4.8 Metronome . . . . . . . . . . 9.4.9 Stats . . . . . . . . . . . . . . 9.4.10 Stopwatch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D R THE ROCKBOX MANUAL A FT V ER SI O N 45 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 46 46 47 47 48 48 48 49 49 50 50 50 50 51 51 52 53 53 53 54 56 57 57 58 58 58 59 59 ARCHOS STUDIO/PLAYER CONTENTS 10 Advanced Topics 10.1 Customising the userinterface . . . . . . . . . . . . . . . 10.1.1 Getting Extras . . . . . . . . . . . . . . . . . . . . 10.1.2 Loading Languages . . . . . . . . . . . . . . . . 10.2 Configuring the WPS . . . . . . . . . . . . . . . . . . . . 10.2.1 WPS ­ General Info . . . . . . . . . . . . . . . . . 10.2.2 WPS ­ Build Your Own . . . . . . . . . . . . . . 10.3 Managing Rockbox settings . . . . . . . . . . . . . . . . 10.3.1 Introduction to .cfg files. . . . . . . . . . . . . . 10.3.2 Specifications for .cfg files. . . . . . . . . . . . 10.3.3 The MANAGE SETTINGS menu . . . . . . . . . . 10.4 Firmware Loading . . . . . . . . . . . . . . . . . . . . . 10.4.1 Using ROLO (Rockbox loader) . . . . . . . . . . 10.5 Rockbox in flash . . . . . . . . . . . . . . . . . . . . . . . 10.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . 10.5.2 Terminology . . . . . . . . . . . . . . . . . . . . . 10.5.3 Method . . . . . . . . . . . . . . . . . . . . . . . . 10.5.4 Risks . . . . . . . . . . . . . . . . . . . . . . . . . 10.5.5 Requirements . . . . . . . . . . . . . . . . . . . . 10.5.6 Flashing procedure . . . . . . . . . . . . . . . . . 10.5.7 Bringing in a Rockbox build . . . . . . . . . . . . 10.5.8 Restoring the original firmware . . . . . . . . . . 10.5.9 Known issues and limitations . . . . . . . . . . . 10.5.10 Download the new flash content file to your box 6 60 60 60 60 60 60 61 63 63 64 65 65 65 66 66 66 66 67 68 68 69 70 70 71 72 72 73 73 73 74 74 75 75 75 75 76 77 78 78 79 80 A File formats A.1 Supported file formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B WPS Tags B.1 Status Bar . . . . . . . . . . B.2 ID3 Info . . . . . . . . . . . . B.3 Power Related Information B.4 File Info . . . . . . . . . . . . B.5 Playlist/Song Info . . . . . . B.6 Runtime Database . . . . . . B.7 Virtual LED . . . . . . . . . B.8 Repeat Mode . . . . . . . . . B.9 Playback Mode Tags . . . . B.10 Images . . . . . . . . . . . . B.11 Alignment . . . . . . . . . . B.12 Conditional Tags . . . . . . B.13 Other Tags . . . . . . . . . . C Config file options FT V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D R THE ROCKBOX MANUAL A SI O N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ARCHOS STUDIO/PLAYER CONTENTS D User feedback D.1 Bug reports . . . . . . . . . . . . . . . . . . . . . . . D.1.1 Rules for submitting new bug reports . . . D.2 Feature requests . . . . . . . . . . . . . . . . . . . . D.2.1 Rules for submitting a new feature request D.2.2 Features we will not implement . . . . . . 7 82 82 82 82 82 83 85 85 86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F Credits G Licenses G.1 GNU Free Documentation License . . . . . . . . . . . . . . . . . . . . . . G.2 The GNU General Public License . . . . . . . . . . . . . . . . . . . . . . . D RA THE ROCKBOX MANUAL FT V ER ARCHOS STUDIO/PLAYER SI O N 89 89 97 E Changelog E.1 What is new since v2.5? . . . . . . . . . . . . . . . . . . . . . . . . . . . . CHAPTER 1. GETTING STARTED 8 1 Getting started 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 public license, 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 that 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. D RA 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 channel THE ROCKBOX MANUAL FT V ER SI O N ARCHOS STUDIO/PLAYER CHAPTER 1. GETTING STARTED 9 1.3 Naming conventions and marks D 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. "Archos 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 are intended especially for the blind and visually impaired. As they cannot read the manual in the same way sighted people can 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 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 Zin front of the page name. V ER SI O N b ! ¸ ARCHOS STUDIO/PLAYER 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 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 82) for details on how to use the tracker. RA THE ROCKBOX MANUAL FT CHAPTER 2. INSTALLATION 10 2 Installation 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 that is needed for you. It is still important that you have an overview of the installation process to be able to select the correct installation options. Rockbox itself comes as a single package. There is no need to install additional software for running Rockbox. Before installing Rockbox you should make sure you meet the prerequisites. Also you may need some tools for installation. In most cases these will be already available on your computer but if not you need to get some additional software. USB connection. To transfer Rockbox to your player you need to connect it to your computer. To proceed you need to know where to access the player. On Windows this means you need to figure out the drive letter associated with the device. On Linux you need to know the mount point of your player. For manual installation and customization additional software is required. ZIP utility. Rockbox is distributed as an archive using the .zip format. Thus you need a tool to handle that compressed format. Usually your computer should have a tool installed that can handle the .zip file format. 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/ 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 within Rockbox, 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". D RA THE ROCKBOX MANUAL FT V ER 2.2 Prerequisites SI O N ARCHOS STUDIO/PLAYER CHAPTER 2. INSTALLATION 11 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 any of all available parts of Rockbox · Install additional themes interactively · Install voice files and generate talk clips · Uninstall all components you installed using Rockbox Utility 2.3.2 Manual Installation Choosing a Rockbox version D RA There are three different types of firmware binaries from the Rockbox website: Release version, current build and daily build. You need to decide which one you want to install and get the 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 2.5, 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 represent the current state of Rockbox development. This means that the build could contain bugs, but is most of the time safe to use. You can download the current build from http://build.rockbox.org/. THE ROCKBOX MANUAL FT Prebuilt binaries for Windows, Linux and MacOS X are available from http://download. rockbox.org/rbutil/. As Rockbox Utility is still under development more information including up-to-date download links can be found at ZRockboxUtility. Warning: Upon the first start of Rockbox Utility you need to set at least the correct player and mountpoint in the configuration dialog. Autodetection can detect most player types. If autodetection failed or was 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. V ER SI O N ! b ARCHOS STUDIO/PLAYER CHAPTER 2. INSTALLATION 12 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. 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 really stick to the current stable release, if there is one for your player. If you want to help the 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! 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 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. Note that 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 file called archos.mod in the main directory of your player's drive, and also a directory called /.rockbox, which contains a number of other directories and system files needed by Rockbox. If you receive a "-1" error when you start Rockbox, you have not extracted the contents of the .zip file to the proper location. V ER SI O N b ARCHOS STUDIO/PLAYER D RA 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 7.9 (page 43) for details on voice settings. THE ROCKBOX MANUAL FT CHAPTER 2. INSTALLATION 13 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 step before. If your unzip program asks you whether to 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 can not detect manually installed components. SI O N ARCHOS STUDIO/PLAYER b 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 D THE ROCKBOX MANUAL RA If you would like to go back to using the original Archos software, connect the player to your computer, and delete the archos.mod file. If you wish to clean up your disk, you may also wish to delete the .rockbox directory and its contents. Turn the Archos off. Turn the player back on and the original Archos software will load. FT V ER 2.6 Uninstalling Rockbox CHAPTER 3. QUICK START 14 3 Quick Start 3.1 Basic overview 3.1.1 The player's controls D Throughout this manual, the buttons on the player are labelled according to the picture above. When a table of button actions says "Long" before the button it means that you should make a long press on that button, in other words, press it for approximately 1 second. In detail the buttons are described in the following paragraph. Additional information is available for blind users on the Rockbox website at ZBlindFAQ. Holding the Jukebox in front of you there should be two buttons to the left of the unit and a single multi-way circular button to their right. The buttons are as follows.On the left hand side, the higher of the two small buttons is the On, the lower of the two buttons is the Menu button. The large circular button on the right - push towards the top serves as Play, push towards the left is called Minus, push towards the right Plus and push towards the bottom is labelled Stop. RA FT V ER ¸ 3.1.2 Turning the player on and off To turn on and off your Rockbox enabled player use the following keys: THE ROCKBOX MANUAL ARCHOS STUDIO/PLAYER SI O N CHAPTER 3. QUICK START Key Long On From the Main Menu, select Shutdown Action Start Rockbox Shutdown Rockbox 15 3.1.3 The first contact 3.1.4 Basic controls D RA Playlists 1 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 Plus and Minus to move around the selection. Use Play 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 22). 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 Stop button or return to the file browser while keeping playback running using On. In list views you can go back one step with Stop. 3.1.5 Basic concepts 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 25). ID3 Tags, Vorbis comments, etc. THE ROCKBOX MANUAL FT V ER 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 29)). To browse the files on you player select FILES (see section 4.1 (page 17)), and to browse in a view that is based on the meta-data1 of your audio files, select DATABASE (see section 4.2 (page 20)). SI O N ARCHOS STUDIO/PLAYER On shutdown, Rockbox automatically saves its settings. In the unlikely event of a software failure, a hardware power off can be performed by holding down Stop until the player power light goes off. CHAPTER 3. QUICK START Menu 16 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 Play. 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. 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 10.3 (page 63). 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. V ER SI O N b ARCHOS STUDIO/PLAYER 3.3 Menu overview include an overview of the menu structure here D THE ROCKBOX MANUAL RA FT CHAPTER 4. BROWSING AND PLAYING 17 4 Browsing and playing 4.1 File Browser Figure 4.1: The file browser D RA THE ROCKBOX MANUAL FT 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 7.3 (page 37) 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 20). The remainder of this section deals with the FILE BROWSER. V ER SI O N ARCHOS STUDIO/PLAYER b CHAPTER 4. BROWSING AND PLAYING 18 4.1.1 File Browser Controls Key Minus/Plus Action Go to previous/next item in list. If you are on the first/last entry, the cursor will wrap to the last/first entry. Go to the parent directory. Executes the default action on the selected file or enters a directory. If there is an audio file playing, returns to the WHILE PLAYING SCREEN (WPS) without stopping playback. Enter the CONTEXT MENU Enter the MAIN MENU On Long Play Menu Figure 4.2: The Context Menu D RA 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): FT V ER b ARCHOS STUDIO/PLAYER 4.1.2 Context Menu Playlist. Enters the PLAYLIST SUBMENU (see section 4.4.3 (page 26)). Playlist Catalog. Enters the PLAYLIST CATALOG SUBMENU (see section 4.4.2 (page 26)). 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'. THE ROCKBOX MANUAL SI O N Stop Play CHAPTER 4. BROWSING AND PLAYING 19 Copy. Copies the name of the currently selected file or directory to the clipboard and marks it to be `copied'. 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 Play to confirm deletion or any other key to cancel. Delete Directory. Deletes the currently selected directory and all of the files and subdirectories it may contain. Deleted directories cannot be recovered. Use this feature with caution! 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. 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 RA D THE ROCKBOX MANUAL This is the virtual keyboard that is used when entering text in Rockbox, for example when renaming a file or creating a new directory. FT Figure 4.3: The virtual keyboard V ER Open with. Runs a viewer plugin on the file. Normally, when a file is selected in Rockbox, 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 9.3 (page 50) for more details on viewers. SI O N ARCHOS STUDIO/PLAYER CHAPTER 4. BROWSING AND PLAYING 20 The current text line to be entered or edited is always listed on the first line of the display. The second line of the display can contain the character selection bar, as in the screenshot above. Key On Minus/Plus Play Action Toggle picker- and line edit mode moves back and forth in the selected line (picker of input line) Picks character in character bar, or acts as backspace in the text line. Accept Cancel Flips picker lines Long Play Stop Menu 4.2.1 Introduction 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 and Genre. 4.2.2 Initializing the database D RA 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. 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. THE ROCKBOX MANUAL FT V ER 4.2 Database SI O N ARCHOS STUDIO/PLAYER CHAPTER 4. BROWSING AND PLAYING 21 4.2.3 The Database Menu Auto Update. If AUTO UPDATE is set to ON, each time the player boots, the database will automatically be updated. AUTO UPDATE does not detect deleted files. To remove deleted files from the database you need to run UPDATE NOW. Initialize Now. You can force Rockbox to rescan your disk for tagged files by using the INITIALIZE NOW function in the DATABASE MENU. Update Now. UPDATE NOW causes the database to detect new and deleted files 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. 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. Import Modifications. Allows the /.rockbox/database changelog.txt backup to be conveniently loaded into the database. If AUTO UPDATE is enabled this is performed 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 and Song Name. To use the database, go to the MAIN MENU and select DATABASE. RA FT V ER SI O N ARCHOS STUDIO/PLAYER Warning: INITIALIZE NOW removes all database files (removing runtimedb data also) and rebuilds the database from scratch. ! 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 D THE ROCKBOX MANUAL CHAPTER 4. BROWSING AND PLAYING Tag filename album albumartist artist comment composer genre grouping title bitrate discnum year tracknum autoscore lastplayed playcount Pm (play time min) Ps (play time - sec) rating commitid entryage length Lm (track len min) Ls (track len - sec) Type string string string string string string string string string numeric numeric numeric numeric numeric numeric numeric numeric Origin system id tag id tag id tag id tag id tag id tag id tag id tag id tag id tag id tag id tag/filename runtime db runtime db runtime db runtime db runtime db runtime db system system system system system 22 4.3 While Playing Screen RA The While Playing Screen (WPS) displays various pieces of information about the currently playing audio file. Note: · Playlist index/Playlist size: Artist - Title. · Current-time Progress-indicator Left. FT V ER numeric numeric numeric numeric numeric numeric numeric SI O N b ARCHOS STUDIO/PLAYER D See section 10.2 (page 60) for details of customising your WPS (While Playing Screen). THE ROCKBOX MANUAL CHAPTER 4. BROWSING AND PLAYING 23 4.3.1 WPS Key Controls Key Menu + Plus / Menu + Minus Minus Action Volume up/down. Go to beginning of track, or if pressed while in the first seconds of a track, go to previous track. Rewind in track. Go to next track. Fast forward in track. Toggle play/pause. Stop playback. Return to the FILE BROWSER. Enter WPS CONTEXT MENU. Enter MAIN MENU. Key lock on/off. Mute on/off. Enter ID3 VIEWER. 4.3.2 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: 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. D RA 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 MANUAL FT Playlist V ER Long Minus Plus Long Plus Play Stop On Long Play Menu Menu+Stop Menu+Play Menu + On SI O N ARCHOS STUDIO/PLAYER CHAPTER 4. BROWSING AND PLAYING Sound Settings 24 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 (page 33) for more information. Playback Settings Rating The menu entry is only shown if GATHER RUNTIME INFORMATION is enabled. It allows the asignment of a personal rating value (0 ­ 10) to a track which can be displayed in the WPS and used in the Database browser. Press Plus to increment the value. The value wraps at 10. Bookmarks This allows you to create a bookmark in the currently-playing track. Show Track Info D RA Open With... 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 Menu + On. Use Minus and Plus to move through the information. This OPEN WITH function is the same as the OPEN WITH function in the file browser's CONTEXT MENU. THE ROCKBOX MANUAL FT Figure 4.4: The track info viewer V ER SI O N ARCHOS STUDIO/PLAYER This is a shortcut to the PLAYBACK SETTINGS MENU, where you can configure shuffle, repeat, party mode, study mode and other settings affecting the playback of your music. CHAPTER 4. BROWSING AND PLAYING Delete Delete the currently playing file. 25 4.4 Working with Playlists This section is currently in a half written state, with possible errors and a lot of stuff missing. Please help us fix this chapter by submitting additions/corrections to the tracker 4.4.1 Playlist terminology Some common terms that are used in Rockbox when referring to playlists: Dynamic playlist. A dynamic playlist is a playlist that is created "On the fly." Any time you insert or queue tracks using the PLAYLIST SUBMENU (see section 4.4.3 (page 26)), you are creating (or adding to) a dynamic playlist. Insert. In Rockbox, to INSERT an item into a playlist means putting an item into a playlist and leaving it there, even after it is played. As you will see later in this chapter, Rockbox can INSERT into a playlist in several places. Queue. In Rockbox, to QUEUE a song means to put the song into a playlist and then to remove the song from the playlist once it has been played. The only difference between INSERT and QUEUE is that the QUEUE option removes the song from the playlist once it has been played, and the INSERT option does not. D RA 4.4.2 Creating playlists Rockbox can create playlists in four different ways. By selecting ("playing") a song from the File Browser Whenever a song is selected from the FILE BROWSER with Play, 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 FT V ER Directory. A playlist! One of the keys to getting the most out of Rockbox is understanding that Rockbox always considers the song that it is playing to be part of a playlist, and in some situations, Rockbox will create a playlist automatically. For example, if you are playing the contents of a directory, Rockbox will automatically create a playlist containing all songs in it. This means that just about anything that is described in this chapter with respect to playlists also applies to directories. SI O N b ARCHOS STUDIO/PLAYER THE ROCKBOX MANUAL CHAPTER 4. BROWSING AND PLAYING 26 playlist rather than erasing the current playlist, see the section below on how to add music to a playlist. By using Insert and Queue functions If playback is stopped, the INSERT and QUEUE functions can be used as described in 4.4.3 to create a new playlist instead of adding to an existing one. This will erase any dynamic playlist. By using the Playlist catalog By using the Main Menu To create a playlist containing all music on your player, you can use the CREATE PLAYLIST command in the PLAYLIST OPTIONS menu found in the MAIN MENU. The created playlist will be named root.m3u and saved in the root of your player's harddisk. Adding music to a dynamic playlist RA D The PLAYLIST SUBMENU is a submenu in the CONTEXT MENU (see section 4.1.2 (page 18)), 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 ROCKBOX MANUAL FT 4.4.3 Adding music to playlists Figure 4.5: The Playlist Submenu V ER The PLAYLIST CATALOG makes it possible to modify and create playlists that are not currently playing. To do this select PLAYLIST CATALOG 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 CATALOG are stored in the /Playlists directory in the root of your player's harddisk and playlists stored in other locations are not included in the catalog. It is however possible to move existing playlists there (see section 4.1.2 (page 18)). SI O N ARCHOS STUDIO/PLAYER