summaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
Diffstat (limited to 'manual')
-rwxr-xr-xmanual/working_with_playlists/main.tex175
1 files changed, 88 insertions, 87 deletions
diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex
index 78079b46f8..2d18924af6 100755
--- a/manual/working_with_playlists/main.tex
+++ b/manual/working_with_playlists/main.tex
@@ -2,98 +2,104 @@
2\label{ref:working_with_playlists} 2\label{ref:working_with_playlists}
3 3
4\section{Introduction} 4\section{Introduction}
5\fixme{This chapter is currently in a half written state, with possible errors.
6 Please help us fix this chapter by submitting additions/corrections to the tracker}
5 7
6\section{Playlist terminology} 8\section{Playlist terminology}
7 9
8Here are some common terms that are used in Rockbox when referring to playlists: 10Here are some common terms that are used in Rockbox when referring to
9 11playlists:
10 \begin{description} 12
11 13\begin{description}
12 \item[Directory:] A playlist! One of the keys to getting the most out of 14
13 Rockbox is understanding that Rockbox \emph{always} considers the song that it 15\item[Directory.] A playlist! One of the keys to getting the most out of
14 is playing to be part of a playlist, and in some situations, Rockbox will 16 Rockbox is understanding that Rockbox \emph{always} considers the song that
15 create a playlist automatically. For example, if you are playing the contents 17 it is playing to be part of a playlist, and in some situations, Rockbox will
16 of a directory, Rockbox will automatically create a playlist containing the 18 create a playlist automatically. For example, if you are playing the
17 songs in that directory. This means that just about anything that is 19 contents of a directory, Rockbox will automatically create a playlist
18 described in this chapter with respect to playlists also applies to 20 containing the songs in that directory. This means that just about anything
19 directories. 21 that is described in this chapter with respect to playlists also applies to
20 22 directories.
21 \item[Dynamic playlist:] A dynamic playlist is a playlist that is created 23
22 ``On the fly.'' Any time you insert or queue tracks using the 24\item[Dynamic playlist.] A dynamic playlist is a playlist that is created
23 \setting{Playlist submenu} (see \reference:{playlist_submenu}), you are creating (or adding 25 ``On the fly.'' Any time you insert or queue tracks using the
24 to) a dynamic playlist. 26 \setting{Playlist submenu} (see \reference:{playlist_submenu}), you are
25 27 creating (or adding to) a dynamic playlist.
26 \item[Insert:] In Rockbox, to \setting{Insert} an item into a playlist means 28
27 putting an item into a playlist and leaving it there, even after it is played. 29\item[Insert.] In Rockbox, to \setting{Insert} an item into a playlist means
28 As you will see later in this chapter, Rockbox can \setting{Insert} into a 30 putting an item into a playlist and leaving it there, even after it is
29 playlist in several places. 31 played. As you will see later in this chapter, Rockbox can \setting{Insert}
30 32 into a playlist in several places.
31 \item[Queue:] In Rockbox, to \setting{Queue} a song means to put the song 33
32 into a playlist and then to remove the song from the playlist once it has been 34\item[Queue.] In Rockbox, to \setting{Queue} a song means to put the song
33 played. The only difference between \setting{Insert} and \setting{Queue} is 35 into a playlist and then to remove the song from the playlist once it has
34 that the \setting{Queue} option removes the song from the playlist once it has 36 been played. The only difference between \setting{Insert} and
35 been played, and the \setting{Insert} option does not. 37 \setting{Queue} is that the \setting{Queue} option removes the song from the
38 playlist once it has been played, and the \setting{Insert} option does not.
39\end{description}
36 40
37\section{Creating playlists} 41\section{Creating playlists}
38 42
39Rockbox can create playlists in four different ways. 43Rockbox can create playlists in four different ways.
40 44
41 \subsection{Creating playlists by playing a song} 45\subsection{Creating playlists by playing a song}
42
43 Whenever a song is selected from the \setting{File Browser} using the
44 \ButtonSelect\ button, Rockbox will automatically create a playlist containing
45 all of the songs in the directory in which that song is located.
46
47 \note{If you already have already created a dynamic playlist, playing a new
48 song will \emph{erase} the current playlist and create a new one. If you want
49 to add a song to the current playlist rather than erasing the current
50 playlist, see the section below on ``Adding music to playlists.''
51
52 \subsection{Creating a dynamic playlist using the Insert and Queue functions}
53
54 \subsection{Creating a playlist using the Playlist Catalog}
55
56 \subsection{Creating a playlist from the Main Menu}
57 46
58\section{Adding music to playlists} 47Whenever a song is selected from the \setting{File Browser} using the
48\ButtonSelect{} button, Rockbox will automatically create a playlist
49containing all of the songs in the directory in which that song is located.
59 50
60 \subsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist} 51\note{If you already have already created a dynamic playlist, playing a new
61 \screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{} 52 song will \emph{erase} the current playlist and create a new one. If you
62 The \setting{Playlist Submenu} allows you to put tracks into a ``dynamic 53 want to add a song to the current playlist rather than erasing the current
63 playlist''. If there is no music currently playing, Rockbox will create a new 54 playlist, see the section below on ``Adding music to playlists.''}
64 dynamic playlist and put the selected track(s) into the playlist. If there is
65 music currently playing, Rockbox will put the selected track(s) into the
66 current playlist. The place in which the newly selected tracks are added to
67 the playlist is determined by the following options:
68 55
69 \begin{description} 56\subsection{Creating a dynamic playlist using the Insert and Queue functions}
70 57
71 \item [Insert:] Add track(s) to playlist. If no other 58\subsection{Creating a playlist using the Playlist Catalog}
72 tracks have been inserted then the selected track will be added immediately 59
73 after current playing track, otherwise they will be added to end of insertion 60\subsection{Creating a playlist from the Main Menu}
74 list. 61
75 62\section{Adding music to playlists}
76 \item [Insert next:] Add track(s) immediately after current playing 63
77 track, no matter what else has been inserted. 64\subsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist}
78 65\screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{}
79 \item [Insert last:] Add track(s) to end of playlist. 66The \setting{Playlist Submenu} allows you to put tracks into a
80 67``dynamic playlist''. If there is no music currently playing, Rockbox will
81 \item [Queue:] Queue is the same as Insert except queued tracks are deleted 68create a new dynamic playlist and put the selected track(s) into the
82 immediately from the playlist after they've been played. Also, queued tracks 69playlist. If there is music currently playing, Rockbox will put the
83 are not saved to the playlist file (see \reference{ref:playlistoptions}). 70selected track(s) into the current playlist. The place in which the newly
84 71selected tracks are added to the playlist is determined by the following
85 \item [Queue next:] Queue track(s) immediately after current playing track. 72options:
86 73
87 \item [Queue last:] Queue track(s) at end of playlist. \end{description} 74\begin{description}
75\item [Insert.] Add track(s) to playlist. If no other tracks have been
76 inserted then the selected track will be added immediately after current
77 playing track, otherwise they will be added to end of insertion list.
78
79\item [Insert next.] Add track(s) immediately after current playing
80 track, no matter what else has been inserted.
81
82\item [Insert last.] Add track(s) to end of playlist.
83
84\item [Queue.] Queue is the same as Insert except queued tracks are
85 deleted immediately from the playlist after they've been played. Also,
86 queued tracks are not saved to the playlist file (see
87 \reference{ref:playlistoptions}).
88
89\item [Queue next.] Queue track(s) immediately after current playing track.
90
91\item [Queue last.] Queue track(s) at end of playlist.
92\end{description}
88 93
89The \setting{Playlist Submenu} can be used to add either single tracks or 94The \setting{Playlist Submenu} can be used to add either single tracks or
90entire directories to a playlist. If the \setting{Playlist Submenu} is 95entire directories to a playlist. If the \setting{Playlist Submenu} is
91invoked on a single track, it will put only that track into the playlist. 96invoked on a single track, it will put only that track into the playlist.
92On the other hand, if the \setting{Playlist Submenu} is invoked on a 97On the other hand, if the \setting{Playlist Submenu} is invoked on a
93directory, Rockbox adds all of the tracks in that directory to the playlist. 98directory, Rockbox adds all of the tracks in that directory to the
99playlist.
94 100
95Dynamic playlists are saved so resume will restore them exactly as they were before 101Dynamic playlists are saved so resume will restore them exactly as they
96shutdown. 102were before shutdown.
97 103
98\section{Saving playlists} 104\section{Saving playlists}
99 105
@@ -101,16 +107,11 @@ shutdown.
101 107
102\section{Helpful Hints} 108\section{Helpful Hints}
103 109
104 \subsection{Including subdirectories in playlists} 110\subsection{Including subdirectories in playlists}
105
106 You can control whether or not Rockbox includes the contents of subdirectories
107 when adding an entire directory to a playlists. Set the \setting{Main Menu
108 $\rightarrow$ Playlist Options $\rightarrow$ Recusively Insert Directories}
109 setting to \setting{Yes} if you would like Rockbox to include tracks in
110 subdirectories as well as tracks in the currently-selected directory.}
111
112
113
114
115
116 111
112You can control whether or not Rockbox includes the contents of
113subdirectories when adding an entire directory to a playlists.
114Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$
115 Recusively Insert Directories} setting to \setting{Yes} if you would like
116Rockbox to include tracks in subdirectories as well as tracks in the
117currently selected directory.