rockbox/manual/main_menu/main.tex

\chapter{The Main Menu}

\section{Introducing the Main Menu}
\screenshot{main_menu/images/ss-main-menu-\genericimg.png}{The main menu}{}
This 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. 
All options in Rockbox can be controlled via this menu.

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 MP3 buffer or navigating through the file browser. Changes to 
settings may therefore not be saved unless the \dap\ is shut down safely 
(see page \pageref{ref:Safeshutdown}).

\section{Navigating the Main Menu}
\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD}{
  \begin{center}
    \begin{tabularx}{\textwidth}{lX}\toprule
      \textbf{Key} & \textbf{Action} \\\midrule
      \opt{IPOD_4G_PAD}{\ButtonScrollFwd}
      \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonUp} 
      & Moves up in the menu. Inside a setting, increases the value or 
        chooses next option \\
      %
      \opt{IPOD_4G_PAD}{\ButtonScrollBack}
      \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonDown} 
      & Moves down in the menu. Inside a setting, decreases the value or 
        chooses previous option \\
      %
      \opt{RECORDER_PAD}{\ButtonPlay/\ButtonRight}
      \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonSelect/\ButtonRight}
      \opt{ONDIO_PAD,IPOD_4G_PAD}{\ButtonRight} 
      & Selects option \\
      %
      \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff/\ButtonLeft}
      \opt{IAUDIO_X5_PAD,ONDIO_PAD,IPOD_4G_PAD}{\ButtonLeft} 
      & Exits menu, setting or moves to parent menu\\
      \bottomrule
    \end{tabularx}
  \end{center}
}
\opt{PLAYER_PAD}{
  \begin{center}
    \begin{tabularx}{\textwidth}{lX}\toprule
      \textbf{Key} & \textbf{Action} \\\midrule
      %
      \ButtonLeft  & Selects previous option in the menu. Inside an setting, 
                     decreases the value or chooses previous option \\
      %
      \ButtonRight & Selects next option in the menu. Inside an setting 
                     increases the value or chooses next option \\
      %
      \ButtonPlay  & Selects item \\
      %
      \ButtonStop  & Exit menu, setting or moves to parent menu. \\
      \bottomrule
    \end{tabularx}
  \end{center}
}

\section {Recent Bookmarks}
\screenshot{main_menu/images/ss-list-bookmarks-\genericimg.png}%
  {The list bookmarks screen}{}
If the ``save a list of recently created bookmarks'' option is enabled 
then you can view a list of several recent bookmarks here and select one to 
jump straight to that track.  This option is off by default. See page 
\pageref{ref:Bookmarkconfigactual} for more details on configuring bookmarking
in Rockbox.

\section{Sound Settings}
The Sound Settings menu offers a selection of sound properties you may 
change to customize your listening experience.  The details of this menu are 
covered in detail starting on page \pageref{ref:configure_rockbox_sound}. 

