background image

DRAFT

VERSION

C

HAPTER

4. T

HE

M

AIN

M

ENU

24

A theme is basically a configuration file, stored in a specific directory, that typically

changes the WPS , font used and on some platforms additional information such as
background image and text colours.

There are a number of themes that ship with Rockbox. If none of these suit your

needs, many more can be downloaded from . Some of the downloads from this site
will actually be standalone WPS files, others will be full-blown themes.

Note:

Themes do not have to be purely visual. It is quite possible to create a theme that

b

switches between audio configurations for use in the car, with headphones and when
connected to an external amplifier. See section

8.2.2

(page

49

) for more details.

4.8. Playlist Options

This menu allows you to work with playlists. Playlists can be created in three ways.
Playing a file in a directory causes all the files in the directory to be placed in a playlist.
Playlists can be created manually by either using the F

ILE

M

ENU

(see section

3.2.2

(page

14

)) or using the P

LAYLIST

O

PTIONS

menu. Both automatically and manually created

playlists can be edited using this menu.

Create Playlist:

Rockbox will create a playlist with all tracks in the current directory

and all subdirectories. The playlist will be created one folder level “up” from
where you currently are.

View Current Playlist:

Displays the contents of the playlist currently stored in mem-

ory.

Save Current Playlist:

Saves the current dynamic playlist, excluding queued tracks,

to the specified file. If no path is provided then playlist is saved to current direc-
tory (see section

3.2.3

(page

15

)).

Recursively Insert Directories:

If set to O

N

, then when a directory is inserted or

queued into a dynamic playlist, all subdirectories will also be inserted. If set
to A

SK

, Rockbox will prompt the user about whether to include subdirectories.

Options: O

FF

, A

SK

, O

N

Warn When Erasing Dynamic Playlist:

If set to Y

ES

, Rockbox will provide a warn-

ing if the user attempts to take an action that will cause Rockbox to erase the
current dynamic playlist. Options: Y

ES

, N

O

4.9. Browse Plugins

With this option you can load and run various plugins that have been written for Rock-
box. There are a wide variety of these supplied with Rockbox, including several games,
some impressive demos and a number of utilities. A detailed description of the differ-
ent plugins is to be found in section

7

(page

37

).

T

HE

R

OCKBOX MANUAL

A

RCHOS

S

TUDIO

/P

LAYER

Summary of Contents for Archos Jukebox Studio 5000

Page 1: ...D R A F T V E R S I O N The Rockbox Manual for Archos Jukebox Studio 5000 6000 Player 10 and 20 rockbox org August 22 2006...

Page 2: ...ts contributors c 2004 Christi Alice Scarborough c 2003 Jose Maria Garcia Valdecasas Bernal Peter Schlenker Permission is granted to copy distribute and or modify this document un der the terms of the...

Page 3: ...3 The Rockbox interface 12 3 1 Your player 12 3 1 1 The player s controls 12 3 1 2 Turning the player on and off 12 3 2 File Browser 13 3 2 1 File Browser Controls 14 3 2 2 File Menu 14 3 2 3 Playlist...

Page 4: ...5 Channels 27 5 6 Stereo Width 27 6 General Settings 28 6 1 Playback Options 28 6 2 File View 30 6 3 Display Options 31 6 4 System Options 32 6 4 1 Battery 32 6 4 2 Disk 33 6 4 3 Power Control 33 6 4...

Page 5: ...48 8 2 1 WPS General Info 48 8 2 2 WPS Build Your Own 49 8 3 Managing Rockbox settings 51 8 3 1 Introduction to cfg files 51 8 3 2 Specifications for cfg files 52 8 3 3 The MANAGE SETTINGS menu 53 8 4...

Page 6: ...69 E 1 1 Rules for submitting new bug reports 69 E 2 Feature requests 69 E 2 1 Rules for submitting a new feature request 69 E 2 2 Features we will not implement 70 F Changelog 72 F 1 What s new since...

Page 7: ...een 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 Y...

Page 8: ...k is currently unsupported Manu facturer 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 he...

Page 9: ...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 the device got associated with On Linux yo...

Page 10: ...n this manual introduce new and maybe annoying bugs and similar If you want to help the project development you can try development builds and help by reporting bugs feature requests and so so But be...

