| % $Id$ % |
| |
| The \setting{\label{ref:PlaybackSettings}Playback Settings} menu allows |
| you to configure settings related to audio playback. |
| |
| \section{Shuffle} |
| Turning shuffle on will cause Rockbox to randomly re-order the |
| playlist. Thus, to shuffle all of the audio files on the player, you first |
| need to create a playlist containing all of them. For more information on |
| creating playlists refer to \reference{ref:working_with_playlists}.\\ |
| Options: \setting{Yes}/\setting{No}. |
| % |
| \section{Repeat} |
| Configures settings related to repeating of directories or playlists.\\ |
| Options: \setting{Off} / \setting{All} / \setting{One} / \setting{Shuffle} / |
| \setting{A-B}: |
| \begin{description} |
| % |
| \item[Off.] The current playlist will not repeat when it is finished. |
| \note{If you have the \setting{Auto-Change Directory} option set to |
| \setting{Yes}, Rockbox will move on to the next directory on your |
| hard drive. If the \setting{Auto-Change Directory} option is set to |
| \setting{No}, playback will stop when the current directory or |
| playlist is finished.} |
| % |
| \item[All.] The current playlist will repeat when it is finished. |
| |
| % |
| \item[One. ]Repeat one track over and over. |
| % |
| \item[Shuffle.] When the current playlist has finished playing, it will |
| be shuffled and then repeated. |
| % |
| \item[A-B.] Repeats between two user defined points within a track, |
| typically used by musicians when attempting to learn a piece of music. |
| This option is more complicated to use than the others as the \dap\ |
| must first be placed into A-B repeat mode and then the start and end |
| points defined.\\ |
| |
| \opt{ab_repeat_buttons}{% |
| To set the Start Point (A) press \ActionWpsAbSetAPrevDir{}. |
| Setting the End Point (B) is done accordingly using |
| \ActionWpsAbSetBNextDir{}. To reset the markers press \ActionWpsAbReset{}. |
| }% |
| \opt{ipod,IAUDIO_X5_PAD,ONDIO_PAD,PLAYER_PAD,PBELL_VIBE500_PAD}{% |
| To set the Start Point (A) press \ActionWpsBrowse{}. The following |
| press of \ActionWpsBrowse{} will set the End Point (B), and a third |
| successive \ActionWpsBrowse{} will reset the markers. |
| }% |
| \end{description} |
| |
| \section{Play Selected First} |
| This setting controls what happens when you |
| select a file for playback while shuffle mode is on. If the |
| \setting{Play Selected First} setting is \setting{Yes}, the file you |
| selected will be played first. If this setting is \setting{No}, a random |
| file in the directory will be played first. |
| |
| \section{Fast-Forward/Rewind} |
| These settings control the speed and acceleration during fast forward and rewind. |
| The setting \setting{FF/RW Min Step} controls the initial speed and \setting{FF/RW Accel} controls the acceleration. |
| |
| \opt{disk_storage}{ |
| \section{\label{ref:AntiSkipBuf}Anti-Skip Buffer} |
| This setting controls how early Rockbox starts refilling the music buffer |
| from the hard drive when playing. A longer Anti-Skip Buffer helps prevent |
| skips in music playback if Rockbox has trouble reading from the disk. |
| This can happen if the \dap{} is knocked, shaken or jogged heavily while |
| Rockbox is trying to read the hard drive. |
| |
| \opt{masd,masf}{ |
| The anti-skip buffer can be set to a value between 0 and 7 |
| seconds.\\ |
| } |
| |
| \opt{swcodec}{ |
| The anti-skip buffer can be set to various values between |
| 5 seconds and 10 minutes.\\ |
| } |
| |
| \note{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.} |
| } |
| |
| \section{Fade on Stop/Pause} |
| Enables and disables a fade effect when you |
| pause or stop playing a song. If the Fade on Stop/Pause option is |
| set to \setting{Yes}, your music will fade out when you stop or pause |
| playback, and fade in when you resume playback. |
| |
| \section{Party Mode} |
| Enables unstoppable music playback. When new songs are |
| selected, they are queued at the end of the current dynamic playlist |
| instead of being played immediately. Pausing and stopping playback is |
| disabled as well as skipping songs and launching plugins. |
| |
| \opt{swcodec}{ |
| \opt{crossfade}{ |
| \section{Crossfade} |
| This section controls the behavior of the crossfader. The crossfader, when |
| enabled, smoothly fades one track into the next. This can occur in two |
| situations: an automatic track change or a manual track skip. An automatic |
| track change occurs at the end of the track, moving to the next track in the |
| playlist without user intervention. A manual track skip goes to the next |
| track immediately when the appropriate button is pressed.\\ |
| |
| Options for crossfade settings are: |
| \begin{description} |
| \item[Enable Crossfade.] If set to \setting{Off}, crossfade is disabled |
| and all track changes are gapless. If set to |
| \setting{Automatic Track Change Only}, crossfade occurs for automatic |
| track changes, but not for manual track skips. The next setting, |
| \setting{Manual Track Skip Only}, is the opposite: tracks will only |
| crossfade when manually skipped. If set to \setting{Shuffle}, crossfade |
| is enabled for all track changes, automatic or manual, when the shuffle |
| feature is set to \setting{Yes}, but disabled otherwise. If set to |
| \setting{Shuffle or Manual Track Skip} then crossfade will be active |
| either when shuffle is set to \setting{Yes} or the track is manually |
| skipped. If set to \setting{Always}, tracks will always crossfade into |
| one another. |
| % |
| \item[Fade In Delay.] The ``fade in delay'' is the length of time between |
| when the crossfade process begins and when the new track begins to fade |
| in. |
| % |
| \item[Fade In Duration.] The length of time, in seconds, that it takes |
| your music to fade in once the \setting{Fade In Delay} has ended. |
| % |
| \item[Fade Out Delay.] The ``fade out delay'' is the length of time |
| between when the crossfade process begins and when the old track begins |
| to fade out. |
| % |
| \item[Fade Out Duration.] The length of time, in seconds, that it takes |
| your music to fade out once the \setting{Fade Out Delay} has ended. |
| % |
| \item[Fade Out Mode.] If set to \setting{Crossfade}, one song will fade |
| out and the next song will simultaneously fade in. If set to |
| \setting{Mix}, the ending song will not fade out at all, and will |
| continue to play as normal until its end with the starting song fading |
| in from under it. \setting{Mix} mode is not used for manual track skips, |
| even if it is selected here. |
| \end{description} |
| |
| \note{The rules above apply except in the instance where |
| \setting{Fade Out Delay} plus \setting{Fade Out Duration} is less then |
| \setting{Fade In Delay} (which would create a gap in the audio). In this case, |
| the \setting{Fade In Delay} is reduced to eliminate the gap.\\} |
| |
| The graphic below illustrates how the different settings work in practice. |
| |
| \includegraphics[width=14cm]{configure_rockbox/images/crossfade_graphic.png} |
| }%\opt{crossfade} |
| |
| \section{\label{ref:ReplayGain}Replaygain} |
| This allows you to control the replaygain function. |
| The purpose of replaygain is to adjust the volume of the music played |
| so that all songs (or albums, depending on your settings) have the |
| same apparent volume. This prevents sudden changes in volume when |
| changing between songs recorded at different volume levels. |
| For replaygain to work, the songs must have been processed by a program |
| that adds replaygain information to the ID3 tags (or Vorbis tags).\\ |
| |
| Options for replaygain are: |
| \begin{description} |
| \item[Replaygain Type.] Choose the type of replaygain to apply: |
| \begin{description} |
| \item[Album Gain.] Maintain a constant volume level between |
| albums, but keep any intentional volume variations between |
| songs in an album. (If album gain value is not available, |
| uses track gain information). |
| % |
| \item[Track Gain.] Maintain a constant volume level between |
| tracks. If track gain value is not available, no replaygain |
| is applied. |
| % |
| \item[Track Gain If Shuffling.] Maintains a constant volume |
| between tracks if \setting{Shuffle} is set to \setting{Yes}. |
| Reverts to album mode if \setting{Shuffle} is set to \setting{No}. |
| % |
| \item[Off.] Do not process replaygain information, i.e. turn off |
| the replaygain function. |
| \end{description} |
| % |
| \item[Prevent Clipping.] Avoid clipping of a song's waveform. |
| If a song would clip during playback, the volume is lowered for |
| that song. Replaygain information is needed for this to work. |
| % |
| \item[Pre-amp.] 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 -12~dB and +12~dB, in increments of 0.5~dB. |
| \end{description} |
| |
| \section{Track Skip Beep} |
| Controls the volume of the beep that is heard when |
| skipping forward or backward between tracks. The beep is disabled when |
| set to \setting{Off}. |
| }%\opt{swcodec} |
| |
| \opt{spdif_power}{ |
| \section{\label{ref:SPDIF_OnOff}Optical Output} |
| Enables or disables the optical S/PDIF output to |
| allow a digital connection to a suitable external decoder. To enable |
| optical output, set to \setting{Yes} |
| } |
| |
| \section{Auto-Change Directory} |
| Control what Rockbox does when it reaches the end |
| of a directory. If \setting{Auto-Change Directory} is set to \setting{Yes}, |
| Rockbox will continue to the next directory. If |
| \setting{Auto-Change Directory} is set to \setting{No}, playback will stop at |
| the end of the current playlist. Using the \setting{Random} feature requires |
| you to first generate a folder list via the Random Folder Advance Configuration |
| plugin (see \reference{ref:random_folder_advance_config}).\\ |
| |
| \note{You must have the \setting{Repeat} option set to \setting{No} for |
| \setting{Auto-Change Directory} to function properly.\\} |
| |
| \note{This feature only works when songs have been played from the file |
| browser. Using it with the database may cause unexpected behaviour.} |
| % |
| |
| \section{\label{ref:ConstrainAutoChange}Constrain Auto-Change} |
| If enabled and you have set \setting{Start File Browser Here} to a directory |
| other than root, \setting{Auto-Change Directory} will be constrained to the |
| directory you have chosen and those below it. |
| See \reference{ref:StartFileBrowserHere}. |
| % |
| |
| \opt{headphone_detection}{ |
| \section{Pause on Headphone Unplug} |
| Enables and disables automatic pausing of |
| playback when the headphones are disconnected from the \daps{} headphone |
| socket. |
| % |
| \begin{description} |
| \item[Pause on Headphone Unplug.] Options for automatic pause: |
| \begin{description} |
| \item[Off.] Disables automatic pause. |
| % |
| \item[Pause.] Pauses the \dap{} when the headphones are removed. |
| % |
| \item[Pause and Resume.] Pauses when the headphones are removed, and |
| resumes playback when they are reconnected. |
| \end{description} |
| % |
| \item[Disable Auto-Resume If Phones Not Present.] This option will disable |
| the automatic resumption of playback at startup if the headphones are not |
| connected to the \dap{}. |
| \note{This requires \setting{Resume on Startup} to be enabled.} |
| \end{description} |
| |
| }% |
| |
| \section{Last.fm Log}\index{Last.fm Log}\index{Audioscrobbler|see{Last.fm Log}} |
| Enables logging of your played tracks for submittal to |
| \url{http://www.last.fm}. This service was formerly known as |
| \emph{Audioscrobbler}. When you enable this option, you'll have to reboot to |
| start the logging. The log-file is called |
| \opt{rtc}{\fname{.scrobbler.log},}% |
| \nopt{rtc}{\fname{.scrobbler-timeless.log},}% |
| and is to be found in the root directory of your \dap{}.\\ |
| |
| \note{See \wikilink{LastFMLog} for a further description, and for tools you |
| can use to submit your Last.fm log.} |
| |
| \section{Cuesheet Support}\index{Cuesheet Support} |
| Enables reading of cuesheet files for played tracks. If a cuesheet is found |
| for a track, track markers are displayed on the progressbar and it is |
| possible to skip between the tracks within the cuesheet. Also the information |
| found in the cuesheet file will replace the information from the ID3 tags. |
| When you enable this option, you'll have to reboot for it to come into |
| effect. |
| |
| Cuesheet files should have the same file name as the audio file they |
| reference, except with the extension \fname{.cue}. This file can either |
| reside in the same directory as the audio file (checked first), or within the |
| \fname{.rockbox/cue} directory. |
| |
| The contents of a cuesheet file can also be embedded within the metadata of |
| an audio file. There is currently support for the FLAC tag/ Vorbis comment |
| \emph{CUESHEET} or the ID3v2 \emph{TXXX CUESHEET} tag. |
| |
| \section{Skip Length}\index{Skip Length} |
| Designed to speed up navigation when listening to long audio tracks, |
| \setting{Skip Length} changes the behaviour of |
| the \ActionWpsSkipPrev{} and \ActionWpsSkipNext{} buttons so that they skip |
| by a given time instead of skipping to a new track. |
| The \setting{Skip to Outro} option changes the behaviour so that the buttons |
| skip to just before the end of the track, so that the last few seconds are |
| played before the next track. |
| |
| \section{Prevent Track Skipping}\index{Prevent Track Skipping} |
| If this option is enabled, the ability to manually skip tracks is disabled |
| in order to avoid accidental track skips. It does not prevent changing tracks |
| if a track ends, which can be achieved by combining this option with |
| \setting{Repeat} set to \setting{One} |
| |
| \opt{swcodec}{ |
| \section{Rewind Before Resume}\index{Rewind Before Resume} |
| When restarting a track or a bookmark, a short rewind can be done before the |
| playback is started. This can be useful when listening to speech material, |
| to help remember what was being said just before playback was stopped. |
| The size of the rewind can be set to various values between 0 (off) and |
| 60 seconds. |
| \note{This option does not apply to resuming a paused track. Use |
| the next option for rewinding on pause.} |
| \note{The actual rewind distance may differ a little from the requested |
| value, depending on the file in question.} |
| }%\opt{swcodec} |
| |
| \section{Rewind on Pause}\index{Rewind on Pause} |
| This option rewinds the current track by a small amount whenever it is |
| paused (not stopped). The amount to rewind can be set between 0 and |
| 15 seconds. |