\section{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 
starting on page \pageref{ref:configure_rockbox_general}. 

\section{Manage Settings}
    \fixme{TODO: fill out some text for this section}

\section{Browse Themes}
    \fixme{TODO: fill out some text for this section}
      
\opt{CONFIG_TUNER}{
  \section{\label{ref:FMradio}FM Radio \opt{ondio}{ - OndioFM Only}}  
  \screenshot{main_menu/images/ss-fm-radio-screen-\genericimg.png}%
    {The FM radio screen}{}
  
  \opt{recorderv2fm,ondio}{
    This menu option switches to the radio screen.
    
    The keys are:
    \begin{table}[h!]
      \begin{center}
        \begin{tabularx}{\textwidth}{lX}\toprule
          \textbf{Button}   & \textbf{Function} \\\midrule
          \ButtonLeft, \ButtonRight 
          & Change frequency in 0.1 MHz steps.\\
          & For automatic station seek, hold \ButtonLeft/\ButtonRight\ 
            for a little longer. \\
          %
          \ButtonUp, \ButtonDown    
          & Change volume \\
          %
          \opt{RECORDER_PAD}{
            \ButtonPlay      & \textbf{(EXPERIMENTAL)}\\
            & freezes all screen updates.May enhance radio reception
              in some cases.\\
            %
          }
          \opt{RECORDER_PAD}{\ButtonOn}\opt{ONDIO_PAD}{FixMe}
          & Leave the radio screen with the radio playing \\
          %
          \ButtonOff         & Back to main menu \\\bottomrule
        \end{tabularx}
      \end{center}
    \end{table}
  }
  
  \opt{h1xx,h300,x5}{
    This menu option switches to the radio screen.
    
    The keys are:
    \begin{table}[h!]
      \begin{center}
        \begin{tabularx}{\textwidth}{lX}\toprule
          \textbf{Button} & \textbf{Function} \\\midrule
          \ButtonLeft, \ButtonRight & Change frequency in 0.1 MHz steps. \\
          Hold \ButtonLeft, \ButtonRight 
                             & Seeks to next station or preset\\
          %
          \ButtonUp, \ButtonDown 
                             & Change volume \\
          %
          \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
          \opt{IAUDIO_X5_PAD}{FixMe}
                             & Mutes radio playback \\
          %
          \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{Hold \ButtonOn}
          \opt{IAUDIO_X5_PAD}{FixMe}
          & Switches between SCAN and PRESET mode.\\
          %
          \ButtonSelect      & Opens a list of radio presets. You can view 
                               all the presets that you have, and switch to 
                               the station.\\
          Hold \ButtonSelect & Displays the FM radio settings menu.\\
          %
          \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
          \opt{IAUDIO_X5_PAD}{FixMe}
          %
                             & Keeps radio playing and returns to the main
                               menu. You can then press OFF/STOP to browse 
                               the file tree while listening to the radio\\
          %
          \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
          \opt{IAUDIO_X5_PAD}{FixMe}
                             & Stops the radio and returns to main menu \\\bottomrule
        \end{tabularx}
      \end{center}
    \end{table}
  }
  
The FM radio has the ability \opt{HAVE_RECORDING}{to record and } to
remember station frequency settings (presets).
  
  \begin{description}
    
  \item[Saving a preset:]
    Up to 32 of your favourite stations can be saved as presets. 
    Press
    \opt{RECORDER_PAD}{\ButtonFOne}
    \opt{ONDIO_PAD}{\ButtonMenu}
    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonSelect}
    to go to the menu, then select 
    \opt{recorderv2fm,ondio}{``Save preset''.}
    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{``Add preset''}
    Enter the name (maximum number of characters is 32). 
    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{Press \ButtonOn\ to save.}
    \opt{IAUDIO_X5_PAD}{Press FixMe to save.}
    
  \item[Selecting a preset:]
    \opt{ONDIO_PAD,RECORDER_PAD}
       {         
         Press \opt{RECORDER_PAD}{\ButtonFTwo}\opt{ONDIO_PAD}{(FixMe)} 
         to go to the preset list. Use \ButtonUp\ and \ButtonDown\ to 
         move the cursor and then press 
         \opt{RECORDER_PAD}{\ButtonPlay}\opt{ONDIO_PAD}{(Insert Correct Key)} 
         to select. Use \ButtonLeft\ to leave the preset without selecting
         anything.
       }
     \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}
        {
          Press \ButtonSelect\ to go to the preset list. 
          Use \ButtonUp\ and \ButtonDown\ to move the cursor and then 
          press \ButtonSelect\ to select. Use \ButtonLeft\ to leave the
          preset without selecting anything.
        }
            
  \item[Removing a preset:]
     \opt{ONDIO_PAD,RECORDER_PAD}{
        Press \opt{RECORDER_PAD}{\ButtonFOne}\opt{ONDIO_PAD}{(Insert Correct Key)}
        to go to the menu, then select ``Remove preset''.
      }
      \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{
        Press \ButtonSelect\ to go to the preset list. Use \ButtonUp\ 
        and \ButtonDown\ to move the cursor and then Hold \ButtonSelect\ 
        on the preset to that you wish to remove, then select ``Remove preset.''
      }
     
      \opt{RECORDER_PAD}{
          \item[Recording:]
            Press \ButtonFThree\ to start recording the currently playing 
            station. Press \ButtonOff\ to stop recording. Press \ButtonPlay\ 
            again to seamlessly start recording to a new file. The settings
            for the recording can be changed in the \ButtonFOne\ menu before
            starting the recording. See page \pageref{ref:Recordingsettings} 
            for details of recording settings.
          }
  \end{description}
  \note{The radio will turn off when starting playback of an audio file.}
}