Page 11: ...hard disk not in any b of the files contained in the Rockbox build Therefore generally speaking installing a new build does not reset Rockbox to its default settings Be aware however that from time to...

Page 12: ...elled according to the pic ture above 3 1 1 The player s controls Write a section describing the player for blind users 3 1 2 Turning the player on and off To turn on and shut down your player the fol...

Page 13: ...rmat is displayed with an icon The TAG CACHE 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 br...

Page 14: ...he File Menu The FILE MENU allows you to perform certain operations on files or folders To access the FILE MENU position the selector over a file or folder and press the Play On Play buttons Note The...

Page 15: ...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 tha...

Page 16: ...S if you would like Rockbox to include tracks in subdirectories as well as tracks in the currently selected directory If you want to have Rockbox create a playlist of a whole folder to play an entire...

Page 17: ...racter BACKSPACE Playdeletes the character before the current cursor position DELETE Playdeletes the character at the current cursor position ACCEPT Playexits the virtual keyboard and saves any change...

Page 18: ...ed files Note that 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...

Page 19: ...ot want to use it just don t do the initial build of the database and do not load it to RAM Supported Tags Unsupported Tags Artist Comment Album Performer Bitrate Composer Genre Length Title Track Num...

Page 20: ...nu Menu Stop Key lock on off Menu Play Mute on off Menu On Enter ID3 VIEWER 3 4 2 The WPS Context Menu Like the context menu for the FILE BROWSER the WPS CONTEXT MENU allows you quick access to some o...

Page 21: ...um etc To access this screen press Menu On Use Minus and Plus to move through the information Open With This OPEN WITH function is the same as the OPEN WITH function in the FILE CONTEXT MENU Pitch Scr...

Page 22: ...lely for the purpose of saving settings Instead Rockbox will save settings when it spins up the disk the next time for example when refilling the MP3 buffer or navigating through the file browser Chan...

Page 23: ...detail in section 5 page 26 4 5 General Settings The GENERAL SETTINGS menu allows you to customize the way Rockbox looks and the way it plays music The details of this menu are covered in detail in se...

Page 24: ...dited using this menu Create Playlist Rockbox will create a playlist with all tracks in the current directory and all subdirectories The playlist will be created one folder level up from where you cur...

Page 25: ...ut This submenu is intended to be used only by Rockbox developers It shows hardware disk battery status and other technical information Warning It is not recommended that users access this menu unless...

Page 26: ...alues lower than this reference will be negative and yield a progressively softer volume Values higher than 0 dB are available and can be used to raise the volume more than would otherwise be possible...

Page 27: ...described later in this chapter Mono Left Plays the left channel in both stereo channels Mono Right Plays the right channel in both stereo channels Karaoke Removes all sound that is the same in both c...

Page 28: ...will stop when the current direc tory or playlist is finished All The current directory or playlist will repeat when it is finished Note This option does not shuffle all files on your player Rockbox i...

Page 29: ...e button OFF means no acceleration 2X 1S means double the search speed once every second the button is held 2X 5S means dou ble the search speed once every 5 seconds the button is held Anti Skip Buffe...

Page 30: ...ll files that begin with lower case letters If this option is set to NO then case will be ignored when sorting files Sort Directories This option controls how Rockbox sorts folders The default is to s...

Page 31: ...e 17 for more information about using the Tag Cache 6 3 Display Options Browse WPS files Opens the FILE BROWSER in the rockbox wps directory and displays all wps files Selecting one will activate it s...

Page 32: ...essed in percentage of line length Jump Scroll This setting makes text scroll a page at a time instead of a character at a time If set to ONE TIME 2 3 or 4 it will scroll a line in paged mode that man...

Page 33: ...off Rockbox can be configured to turn off power after the unit has been idle for a defined number of minutes The player is idle when playback is stopped or paused It is not idle while the USB or charg...

Page 34: ...okmarking Bookmarks allow you to save your current position within a track so that you can return to it at a later time Bookmarks are saved on a per folder basis In other words all of the files in the...

Page 35: ...the Main Menu When set to YES each new bookmark will be added to the MRB list Setting this to NO disables the addition of bookmarks to the MRB list UNIQUE ONLY will remove an old bookmark for the cur...

Page 36: ...the directory name by spelling it out letter by letter Support is provided only for the most common letters and punctuation Numbers Each directory is assigned a number based upon its position in the...

