Index: manual/working_with_playlists/main.tex =================================================================== --- manual/working_with_playlists/main.tex (revision 14604) +++ manual/working_with_playlists/main.tex (working copy) @@ -151,7 +151,7 @@ the track to be moved and confirm with \ActionStdOk. To remove a track, simply select \setting{Remove} in the context menu. -\subsection{Saving playlists} +\subsection{\label{ref:saving_playlists}Saving playlists} To save the current playlist either enter the \setting{Playlist} submenu in the \setting{WPS Context Menu} (see \reference{sec:contextmenu}) and select \setting{Save Current Playlist} or enter the Index: manual/rockbox_interface/main.tex =================================================================== --- manual/rockbox_interface/main.tex (revision 14604) +++ manual/rockbox_interface/main.tex (working copy) @@ -12,11 +12,9 @@ \end{center} -Throughout this manual, the buttons on the \dap{} 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. +This manual refers to the buttons using the names shown in the picture +above. When a button name is preceded by``Long'' it means that you +should press it for approximately 1 second. \blind{ Additional information is available for blind users on the Rockbox website at @@ -342,72 +340,144 @@ } } -\subsection{The first contact} +\subsection{Loading music onto the \dap{}} -After you have first started the \dap{} you'll be presented by the -\setting{Main Menu}. From this menu you can reach every function of Rockbox, -for more information (see \reference{ref:main_menu}). To browse the files -on you \dap{} select \setting{Files} (see \reference{ref:file_browser}), and to -browse in a view that is based on the meta-data\footnote{ID3 Tags, Vorbis -comments, etc.} of your audio files, select \setting{Database} (see -\reference{ref:database}). +To copy music to your \dap{} you have to boot the +manufacturer's firmware as described in \reference{ref:Dualboot} (as +Rockbox does not currently have a USB driver). Rockbox plays many +formats including mp3, aac, flac and ogg (REF??). You can put the files +anywhere you like. For example you could make a top level folder +called "Tunes" and inside that have a folder for each artist, then +inside those a folder for each album which contains all the files for +that album. Finally unplug your player and reboot +to get back to Rockbox. -\subsection{Basic controls} -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 \ActionStdNext{} and \ActionStdPrev{} to move around -the selection. Use \ActionStdOk{} 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 \reference{ref:WPS}. The -dynamic playlist gets replaced with the contents of the current folder. This -way you can easily treat folders 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 \setting{File Browser} stop the playback with the -\ActionWpsStop{} button or return to the file browser while keeping playback -running using \ActionWpsBrowse{}. -In list views you can go back one step with \ActionTreeParentDirectory. +\opt{h10,h10_5gb}{\note{ +If your \dap{} is a MTP model, the Music folder where all your music is stored +may be hidden in the \setting{File Browser}. This may be fixed by either +either changing it's properties (on a computer) to not hidden, or by changing +the \setting{Show Files} setting to all (\reference{ref:ShowFiles}). +}} -\subsection{Basic concepts} -\subsubsection{Playlists} -Rockbox is playlist oriented. This means that every time you play an audio file, -a so-called ``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 don't want to use playlists you can simply play your -files folder based. -Playlists are covered in detail in \reference{ref:working_with_playlists}. +\opt{e200}{\note{ +The \playerman{} firmware always sets the \fname{/MUSIC} folder +to hidden. To see this folder you have to change the \setting{Show Files} +setting to all (\reference{ref:ShowFiles}). +}} -\subsubsection{Menu} -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. -\subsubsection{Context Menu} -Some views, especially the file browser and the WPS have a context menu. -From the file browser this can be accessed with \ActionStdContext{}. -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 folder) that is highlighted by the cursor. From the WPS this is -the currently playing file. Also there are some actions that don't 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. +\subsection{A quick tour} -\section{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 \fname{.cfg} files. This topic -is discussed in more detail in \reference{ref:manage_settings}. -The Rockbox distribution comes with some themes that should look nice on -your \dap{}. \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.} +\subsubsection{Main Menu and File Browser} +The first screen you will see is the \setting{Main Menu}. Move through +the items on the menu using \ActionStdNext{} and \ActionStdPrev{}. Then +use \ActionStdOk{} to select an item. The simplest way to play a file +is to use the \setting{File Browser} by selecting \setting{Files} in the +\setting{Main Menu}, then use \ActionStdOk{} to enter a folder +(\ActionTreeParentDirectory{} goes back to the previous folder or menu). When +you have found the file you want to play, use \ActionStdOk{} to play it. +\subsubsection{WPS} +Once you have selected a file for playing the view switches to the +``While playing screen'' (``WPS'') showing information about the file +and your \dap{}. Use \ActionWpsVolUp{} / \ActionWpsVolDown{} to adjust +the volume and \ActionWpsPlay{} to toggle pause. To go back to the +\setting{File Browser} use \ActionWpsBrowse{} (\ActionWpsStop{} does +the same but also stops playback). Return to the WPS using +\ActionTreeWps{} or by selecting \setting{Now Playing} from the +\setting{Main Menu}. + +\subsubsection{Themes} +Rockbox's default WPS is not very pretty but can be changed easily. +Use \ActionStdMenu{} to get back to the \setting{Main Menu} +and then select \setting{Settings} then \setting{Browse Themes}. +Choose a theme and then use \ActionTreeWps{} to return to the +WPS. There are many more themes on the Internet. \note{Some of the +themes shipped with Rockbox need additional fonts from the fonts +package, so make sure you installed them.} + +\subsubsection{Playlists and Context Menus} +After the file you first selected has finished playing, Rockbox will start +playing the next file in the folder. This happens because when you +select a file to play Rockbox creates a playlist containing all the +files in the folder (called a dynamic playlist). To see the current +playlist go to the \setting{Main Menu} and then select +\setting{Playlists} then \setting{View Current Playlist}. The +playlist can be edited from here. For instance, to remove a song +move down to it and then use \ActionStdContext{} to access the +\setting{Context Menu} and then select \setting{Remove}. + +\note{ +A \emph{context menu} is a menu containing actions that relate to +the highlighted item. So, for an item in a playlist the \setting{Context Menu} +has Remove, Move etc., whereas for a file the \setting{Context Menu} has +Rename, Cut, Paste, Delete etc. +} +\note{ +The WPS also has a context menu (also accessed with \ActionStdContext{}) +which contains shortcuts to frequently +used functions, such as \setting{Sound Settings} (Bass, Treble, EQ etc.) +and \setting{Playlist} functions. +} + +You can add songs to the Current Playlist in many ways. For instance, +to add all the files in a folder you can highlight the folder in the +\setting{File Browser}, use \ActionStdContext{} to access the +\setting{Context Menu} then \setting{Playlist} and \setting{Insert +last}. If you do this while the the \dap{} is playing, the files will +be added onto the end of the dynamic playlist. However, if the \dap{} +is stopped, the new files will replace the dynamic playlist. The +current playlist can also be saved and loaded again later see +\reference{ref:saving_playlists}. + +\subsubsection{Database} +Although you can select music using only the \setting{File Browser}, +you can also browse by categories such as Artist, +Album and Title. To access the categories select \setting{Database} from +the \setting{Main Menu}. The first time you do this Rockbox +will scan your disk for audio files (which can take some time). After +the scan is finished you may be prompted to restart your \dap{} before +you can use the database (see \reference{ref:database}). + +\subsubsection{Other features} + +Rockbox has many other features, a few are: + +\begin{itemize} +\item Playlists can be played shuffled. The quickest way to turn shuffling +on is to access the \setting{Quick Menu} using \ActionStdQuickScreen{} from +the WPS, File or Database Browser (\reference{ref:quick_menu}). + +\item There are many games and applications. These are called Rockbox +``Plugins''. They can be accessed by selecting +\setting{Plugins} from the \setting{Main Menu} (\reference{ref:plugins}). + +\item There is a Sleep timer, from the \setting{Main Menu} select +\setting{System} then \setting{Sleep Timer}. + +\item Playlists saved in the \fname{/PLAYLISTS} folder can be loaded +quickly using the \setting{Playlist Catalog} menu which can be accessed +from the \setting{Playlists} menu or the WPS context menu +(\reference{ref:playlist_catalog}). + +\item Settings can be saved and restored, highlight \setting{Settings} +in the \setting{Main Menu} and use \ActionStdContext{} to access the +\setting{Context Menu}. The settings files are simple text files +and can be edited to include only the particular settings you +need. For instance you could have a settings file for night use +called \fname{night.cfg} containing just: + +\begin{example} + # volume: -45 + # invert: on + # brightness: 1 +\end{example} + +Which lowers the volume and sets the LCD for comfortable night viewing. +See \reference{ref:manage_settings} for more on using \fname{.cfg} files. + +\end{itemize} + \section{Menu overview} \fixme{include an overview of the menu structure here} %\input{rockbox_interface/menu_structure.tex} Index: manual/main_menu/main.tex =================================================================== --- manual/main_menu/main.tex (revision 14604) +++ manual/main_menu/main.tex (working copy) @@ -219,7 +219,7 @@ \nopt{PLAYER_PAD,ONDIO_PAD} { -\section{Quick Menu} +\section{\label{ref:quick_menu}Quick Menu} Whilst not strictly part of the \setting{Main Menu}, it is worth noting that a few of the more commonly used settings are available from the \setting{Quick Menu}.