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