Page 37: ...erfere with music playback but some of them will stop playback while running Plugins have the file extension rock Most of them can be started from BROWSE PLUGINS in the MAIN MENU Viewer plugins get st...

Page 38: ...on Minus Decrease the number of matches Plus Increase the number of matches Play Remove the number of matches you have selected Stop Exit the game 7 2 Demos 7 2 1 Credits The credits plugin scrolls th...

Page 39: ...us Minus Increase decrease z axis Stop Quit 7 2 3 Logo Demo showing the Rockbox logo bouncing around the screen Key Action Plus Minus Increase decrease speed on the x axis On Plus On Minus Increase de...

Page 40: ...er The results of this search are saved to a new playlist search results m3u within the same directory as the original playlist 7 3 2 Sort This plugin takes a file and sorts it in forward alphabetical...

Page 41: ...rge files Currently Wide and Join cannot be selected together Settings are not remembered after the viewer has been exited Key Action Minus Page up one screen up Plus Page down one screen down Menu Mi...

Page 42: ...supported by this plugin As well as all other protocols please do not ask for such The cable Hookup to Archos works by connecting the headphone output including the remote pin you need a 4 ring 3 5 m...

Page 43: ...loaded The player is shut down The battery is empty Between disk activity or an hour it will log info in memory every measurement is captured when the voltage changes If there are too many measuremen...

Page 44: ...harger An A in that column shows if there was the power adapter attached to the unit at the time of the measurement S The S column shows the state of the device Charging or not The C indicated that th...

Page 45: ...total time left if different Keys are as follows Key Action On Exit plugin Stop Restart round for the current player Play Pause the time press again to continue Plus Switch to next player Minus Switc...

Page 46: ...ys increase and decrease the current digit The amount in the old currency is displayed on the second line 7 4 6 Favorites WARNING Image not found Figure 7 7 Favorites When listening to any song you ca...

Page 47: ...lders on your player Press Stop to exit the plugin 7 4 9 Stopwatch WARNING Image not found Figure 7 9 Stopwatch A simple stopwatch program with support for saving times Keys are as follows Key Action...

Page 48: ...must be a maximum of 24 characters long If your language is not yet supported and you want to write your own language file find the instructions on the Rockbox website http www rockbox org twiki bin v...

Page 49: ...have a bigger WPS file only the first part of it will be loaded and used Conditional Tags If else Syntax xx true false If the tag specified by xx has a value the text between the and the is displayed...

Page 50: ...s of a second for the subline to be displayed Subline related special characters and tags Split items on a line into separate sublines t Set the subline display time The t is followed by either intege...

Page 51: ...g and use EXAMPLE x a static_icon bmp 50 50 xl b rep off bmp 16 64 xl c rep all bmp 16 64 xl d rep one bmp 16 64 xl e rep shuffle bmp 16 64 mm xdb xdc xdd xde Four images at the same x and y position...

Page 52: ...the format setting value 3 Values must be within the ranges specified in this manual for each setting 4 Lines starting with are ignored This lets you write comments into your config uration files Exa...

Page 53: ...is resident in that one file Reset Settings This wipes the saved settings in the player and resets all settings to their default values Write cfg file This option writes a cfg file to your player s h...

Page 54: ...3 Method The replaced firmware will host a bootloader and 2 images This is possible by com pression The first is the permanent backup not to be changed any more The second is the default one to be sta...

Page 55: ...ked the flow with exactly these files supplied here starting from the original firmware in flash It worked reliably there s no reason why such low level code should behave different on your box Warnin...

Page 56: ...ep procedure 1 Completely install the Rockbox version you want to have in flash from a full zip distribution including all the plugins etc 2 Back up the current firmware using the first option of the...

Page 57: ...are trying to flash play the ajbrec ajz file Enter the rockbox directory in the file browser you might need to set the FILE VIEW option to ALL FILES Play the rockbox ucl file or rombox ucl if you want...

Page 58: ...can also flash the Archos image as the second one E g in case Rockbox from flash doesn t work for you This way you keep the dual bootloader and you can easily try different later The ucl of the Archo...

Page 59: ...included it starts with Plus On Using that the box can be reprogrammed via serial if the first 2000 bytes of the flash are OK 8 5 10 Download the new flash content file to your box These links are no...

