Wiki > Main > ManualMainMenu (compare)
Difference: ManualMainMenu (r4 vs. r3)
The main menu is the screen from which the rest of the Rockbox functions can be accessed. It is used for a variety of functions, which are detailed below. You can access the Rockbox main menu by pressing MENU (player/studio version), F1 (recorder version), or A-B (iriver version) key. All options in Rockbox can be controlled via this menu. Some of them can also be found in the Quick Menu (Recorder and iriver versions only).
All settings are persistently stored on the unit. However, Rockbox does not spin up the disk solely for the purpose of saving settings, but instead will save them when it spins up the disk the next time, for example when refilling the audio buffer or navigating through the file browser. Changes to settings may therefore not be saved unless the jukebox is shut down safely.
The Main Menu is structured as follows:
If the 'save a list of recently created bookmarks' option is enabled, you can view a list of several recent bookmarks here and select one to jump straight to that track. This option is 'off' by default.
The volume at which your music is played. Although settable range is 0-100%, many units don't produce audible output below 40%. On Archos Recorders, volume settings above 92% will cause distortion (clipping) and are not recommended.
On iriver, the maximum volume will not be as high as the volume of the original iriver firmware if you engage the bass boost or treble boost. For more information, see this FAQ on the different approach taken by Rockbox and iriver regarding the volume issue.
The Bass setting controls the amount of bass in the track. On Archos players, the bass may be raise or lowered. 0 means that bass sounds are unaltered (flat response). On Iriver players, the bass may be boosted, but not lowered. Bass boost may be set from 0 to 24 dB in increments of 2 dB.
The Treble setting controls higher frequency (treble) sounds in the track. On Archos players, the treble may be raised or lowered. 0 means that treble sounds are unaltered (flat response). On Iriver players, the treble may be boosted, but not lowered. Treble boost may be set from 0 to 8 dB (6dB on iRiver H1xx) in increments of 2 dB.
The Balance control determines whether the sound level is equal in both channels, or 'panned' to either the left or right. The Balance control works by determining how much of the volume is generated by the left or right channel of the sound. The default, 0, means that the left and right outputs are equal in volume. Negative numbers increase the volume of the left channel relative to the right, while positive numbers increase the volume of the right channel relative to the left.
This option controls the on-board mixing facilities of your player. A stereo audio signal consists of two channels, left and right. Available options are:
Note: The above Channel features are available but not confirmed as working yet on iriver.
This option controls the perceived '*width*' of the sound. The larger the value chosen, the '*wider*' the sound seems. If you imagine having two speakers, increasing the Stereo width sounds similar to placing the speakers further apart. The larger the value set, the larger the time difference heard between the left and right channels. The default setting is 100%.
This menu is for configuring settings related to audio playback.
This menu is for configuring settings related to repeating of directories or playlists.
This setting controls what happens when you press PLAY on a file in a directory and shuffle mode is on.
| Yes | The file you selected will be played first.
Sets whether Rockbox will resume playing at the point where you shut off.
Earlier versions of Rockbox had an "Ask" setting, which would ask whether to resume when the jukebox was turned on. This setting has been eliminated because it was redundant. If resume is set to "No," simply pressing PLAY (iriver) (iriver), ON (Archos Studio/Recorder) or On (Archos) MODE (Archos Ondio) will resume from the point where the jukebox was stopped before shutdown.
The smallest step, in seconds, you want to fast forward or rewind in a track. Options are 1, 2, 3, 4, 5, 6, 8, 10, 15, 20, 25, 30, 45, or 60 seconds.
How fast you want search (ffwd/rew) to accelerate when you hold down the button.
iriver H1xx: The iriver series H1xx has options to set doubling of search speed between every 1and 10 seconds, in increment of 1 second.
This setting allows you to control how much music is stored in the player's memory whilst playing a song, acting as a buffer against shock or playback problems.
On Archos, this can be set to a value between 0 and 7 seconds. On the iriver H1xx series, the anti-skip buffer can be set to various values between 5 seconds and 10 minutes.
The player transfers the selected amount of the forthcoming song into its memory at high speed whilst you are playing the song. It keeps a 'rolling' buffer, i.e. keep feeding more of the forthcoming song into memory as it goes along. In the event of the player being knocked, shaken or jogged heavily, Rockbox might not be able to read the hard disk. Rockbox will retry over and over again until it succeeds, but may eventually reach the end of the memory buffer and has to stop playing while waiting for more data from the disk. The anti-skip setting tells Rockbox how much extra buffer memory to spare to handle this situation. This setting therefore allows you to reduce the chances of there being a gap or pause during playback of songs, at the expense of using less memory for the regular buffering.
Having a large anti-skip buffer tends to use more power, and may reduce your battery life. It is recommended to always use the lowest possible setting that allows correct and continuous playback.
This setting enables and disables a fade effect when you pause or stop playing a song.
This setting enables a cross-fader. At the end of a song, the song will fade out as the next song fades in, creating a smooth transition between songs.
The crossfade setting is particularly effective when the player is set on shuffle.
This allows you to set the length of the cross-fade between songs. You can choose between 1,2,4,6,8,10,12 and 14 seconds for the cross-fade duration.
This allows you to control the replaygain function. The purpose of replaygain is to adjust the volume of the played songs so that they are equally loud, to avoid sudden changes in volume when changing between songs recorded at different volume levels. For this to work, the songs must have been processed by a program that adds replaygain information (usually as tags).
This turns on/off the replaygain function.
Avoid clipping of a song's waveform. If a song would clip turing playback, the volume is lowered for that song. Replaygain information is needed for this to work.
Choose the type of replaygain to apply.
This allows you to adjust the volume when replaygain is applied. Replaygain often lowers the volume, sometimes quite much, so here you can compensate for that. Please note that a (large) positive pre-amp setting can cause clipping, unless prevent clipping is enabled. The pre-amp can be set to any decibel (dB) value between -12dB and +12dB, in increments of 0.1dB.
This allows you to set the volume of the beep heard when skipping forward or backward between tracks.
Enable/disable optical SPDIF output.
Choose which ID3 tag to use if both are present.
If set to "Yes," when playback of a playlist or folder ends, Rockbox will create and play a new playlist of the next folder in the browser.
In order for the "Move to Next Folder" option to be effective, the "Repeat" option must be set to "Off."
Once you have reached the last folder on your player, this function will not loop and go back to the first folder again. It therefore only works up until you are in the last folder.
If set to yes, rockbox will track playcount for the runtime DB
This menu deals with options relating to how the file browser displays files.
If this option is enabled, files that start with a lower case letter will appear after the files that start with an upper case letter have all been listed. If disabled, then case will be ignored when sorting files.
This option controls how Rockbox sorts folders.
This option controls how Rockbox sorts files.
Controls which files are displayed in the directory browser.
A useful tutorial can be found on this Mistic River thread.
Determines where you go if you go to the directory browser from the While Playing Screen.
This indicates whether Rockbox will display an icon representing what type a file is on the left of the file in the browser.
Icons are only shown against supported file types.
Browse the fonts that reside in your /.rockbox directory. Selecting one will activate it. See the fonts page for further details about fonts.
Opens the file browser in the /.rockbox directory and displays all .wps files. Selecting one will activate it, stop will exit back to the menu. For further information about the WPS see How to Make a Custom WPS.
This submenu contains settings that relate to the display of the player.
The amount of time the backlight shines after a key press. If set to "Off," the backlight will not light when a button is pressed. If set to "On," the backlight will never shut off. If set to a time (1 to 90 seconds), the backlight will stay lit for that amount of time after a button press.
If set to 'Yes,' the backlight will stay on constantly while the charger cable is connected to a power source.
This option turns the backlight on for 25 seconds on either side of the start of a new track so that the display can be read to see song information.
The amount of time that the backlight will take to fade from off to on after a button is pressed. If set to "Off" the backlight will turn on immediately, with no fade in. Can also be set to 500ms, 1s or 2s.
The amount of time that the backlight will take to fade from on to off after a button is pressed. If set to "Off" the backlight will turn off immediately, with no fade out. Can also be set to 500kms, 1s, 2s, 3s, 4s, 5s or 10s.
Changes the contrast of your LCD display. Warning: Setting the contrast too dark or too light can make it hard to find this menu option again!
This setting lets you invert the colour of the whole screen, so now you get a black background and light text graphics.
Displays the screen so that the top of the display is nearest the buttons. This is sometimes useful when carrying the jukebox on a belt clip, or (on the Recorder) in a pocket for easy access to the headphone socket.
Select this option to have a bar of inverted text ('Bar' option) mark the current line in the File Browser rather than the default arrow to the left ('Pointer' option). This gives slightly more room for filenames.
Controls remote control settings.
Sets the time before the backlight fades out.
Adjust the remote LCD contrast.
Sets the remote LCD to normal or 'inverse' LCD view (white text on black background or vice versa)
Inverts the entire remote screen so it is upside down.
This allows you to set options controlling the scrolling of text on your players display. Text will only scroll if it is too large to fit on the screen, as might be seen with very long song or file names.
You can choose speeds between 0 and 15. The higher your choice, the faster the text will scroll across the screen. How well you can view fast-scrolling text will depend on the resolution of your screen.
This sets how long a delay is seen before text begins to scroll. Settings are between 0 and 2500ms, in increments of 100ms.
This sets how many pixels the text is displaced across the screen each time it scrolls. Options are between 1 and 160. A higher setting will make the scrolling look more jerky, especially if used with small fonts.
When scrolling a line, Rockbox can either scroll continuously to the left or scroll to the left until the end of the line is reached and then back until the beginning of the line is displayed at the left edge again. The Bidirectional Scroll limit determines how much longer than the display the scrolling line has to be, to switch from bidirectional scrolling to continuous scrolling. Setting it to 0% switches off bidirectional scrolling completely.
Allows you to change settings controlling the built in Status and Scroll bars.
This sets whether or not a scroll bar is seen on the left of your player's display if the files listed are too many to fit on the screen.
This sets whether or not a Status bar is seen at the top of your player's display. The Status bar includes a Battery Status and Charging indicator, Volume indicator and Mode (STOP,PLAY, PAUSE) indicator.
Many Custom WPS screens (See this link) require this to be turned off to be viewed correctly.
With the Status Bar turned ON, this allows you to change how the Volume indicator is shown.
With the Status Bar turned ON, this allows you to change how the Battery indicator is shown.
The peak meter can be displayed on the While Playing Screen. The peak meter allows you to view the level of a song being played back using several indicators:
The peak meter has several configurable options.
This determines how fast the bar shrinks when the music becomes softer. Lower values make the peak meter look smoother. Value range is 1 to 126.
Specifies the time after which the peak indicator will reset. If you set this value to 5s, for example, then the peak indicator displays the loudest volume value that occurred within the last 5 seconds. Big values are good if you want to find the peak level of a song, which might be of interest when copying music from the jukebox via the analogue output to some other recording device.
This controls how long the clipping indicator will be visible after clipping is detected.
Determines whether the peak meter displays linear or logarithmic values. In 'dB' (decibel) scale the volume values are scaled logarithmically. This very similar to the perception of loudness. The volume meters of digital audio devices usually are scaled this way. If you are interested in the power level that is applied to your headphones you should choose 'linear' display. Unfortunately this value does not have real units like volts or watts since that depends on the phones. So they can only be displayed as percentage values.
The Minimum of Range and Maximum of Range options define the full value range that the peak meter displays. Recommended values for dbFs are -40 for min. and 0 for maximum. For linear display, use 0 and 100%. Note that -40 dbFs is approximately 1% in linear value, but if you change the minimum setting in linear mode slightly and then change to dbFs there will be a large change. You can use these values for 'zooming' into the peak meter.
On iriver, this is currently fixed on 0% and cannot be changed.
Controls the maximum volume level to display on the Peak Meter. See "Minimum of Range" above.
Controls Bidirectional text display support for use with Hebrew and Arabic languages.
Controls certain system setting for your player.
Options relating to the batteries in the jukebox unit.
Capacity can be used to tell the jukebox what capacity (in mAh) of battery is being used inside it. This value is used for calculating remaining battery life.
Default values are:
These values correspond to the battery shipped with each unit.
For additional information, refer to the Battery FAQ for NiMH batteries or the Battery FAQ for Lithium Ion batteries. Deep discharge (all supported Archos jukeboxes except FM Recorder) This option has been removed in Rockbox 2.5 because the charging algorithm now makes it unnecessary.
Set this to ON if you intend to keep your charger connected for a long period of time. It lets the batteries go down to 10% before starting to charge again. Setting this to OFF will cause the charging to restart on 95%. Trickle Charge (all supported Archos jukeboxes except FM Recorder) This option has been removed in Rockbox 2.5 because the charging algorithm now makes it unnecessary.
The jukebox cannot be turned off while the charger is connected. Therefore, trickle charge is needed to keep the batteries full after charging has completed. For more in depth information about charging see the Battery FAQ for NiMH batteries or the Battery FAQ for Lithium Ion batteries.
Options relating to the hard disk.
Rockbox has a timer that makes it spin down the hard disk after being idle for a certain time. You can modify this timeout here. This idle time is only affected by user activity, like navigating through file browser. When the hard disk spins up to fill mp3 buffer, it automatically spins down afterwards. This can be set to any value between 3s and 254s, in increments of 1s. The higher this Disk Spindown setting, the longer your disk will continue to spin when the drive is not being accessed. This enhances performance, as the disk does not need to start up again before allowing you to continue browsing. However, having a high setting does use more power. Use a lower setting for better battery life, especially if you don't mind waiting a second for the disk to spin up again before the player responds!
This setting controls whether the disk is powered OFF or only set to 'sleep' when spun down. Power off uses less power but takes longer to spin-up.
Currently this option is available for iRiver players only (not in CVS yet). If enabled, player will build a cache from the complete file system structure (including directory and file names) to allow fast browsing inside the file browser without need to wait for the disk to spin up. Rebooting the player is required to turn this option on.
By default on every system boot (or immediately after USB connection) the cache is temporarily disabled and transparent background cache rebuilding is started. However, when this option is turned on no cache resyncing will be done on system boot but the cache is loaded directly from hard disk from the state where it was the player previously was shut off. This means that if user knows for sure he/she is not going to use bootloader USB mode to transfer new files to the hard disk, this option can be set on to skip the cache rebuilding and thus increasing the battery life. There should be no risk of losing data even if the cache is out-of-sync because only file tree browser uses the cache and low level file system functions never uses it directly. On possible error situations the cache is automatically disabled on the fly.
This setting controls time related menu options.
Set current time and date.
Choose 12 or 24 Hour clock.
Rockbox can be configured to turn off power after the unit has been idle for a defined number of minutes. The unit is idle when playback is stopped or paused. It is not idle while the USB or charger is connected, or while recording. Can be set anywhere between 1 and 10s or to 15s, 30s, 45s and 60s. Can also be set OFF.
This option lets you power off your jukebox after playing for a given time. This setting is reset on boot. Using this option disables the Wake up alarm (see below). Can be set between 15 minutes (Displayed as 00:15) up to 5 hours (Displayed as 05:00), in increments of 15 minutes. Can also be set OFF.
This option turns the jukebox off and then starts it up again at the specified time. This is most useful when combined with the Resume on Startup setting set to 'Yes,' so that the jukebox wakes up and immediately starts playing music.
If the jukebox is turned on again before the alarm occurs, the alarm will be canceled.
Using this option disables the Sleep Timer.
This submenu relates to limits in the Rockbox operating system.
Configurable limit of files in the directory browser (file buffer size). You can configure the size to be between 50 and 10000 files in increments of 50 files. The default is 400. Higher values will shorten the music buffer.
Note: the device must be rebooted for settings to take effect!
Option to configure the maximum size of a playlist. The playlist size can be between 1000 and 20000 files in increments of 1000. By default it is 10000. Higher values will shorten the music buffer.
Note: the device must be rebooted for settings to take effect!
This option turns on and off the car ignition auto stop function.
When using the jukebox in a car, car adapter mode automatically stops playback on the jukebox when power (i.e., from cigarette lighter power adapter) to the external DC in jack is turned off. When the external power off condition is detected, the Car Adapter Mode function only pauses the playback. In order to shut down the jukebox completely the Idle Poweroff function must also be set. If power to the DC in jack is turned back on before the Idle Poweroff function has shut the jukebox off, playback will be resumed 5 seconds after the power is applied. This delay is to allow for the time while the car engine is being started. Once the jukebox is shut off either manually, or automatically with the Idle Poweroff function, it must be powered up manually to resume playback.
See here for further information.
This option activates the line in port on Jukebox Player, which is off by default. This is useful for such applications as:
* Game boy -> jukebox -> human * Laptop -> jukebox ->human * LAN party computer -> jukebox -> human
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 same folder have their bookmarks stored together. You can store multiple bookmarks for the same track.
Write a bookmark to the disk whenever the stop key is pressed. If playback is stopped it can be resumed easily at a later time. The Resume function remembers your position in the most recently accessed track regardless of this setting.
When this is on, Rockbox automatically returns to the position of the last bookmark within a file when it is played. If set to Ask, Rockbox will ask the user whether they want to start from the beginning or the bookmark. When set to no, playback always starts from the beginning and the Bookmark file must be played or Load Bookmark selected from the Bookmarks submenu of the Main Menu while the file is playing
If this option is turned on, Rockbox will store a list of Bookmarks that have been accessed recently. This is then accessible from the Recent Bookmarks option of the Bookmarks submenu of the Main Menu.
This setting controls the language of the Rockbox user interface. Select this option to bring up a list of installed languages. Select a language to activate it. The language files must be in the /.rockbox/lang/ directory.
Controls the Voice User Interface, implemented predominantly for blind users, to help in navigating through menus and files. In simple terms, this makes RockBox speak your folder or filenames to you.
This option turns on the Voice User Interface, which will read out menu items and settings as they are selected by the cursor. In order for this to work, a voice file must be present in the /.rockbox/lang/ directory on the recorder. Voice files are large (1.5MB) and are not shipped with Rockbox by default. The voice file is the name of the language for which it is made, followed by the extension .voice. So for English, the file name would be english.voice. This option is ON by default. It will do nothing unless the appropriate .voice file is installed in the correct place on the jukebox.
* Setting the Sound Option Channels to 'karaoke' may disable voice menus. * Plug-ins and the wake up alarm do not support voice features.
'How To' for using Voice Interface
Download Voice Files
This option turns on the speaking of directory names. The jukebox is not powerful enough to produce these voices in real time, so a number of options are available:
This option turns on the speaking of file names. The options are similar to Voice Directories:
See http://www.rockbox.org/twiki/bin/view/Main/VoiceHowto for more details on configuring speech support in Rockbox.
Allows you to load or save system configuration files. On Archos jukeboxes, this menu also allows you to load or save different firmware versions.
Opens the file browser in the /.rockbox directory and displays all .cfg (configuration) files. Selecting one will activate it, stop will exit back to the menu. See the Write .cfg files option on the Manage Settings menu for details of how to save and edit a configuration file.
Resets all configuration settings back to their default values.
This option writes a Rockbox configuration file to your jukebox's hard disk. The configuration file has the ".cfg" extension and is used to store all of the user settings that are described throughout this manual.
A configuration file may reside anywhere on the hard disk. Multiple configuration files are permitted. So, for example, you could have a car.cfg file for the settings that you use while playing your jukebox in your car, and a headphones.cfg file to store the settings that you use while listening to your jukebox through headphones.
The Rockbox configuration file is a plain text file, so once you use the "Write .cfg file" option to create the file, you can edit the file on your computer using any text editor program. Configuration files use the following formatting rules:
* Each setting must be on a separate line. * Each line has the format "setting: value". Values must be within the ranges specified in this manual for each setting. * Lines starting with # are ignored. This lets you write comments into your configuration files.
Configuration files may be loaded using the Browse .cfg files option on the Manage Settings menu.
Configuration files do not need to contain all of the Rockbox options. You can create configuration files that change only certain settings. So, for example, you could create configuration files that control only the bass boost and treble boost functions. Create a few different files with different bass and treble settings, give each file a different name (such as EQ_Normal.cfg, EQ_Bassboost.cfg, etc.), and you can then use the Browse .cfg files option to select EQ presets!
This menu option switches to the radio screen:
Note: FM recording is not yet fully implemented, although initial testing on Iriver using the 'PCM recording' function in the DEBUG menu has been successful (See http://www.misticriver.net/boards/showthread.php?t=27092&highlight=record this topic thread on Mistic River for more information).
The keys are:
The FM radio has the ability to record and to remember station frequency settings (presets). As noted above, preset and recording features are not yet implemented on iriver.
* Saving a preset. You can save your favourite stations in the 32 presets. Press F1 to go to the menu, then select "Save preset". Enter the name (maximum number of characters is 32).
* Selecting a preset. Press F2 to go to the preset list. Use UP and DOWN to move the cursor and then press PLAY to select. Use LEFT to leave the preset without selecting anything.
* Removing a preset. Press F1 to go to the menu, then select "Remove preset".
* Recording. Press F3 to start recording the currently playing station. Press OFF to stop recording. Press PLAY again to seamlessly start recording to a new file. The settings for the recording can be changed in the F1 menu before starting the recording.
Note: On Archos models, the radio will turn off when playing an MP3. As recording is currently implemented on iriver, the radio will continue to play if an audio file is started during radio play. To turn off the radio, return to the radio screen and press STOP.
Despite this not being officialy implemented yet, initial testing of FM (radio) recording on the iriver H1xx series has been successful (See this topic thread on MisticRiver for more information).
The Playlist Options menu allows you to work with playlists. Playlists can either be created automatically by playing a file in a directory directly, which will cause all of the files in that directory to be placed in the playlist, or they can be created by hand using the File Menu or using the Playlist Options menu. Both automatic and manually created playlists can be edited using this menu.
iriver users: See IriverPlaylistInstructions for detailed instructions on creating, editing and saving an on-the-fly playlist.
This option creates 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. If you are in the root directory when you select the 'create playlist' option, Rockbox will create a playlist of all tracks on the player, and that playlist will be place in the root directory.
Displays the contents of the playlist currently stored in memory.
Saves the current dynamic playlist, excluding queued tracks, to the specified file. If no path is provided then playlist is saved to current directory
If set to ON then when you insert/queue a directory in Dynamic Playlist, all subdirectories will also be inserted. If set to ASK then you are prompted about recursive insertion when inserting a directory.
Rockbox features a plug-in concept. Only one plug-in may be running at a time. This menu item allows you to browse the various plug-ins that are available for Rockbox. For more information on which plug-ins are available on each supported platform, please see the Plug In page of the WikiManual.
This option shows MP3 ram buffer size, battery voltage level and estimated time remaining, disk total space and disk free space. On iriver, press UP and DOWN on the joystick to step through several pages of information. On Archos Players use the MINUS and PLUS keys to step through several pages of information.
This is an alternative way to access the ID3 viewer.
Displays some basic system information. This is, from top to bottom, the amount of memory Rockbox has available for storing music (the buffer), battery status, hard disk size and the amount of free space on the disk.
Software version and credits display.
This submenu is intended to be used only by Rockbox developers. It shows hardware, disk, battery status and a lot of other information. It is not recommended that users access this menu unless instructed to do so in the course of fixing a problem with Rockbox. In particular the 'Dump ROM Contents,' 'View/clear RTC RAM' and 'Screenshot' and 'Sound test' functions should be treated with care.
* Return to the Wiki Manual Main Page * Go to the top of this page
MichaelDiFebbo - 23 Aug 2005
(Loaded back into Wiki by EdSolman Sept 2005)
r50 - 19 Mar 2008 - 13:09:35 - MarcGuayRevision r4 - 28 Sep 2005 - 05:31 - LinusNielsenFeltzing
Revision r3 - 23 Sep 2005 - 22:57 - JonasHaeggqvist
Copyright © by the contributing authors.