summaryrefslogtreecommitdiffstats
path: root/manual/working_with_playlists/main.tex
diff options
context:
space:
mode:
Diffstat (limited to 'manual/working_with_playlists/main.tex')
-rw-r--r--manual/working_with_playlists/main.tex109
1 files changed, 52 insertions, 57 deletions
diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex
index d478dcd283..45c57e34b4 100644
--- a/manual/working_with_playlists/main.tex
+++ b/manual/working_with_playlists/main.tex
@@ -17,19 +17,15 @@ playlists:
\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{Current Playlist submenu} (see \reference{ref:currentplaylist_submenu}), you are
+ \setting{Playing Next Submenu} (see \reference{ref:playingnext_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[Play/Add.] In Rockbox, to \setting{Play} or \setting{Add} an item means
+ putting it into a playlist and leaving it there, even after it is
+ played.
-\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.
+\item[Queue.] To \setting{Queue} a song means to put it into a playlist, but then
+ to remove the song from the playlist once it has been played.
\end{description}
\subsection{Creating playlists}
@@ -48,18 +44,18 @@ song.
rather than erasing the current
playlist, see the section below on how to add music to a playlist.}
-\subsubsection{By using the Clear List \& Play Next function}
-The \setting{Clear List \& Play Next} function as described in
-\ref{ref:currentplaylist_submenu} will replace the dynamic playlist with the selected
-tracks. If a track is currently playing, it is only removed once it’s finished
-playing.
-
-\subsubsection{\label{ref:playlist_catalogue}By using the Playlist catalogue}
-The \setting{Playlist catalogue} makes it possible to modify and create
-playlists that are not currently playing. To do this select \setting{Playlist
-catalogue} in the \setting{Context Menu}. There you will have two choices,
-\setting{Add to playlist} adds the selected track or directory to an existing
-playlist and \setting{Add to a new playlist} creates a new playlist containing
+\subsubsection{By using the Play or Play Shuffled functions}
+The \setting{Play} function as described in \ref{ref:playingnext_submenu}
+will replace the dynamic playlist with the selected tracks. The \setting{Play
+Shuffled} function is similar, except the selected tracks will be added to the
+playlist in a random order.
+
+\subsubsection{\label{ref:addtoplaylist_submenu}By using the Add to Playlist submenu}
+The \setting{Add to Playlist submenu} makes it possible to modify and create
+playlists that are not currently playing. To do this select \setting{Add to Playlist...}
+in the \setting{Context Menu}. There you will have two choices,
+\setting{Add to Existing Playlist} adds the selected track or directory to an existing
+playlist and \setting{Add to New Playlist} creates a new playlist containing
the selected track or directory.
\note{All playlists in the \setting{Playlist catalogue} are stored by default
@@ -75,39 +71,39 @@ To create a playlist containing some or all of the music on your \dap{}, you can
\subsection{Adding music to playlists}
-\subsubsection{\label{ref:currentplaylist_submenu}Adding music to a dynamic playlist}
-\screenshot{rockbox_interface/images/ss-playlist-menu}{The Current Playlist Submenu}{}
-The \setting{Current Playlist Submenu} is a submenu in the \setting{Context Menu} (see
+\subsubsection{\label{ref:playingnext_submenu}Adding music to a dynamic playlist}
+\screenshot{rockbox_interface/images/ss-playlist-menu}{The Playing Next Submenu}{}
+The \setting{Playing Next Submenu} is a submenu in the \setting{Context Menu} (see
\reference{ref:Contextmenu}), it allows you to put tracks into a
``dynamic playlist''. The place in which the newly
selected tracks are added to the playlist is determined by these
options:
\begin{description}
-\item [Insert.] Add track(s) after the most recently added tracks or, if tracks
-have not been added yet, immediately after the currently playing track.
+\item [Play Next.] Play track(s) immediately after the currently playing track.
-\item [Insert Next.] Add track(s) immediately after the currently playing track.
+\item [Add.] Add track(s) after the most recently added tracks or, if tracks
+have not been added yet, immediately after the currently playing track.
-\item [Insert Last.] Add track(s) to the end of the playlist.
+\item [Play Last.] Add track(s) to the end of the playlist.
-\item [Insert Shuffled.] Add track(s) to the playlist at random positions.
+\item [Add Shuffled.] Add track(s) to the playlist at random positions.
-\item [Insert Last Shuffled.] Add tracks in a random order to the end of the playlist.
+\item [Play Last Shuffled.] Add tracks in a random order to the end of the playlist.
\end{description}
-If you want the existing playlist entries to first be removed before
-selected tracks are inserted, the following two options will achieve that effect.
-They are also available when playback is stopped, whereas the rest of the options
-require music to be playing or paused.
+If you'd like to replace the current playlist with the new selection, the
+following two options will achieve that effect.
\begin{description}
-\item [Clear List \& Play Next.] Replace all entries in the dynamic playlist with
-selected tracks. If a track is currently playing, it will be removed once it’s
-finished playing.
-
-\item [Clear List \& Play Shuffled.] Similar, except tracks are added in random order.
-Only available when playback is stopped.
+\item [Play.] Replace all entries in the dynamic playlist with the selected
+ tracks. If \setting{Keep Current Track When Replacing Playlist} is set to
+ \setting{Yes}, the new tracks will play after the current track finishes
+ playing; if no track is playing or the setting is \setting{No}, the new
+ tracks will begin playing immediately.
+
+\item [Play Shuffled.] Similar, except the tracks will be added to the new
+ playlist in random order.
\end{description}
Another possibility is to add tracks \emph{temporarily} to the dynamic playlist.
@@ -116,27 +112,26 @@ removed from the playlist after they have been played. They are also not saved
to the playlist file (see \reference{ref:playlistoptions}).
\begin{description}
-\item [Queue.] Corresponds to \setting{Insert}.
+\item [Queue Next.] Corresponds to \setting{Play Next}.
-\item [Queue Next.] Corresponds to \setting{Insert Next}.
+\item [Queue.] Corresponds to \setting{Add}.
-\item [Queue Last.] Corresponds to \setting{Insert Last}.
+\item [Queue Last.] Corresponds to \setting{Play Last}.
-\item [Queue Shuffled.] Corresponds to \setting{Insert Shuffled}.
+\item [Queue Shuffled.] Corresponds to \setting{Add Shuffled}.
-\item [Queue Last Shuffled.] Corresponds to \setting{Insert Last Shuffled}.
+\item [Queue Last Shuffled.] Corresponds to \setting{Play Last Shuffled}.
\end{description}
-\note{You can hide the options to add shuffled tracks or to queue tracks, if you wish.
-The latter can also be put into its own submenu. Simply go to
+\note{Visibility of options to add shuffled tracks or to queue tracks can be toggled by going to
\setting{Settings} $\rightarrow$ \setting{General Settings} $\rightarrow$ \setting{Playlists}
-$\rightarrow$ \setting{Current Playlist} and select either \setting{Show Shuffled Adding Options}
+$\rightarrow$ \setting{Current Playlist}. Select either \setting{Show Shuffled Adding Options}
or \setting{Show Queue Options} to customize the displayed set of options.}
-The \setting{Current Playlist Submenu} can be used to add either single tracks or
-entire directories to a playlist. If the \setting{Current Playlist Submenu} is
+The \setting{Playing Next Submenu} can be used to add either single tracks or
+entire directories to a playlist. If the \setting{Playing Next Submenu} is
invoked on a single track, it will put only that track into the playlist.
-On the other hand, if the \setting{Current Playlist Submenu} is invoked on a
+On the other hand, if the \setting{Playing Next Submenu} is invoked on a
directory, Rockbox adds all of the tracks in that directory to the
playlist.
@@ -157,13 +152,13 @@ were before shutdown.
\subsection{Modifying playlists}
\subsubsection{Reshuffling}
-Reshuffling the current playlist is easily done from the \setting{Playlist}
+Reshuffling the current playlist is easily done from the \setting{Current Playlist}
sub menu in the WPS, just select \setting{Reshuffle}.
\subsubsection{Moving and removing tracks}
To move or remove a track from the current playlist enter the
\setting{Playlist Viewer} by selecting \setting{View Current Playlist} in the
-\setting{Playlist} submenu in the WPS context menu or the \setting{Main Menu}.
+\setting{Current Playlist} submenu in the WPS context menu or the \setting{Main Menu}.
Once in the \setting{Playlist Viewer} open the context menu on the track you
want to move or remove. If you want to move the track, select \setting{Move} in
the context menu and then move the blinking cursor to the place where you want
@@ -171,10 +166,10 @@ the track to be moved and confirm with \ActionStdOk. To remove a track, simply
select \setting{Remove} in the context menu.
\subsection{Saving playlists}
-To save the current playlist either enter the \setting{Playlist} submenu
+To save the current playlist either enter the \setting{Current Playlist} submenu
in the \setting{WPS Context Menu} (see \reference{sec:contextmenu}) and
-select \setting{Save Current Playlist} or enter the
-\setting{Playlist Options} menu in the \setting{Main Menu} and select
+select \setting{Save Current Playlist} or enter the context menu for the
+\setting{Playlist catalogue} in the \setting{Main Menu} and select
\setting{Save Current Playlist}.
Either method will bring you to the \setting{Virtual Keyboard} (see
\reference{sec:virtual_keyboard}), enter a filename for your playlist and