Page 60: ...rst file Rockbox firmware mod ROLO will load the new firmware While Playing Screen wps The new WPS display configuration will be loaded Language File lng Loads a language file Text File txt This will...

Page 61: ...must be noted on their own line B 2 ID3 Info Tag Description ia ID3 Artist ic ID3 Composer id ID3 Album Name ig ID3 Genre Name in ID3 Track Number it ID3 Track Title iv ID3 Version 1 0 1 1 2 2 2 3 2...

Page 62: ...ption fb File Bitrate in kbps fc File Codec e g MP3 or FLAC This tag can also be used in a conditional tag fc mp1 mp2 mp3 wav vorbis flac mpc a52 wavpack alac aac shn aiff unknown The codec order is a...

Page 63: ...Without path or extension pp Playlist Position pr Remaining Time In Song ps Shuffle Shows s if shuffle mode is enabled pt Total Track Time pv Current volume Can also be used in a conditional pv 0 1 2...

Page 64: ...a z and A Z filename filename relative to rockbox and includ ing bmp x x coordinate y y coordinate xl n filename x y Preload an image for later display n image ID a z and A Z filename filename relativ...

Page 65: ...er right If the aligned texts overlap they are merged B 12 Conditional Tags Tag Description xx true false If Else Evaluate for true or false case xx alt1 alt2 alt3 else Enumerations Evaluate for first...

Page 66: ...an accel 0 to 15 seconds antiskip 0 to 7 seconds volume fade on off N A id3 tag priority v2 v1 v1 v2 N A sort case on off N A show files all supported music playlists N A follow playlist on off N A pl...

Page 67: ...0 minutes 15 30 45 60 lang path filename lng N A wps path filename wps N A autocreate bookmarks off on N A autoload bookmarks off on N A use most recent bookmarks off on N A talk dir off number spell...

Page 68: ...rs 11x2 characters none Archos Recorders 112x64 none Archos Ondio 112x64 none Iaudio X5 160x128 128x96 Ipod 4G Gray 160x128 none Ipod 4G Color 220x176 none Ipod 5G Video 320x240 none Ipod Mini 138x110...

Page 69: ...h exact ROM firmware version you have Which exact Rockbox version you are using Menu Info Version A step by step description of what you did and what happened Whether the problem is repeatable or a on...

Page 70: ...is far too slow for this daunting task Archos Multimedia support The Archos Multimedia is a completely different beast It is an entirely differ ent architecture different CPU and upgrading the softwar...

Page 71: ...ay we d need for any good communi cation to work Support other filesystems than FAT32 like NTFS or ext2 or whatever No Rockbox needs to support FAT32 since it can only start off a FAT32 partition sinc...

Page 72: ...D R A F T V E R S I O N APPENDIX F CHANGELOG 72 F Changelog F 1 What s new since v2 5 Changes in version 2 5 THE ROCKBOX MANUAL ARCHOS STUDIO PLAYER...

Page 73: ...D BENJAMIN METZLER FREDERIC DANG NGOC PIERRE DE LORE HUW SMITH GARRETT DERNER BARRY MCINTOSH LESLIE DONALD SON LEE PILGRIM ZAKK ROBERTS FRANCOIS BOUCHER MATTHIAS WIEN TAPPER BRENT COUTTS JENS ARNOLD G...

Page 74: ...LI SHERER FREDRIK O HRN NICOLAS PENNEQUIN RALF HERZ MICHAEL DIFEBBO DAVID ROTHENBERGER ROBERT KEEVIL MARK BRIGHT DOMINIK RIEBELING ALEXAN DER BONDAR PETER CAWLEY RANI HOD TOM ROSS ANTON ROMANOV JEAN L...

Page 75: ...d this License in order to use it for manuals for free software because free software needs free documentation a free program should come with manuals providing the same freedoms that the software doe...

Page 76: ...ograms or for drawings some widely available draw ing editor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatter...

Page 77: ...Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cover and Back Cover Texts on...

Page 78: ...hip of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you fro...

Page 79: ...ces that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the l...

Page 80: ...r documents released under this License and replace the individual copies of this License in the various doc uments with a single copy that is included in the collection provided that you follow the r...

Page 81: ...received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Fo...

Page 82: ...ing LIST THEIR TITLES with the Front Cover Texts being LIST and with the Back Cover Texts being LIST If you have Invariant Sections without Cover Texts or some other combination of the three merge tho...

Reviews: