From 19975102193609212f015f315b1bd96b59250aec Mon Sep 17 00:00:00 2001 From: Michael DiFebbo Date: Mon, 31 Jul 2006 13:08:21 +0000 Subject: This is the beginnings of a chapter for the manual intended to consolidate information about working with playlists into a single chapter, rather than having information spread throughout the manual. Comments welcome. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@10377 a1c6a512-1295-4272-9138-f99709370657 --- manual/working_with_playlists/main.tex | 116 +++++++++++++++++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100755 manual/working_with_playlists/main.tex (limited to 'manual/working_with_playlists') diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex new file mode 100755 index 0000000000..9ea4a0f8a1 --- /dev/null +++ b/manual/working_with_playlists/main.tex @@ -0,0 +1,116 @@ +\chapter{Working with Playlists} +\label{ref:working_with_playlists} + +\section{Introduction} + +\section{Playlist terminology} + +Here are some common terms that are used in Rockbox when referring to playlists: + + \begin{description} + + \item[Directory:] A playlist! One of the keys to getting the most out of + Rockbox is understanding that Rockbox \emph{always} considers the song that it + is playing to be part of a playlist, and in some situations, Rockbox will + create a playlist automatically. For example, if you are playing the contents + of a directory, Rockbox will automatically create a playlist containing the + songs in that directory. This means that just about anything that is + described in this chapter with respect to playlists also applies to + directories. + + \item[Dynamic playlist:] A dynamic playlist is a playlist that is created + ``On the fly.'' Any time you insert or queue tracks using the + \setting{Playlist submenu}\ref:{playlist_submenu}, you are creating (or adding + to) a dynamic playlist. + + \item[Insert:] In Rockbox, to \setting{Insert} an item into a playlist means + putting an item into a playlist and leaving it there, even after it is played. + As you will see later in this chapter, Rockbox can \setting{Insert} into a + playlist in several places. + + \item[Queue:] In Rockbox, to \setting{Queue} a song means to put the song + into a playlist and then to remove the song from the playlist once it has been + played. The only difference between \setting{Insert} and \setting{Queue} is + that the \setting{Queue} option removes the song from the playlist once it has + been played, and the \setting{Insert} option does not. + +\section{Creating playlists} + +Rockbox can create playlists in four different ways. + + \subsection{Creating playlists by playing a song} + + Whenever a song is selected from the \setting{File Browser} using the + \ButtonSelect\ button, Rockbox will automatically create a playlist containing + all of the songs in the directory in which that song is located. + + \note{If you already have already created a dynamic playlist, playing a new + song will \emph{erase} the current playlist and create a new one. If you want + to add a song to the current playlist rather than erasing the current playlist, see the section below on ``Adding music to playlists.'' + + \subsection{Creating a dynamic playlist using the Insert and Queue functions} + + \subsection{Creating a playlist using the Playlist Catalog} + + \subsection{Creating a playlist from the Main Menu} + +\section{Adding music to playlists} + + \subsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist} + \screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{} + The \setting{Playlist Submenu} allows you to put tracks into a ``dynamic + playlist''. If there is no music currently playing, Rockbox will create a new + dynamic playlist and put the selected track(s) into the playlist. If there is + music currently playing, Rockbox will put the selected track(s) into the + current playlist. The place in which the newly selected tracks are added to + the playlist is determined by the following options: + + \begin{description} + + \item [Insert:] Add track(s) to playlist. If no other + tracks have been inserted then the selected track will be added immediately + after current playing track, otherwise they will be added to end of insertion + list. + + \item [Insert next:] Add track(s) immediately after current playing + track, no matter what else has been inserted. + + \item [Insert last:] Add track(s) to end of playlist. + + \item [Queue:] Queue is the same as Insert except queued tracks are deleted + immediately from the playlist after they've been played. Also, queued tracks + are not saved to the playlist file (see page \pageref{ref:playlistoptions}). + + \item [Queue next:] Queue track(s) immediately after current playing track. + + \item [Queue last:] Queue track(s) at end of playlist. \end{description} + +The \setting{Playlist Submenu} can be used to add either single tracks or +entire directories to a playlist. If the \setting{Playlist Submenu} is +invoked on a single track, it will put only that track into the playlist. +On the other hand, if the \setting{Playlist Submenu} is invoked on a +directory, Rockbox adds all of the tracks in that directory to the playlist. + +Dynamic playlists are saved so resume will restore them exactly as they were before +shutdown. + +\section{Saving playlists} + +\section{Loading saved playlists} + +\section{Helpful Hints} + + \subsection{Including subdirectories in playlists} + + You can control whether or not Rockbox includes the contents of subdirectories + when adding an entire directory to a playlists. Set the \setting{Main Menu + $\rightarrow$ Playlist Options $\rightarrow$ Recusively Insert Directories} + setting to \setting{Yes} if you would like Rockbox to include tracks in + subdirectories as well as tracks in the currently-selected directory.} + + \ + + + + + -- cgit v1.2.3