\opt{HAVE_RECORDING}{
  \section{\label{ref:Recording}Recording}
  \subsection{\label{ref:Whilerecordingscreen}While Recording Screen}
  \screenshot{main_menu/images/ss-while-recording-screen-\genericimg.png}%
    {The while recording screen}{}
  Entering the ``Recording'' option in the Main menu launches the recording 
application. The screen shows the time elapsed and the size of the file being 
recorded. A peak meter is present to allow you set Gain correctly. 
\opt{MASCODEC}{The frequency, channels and quality} 
\opt{SWCODEC}{The frequency and channels} settings are shown on the last line.
  
  The controls for this screen are:
  
  \begin{table}[htb!]
    \begin{center}
      \begin{tabularx}{\textwidth}{lX}\toprule
        \textbf{Button} & \textbf{Function} \\\midrule
        \ButtonLeft & Decreases Gain \\
        %
        \ButtonRight & Increases Gain \\
        %
        \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn}
        \opt{ONDIO_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD}{FixMe} & Starts recording.  \\
        & While recording: button closes the current file and opens a new one.\\
        %
        \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff} 
        \opt{ONDIO_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD}{FixMe} & Exits Recording Screen.\\
        & While recording: Stop recording \\
        %
        \opt{RECORDER_PAD}{\ButtonFOne}
        \opt{ONDIO_PAD}{\ButtonMenu}
        \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IAUDIO_X5_PAD}{Hold \ButtonSelect} 
        & Opens Recording Settings screen (see below) \\
        %
        \opt{RECORDER_PAD}{
          \ButtonFTwo & Quick menu for recording settings. A quick press will 
          leave the screen up (press {\ButtonFTwo} again to exit),while holding 
          it will close the screen when you release it. \\
        }
        %
        \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IAUDIO_X5_PAD}{
          \ButtonSelect & Quick menu for recording settings. \\
        }
        %
        \opt{RECORDER_PAD}{
          \ButtonFThree & Quick menu for source setting. \\
          & Quick/hold works as for {\ButtonFTwo}. \\
          & While recording: Start a new recording file \\
        }
        \bottomrule
      \end{tabularx}
    \end{center}
  \end{table}
  
  \subsection{\label{ref:Recordingsettings}Recording Settings}
  \screenshot{main_menu/images/ss-recording-settings-\genericimg.png}%
    {The recording settings screen}{}
  \opt{MASCODEC}{
    \begin{description}
    \item[Quality:]
      Choose the quality here (0 to 7). Default is 5, best quality is 7, 
      smallest file size is 0. This setting effects how much your sound 
      sample will be compressed. Higher quality settings result in larger 
      MP3 files.
      
      The quality setting is just a way of selecting an average bit rate, 
      or number of  bits per second, for a recording.  When  this setting 
      is lowered, recordings are compressed more (meaning worse sound quality), 
      and the average bitrate changes as follows.
    \end{description}
    
    \begin{table}[h!]
      \begin{center}
        \begin{tabularx}{\textwidth}{lX}\toprule
          \textbf{Frequency} & \textbf{Bitrate}  (Kbit/s) {}- quality 0$\rightarrow$7 \\\midrule
          44100Hz stereo        & 75, 80, 90, 100, 120, 140, 160, 170 \\
          22050Hz stereo        & 39, 41, 45, 50,  60,  80,  110, 130 \\
          44100Hz mono          & 65, 68, 73, 80,  90,  105, 125, 140 \\
          22050Hz mono          & 35, 38, 40, 45,  50,  60,  75,  90 \\\bottomrule
        \end{tabularx}
      \end{center}
    \end{table}
  }
  \begin{description}
  \item[Frequency:]
    Choose the recording frequency (sample rate) -- 48kHz, 44.1kHz, 32kHz 
    (MPEG version 1), and 24kHz, 22.05kHz, 16kHz (MPEG version 2) are available.
    Higher sample rates use up more disk space, but give better sound quality. 
    This setting determines which frequency range can accurately be reproduced
    during playback. Lower frequencies produce smaller files, for two reasons.
    The amount of data to be compressed is smaller and the data is easier to
    compress, since higher frequencies are not present. 
    \opt{MASCODEC}{The frequency setting also determines which version 
      of the MPEG standard sound is recorded using.}
    
  \item[Source:]
    Choose the source of the recording. This can be microphone, line in, 
    \fixme{or SPDIF (digital). -- show this only when device has digital in!} 
    \opt{CONFIG_TUNER}{For recording from the radio see page 
       \pageref{ref:FMradio}.}
    
    \note{You cannot change the sample rate for digital recordings.}
    
  \item[Channels:]
    This allows you to select mono or stereo recording. Please note that 
    for mono recording, only the left channel is recorded.  Mono recordings
    are usually somewhat smaller than stereo.
    
  \item[Independent Frames:]
    The independent frames option tells the \dap to encode with the bit
    reservoir disabled, so the frames are independent of each other. This
    makes a file easier to edit.
    
  \item[Time Split:]
    This option is useful when timing recordings. If set to active it stops 
    a recording at a given interval and then starts recording again with a 
    new file, which is useful for long term recordings.
    \newline
    The splits are seamless (frame accurate), no audio is lost at the split 
    point. The break between recordings is only the time required to stop
    and restart the recording, on the order of 2-4 seconds.
    \newline
    Options (hours:minutes between splits): off, 24:00, 18:00, 12:00, 10:00, 
    8:00, 6:00, 4:00, 2:00, 1:20 (80 minute CD), 1:14 (74 minute  CD), 1:00, 
    00:30, 00:15, 00:10, 00:05.
    
  \item[Prerecord Time:]
    This setting buffers a small amount of audio so that when the record button 
    is pressed, the recording will begin from that number of seconds earlier.
    This is useful for ensuring that a recording begins before a cue that is
    being waited for.\\
    Options: Off, 1-30 seconds
    
  \item[Directory:]
    Allows changing the location where the recorded files are saved. The
    default location is \fname{/recordings}.
    
  \item[Show recording screen on startup:]
    If set to yes, the \dap\ will start up with the while recording screen showing.\\
    Options: Yes, No\\
    
  \item[Clipping Light:]
    Causes the backlight to flash on when clipping has been detected.\\
    Options: Off, Remote unit only, Main and remote unit, Main unit only.
    
  \end{description}
}
 
