diff options
Diffstat (limited to 'manual/working_with_playlists')
-rwxr-xr-x | manual/working_with_playlists/main.tex | 175 |
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 | ||
8 | Here are some common terms that are used in Rockbox when referring to playlists: | 10 | Here are some common terms that are used in Rockbox when referring to |
9 | 11 | playlists: | |
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 | ||
39 | Rockbox can create playlists in four different ways. | 43 | Rockbox 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} | 47 | Whenever a song is selected from the \setting{File Browser} using the |
48 | \ButtonSelect{} button, Rockbox will automatically create a playlist | ||
49 | containing 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. | 66 | The \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 | 68 | create 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 | 69 | playlist. If there is music currently playing, Rockbox will put the |
83 | are not saved to the playlist file (see \reference{ref:playlistoptions}). | 70 | selected track(s) into the current playlist. The place in which the newly |
84 | 71 | selected tracks are added to the playlist is determined by the following | |
85 | \item [Queue next:] Queue track(s) immediately after current playing track. | 72 | options: |
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 | ||
89 | The \setting{Playlist Submenu} can be used to add either single tracks or | 94 | The \setting{Playlist Submenu} can be used to add either single tracks or |
90 | entire directories to a playlist. If the \setting{Playlist Submenu} is | 95 | entire directories to a playlist. If the \setting{Playlist Submenu} is |
91 | invoked on a single track, it will put only that track into the playlist. | 96 | invoked on a single track, it will put only that track into the playlist. |
92 | On the other hand, if the \setting{Playlist Submenu} is invoked on a | 97 | On the other hand, if the \setting{Playlist Submenu} is invoked on a |
93 | directory, Rockbox adds all of the tracks in that directory to the playlist. | 98 | directory, Rockbox adds all of the tracks in that directory to the |
99 | playlist. | ||
94 | 100 | ||
95 | Dynamic playlists are saved so resume will restore them exactly as they were before | 101 | Dynamic playlists are saved so resume will restore them exactly as they |
96 | shutdown. | 102 | were 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 | ||
112 | You can control whether or not Rockbox includes the contents of | ||
113 | subdirectories when adding an entire directory to a playlists. | ||
114 | Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$ | ||
115 | Recusively Insert Directories} setting to \setting{Yes} if you would like | ||
116 | Rockbox to include tracks in subdirectories as well as tracks in the | ||
117 | currently selected directory. | ||