\section{\label{ref:playlistoptions}Playlist Options}
This 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 (see page \pageref{ref:Filemenu}) or using 
the Playlist Options menu.  Both  automatic and manually created playlists 
can be edited using this menu.

\begin{description}
\item[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.
  
\item[View Current Playlist:]
  Displays the contents of the playlist currently stored in memory.
  
\item[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 
directory (see page \pageref{ref:Playlistsubmenu}).
  
\item[Recursively Insert Directories:]
  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.
\end{description}

\section{Browse Plugins}
With this option you can load and run various plugins that have been 
written for Rockbox.A detailed description of the different plugins begins 
on page \pageref{ref:plugins}.

\section{\label{ref:Info}Info}
This option shows RAM buffer size, battery voltage level and estimated time 
remaining, disk total space and disk free space.
\opt{player}{Use the MINUS and PLUS keys to step through several 
pages of information.}

\begin{description}
\item[Rockbox Info:]
  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.
  
\item[Version:]
  Software version and credits display.
  
\item[Debug (Keep Out!):]
  This submenu is intended to be used \emph{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.
\end{description}

\opt{player}{
  \section{Shutdown}
  This menu option saves the Rockbox configuration and turns off the hard 
  drive before shutting down the machine. For maximum safety this procedure 
  is recommended when turning off the Jukebox. (There is a very small risk
  of hard disk corruption otherwise.) See page \pageref{ref:Safeshutdown}
  for more details.
}