diff options
author | Nils Wallménius <nils@rockbox.org> | 2006-10-13 16:19:30 +0000 |
---|---|---|
committer | Nils Wallménius <nils@rockbox.org> | 2006-10-13 16:19:30 +0000 |
commit | 2239bbab047d294cce7b9f44db19a77a3ab4dc0d (patch) | |
tree | b8db7d800f70c822ad091dae6e966c4063fa4045 /manual/working_with_playlists/main.tex | |
parent | 1c3d89c35ea711a2347ebdce65d7e3a0e870367e (diff) | |
download | rockbox-2239bbab047d294cce7b9f44db19a77a3ab4dc0d.tar.gz rockbox-2239bbab047d294cce7b9f44db19a77a3ab4dc0d.zip |
Added instructions on how to save a playlist in the new working with playlists section and made some minor cleanup (removed trailing spaces and tabs, broke long lines etc.) fixed a reference in the quickstart.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@11215 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual/working_with_playlists/main.tex')
-rwxr-xr-x | manual/working_with_playlists/main.tex | 136 |
1 files changed, 72 insertions, 64 deletions
diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex index 45579ec275..fdc94eff1f 100755 --- a/manual/working_with_playlists/main.tex +++ b/manual/working_with_playlists/main.tex | |||
@@ -1,52 +1,52 @@ | |||
1 | \section{Working with Playlists} | 1 | \section{\label{ref:working_with_playlists}Working with Playlists} |
2 | \fixme{This section is currently in a half written state, with possible errors | 2 | \fixme{This section is currently in a half written state, with possible errors |
3 | and a lot of stuff missing. Please help us fix this chapter by submitting | 3 | and a lot of stuff missing. Please help us fix this chapter by submitting |
4 | additions/corrections to the tracker} | 4 | additions/corrections to the tracker} |
5 | 5 | ||
6 | \subsection{Playlist terminology} | 6 | \subsection{Playlist terminology} |
7 | Some common terms that are used in Rockbox when referring to | 7 | Some common terms that are used in Rockbox when referring to |
8 | playlists: | 8 | playlists: |
9 | 9 | ||
10 | \begin{description} | 10 | \begin{description} |
11 | \item[Directory.] A playlist! One of the keys to getting the most out of | 11 | \item[Directory.] A playlist! One of the keys to getting the most out of |
12 | Rockbox is understanding that Rockbox \emph{always} considers the song that | 12 | Rockbox is understanding that Rockbox \emph{always} considers the song that |
13 | it is playing to be part of a playlist, and in some situations, Rockbox will | 13 | it is playing to be part of a playlist, and in some situations, Rockbox will |
14 | create a playlist automatically. For example, if you are playing the | 14 | create a playlist automatically. For example, if you are playing the |
15 | contents of a directory, Rockbox will automatically create a playlist | 15 | contents of a directory, Rockbox will automatically create a playlist |
16 | containing the songs in that directory. This means that just about anything | 16 | containing the songs in that directory. This means that just about anything |
17 | that is described in this chapter with respect to playlists also applies to | 17 | that is described in this chapter with respect to playlists also applies to |
18 | directories. | 18 | directories. |
19 | 19 | ||
20 | \item[Dynamic playlist.] A dynamic playlist is a playlist that is created | 20 | \item[Dynamic playlist.] A dynamic playlist is a playlist that is created |
21 | ``On the fly.'' Any time you insert or queue tracks using the | 21 | ``On the fly.'' Any time you insert or queue tracks using the |
22 | \setting{Playlist submenu} (see \reference{playlist_submenu}), you are | 22 | \setting{Playlist submenu} (see \reference{playlist_submenu}), you are |
23 | creating (or adding to) a dynamic playlist. | 23 | creating (or adding to) a dynamic playlist. |
24 | 24 | ||
25 | \item[Insert.] In Rockbox, to \setting{Insert} an item into a playlist means | 25 | \item[Insert.] In Rockbox, to \setting{Insert} an item into a playlist means |
26 | putting an item into a playlist and leaving it there, even after it is | 26 | putting an item into a playlist and leaving it there, even after it is |
27 | played. As you will see later in this chapter, Rockbox can \setting{Insert} | 27 | played. As you will see later in this chapter, Rockbox can \setting{Insert} |
28 | into a playlist in several places. | 28 | into a playlist in several places. |
29 | 29 | ||
30 | \item[Queue.] In Rockbox, to \setting{Queue} a song means to put the song | 30 | \item[Queue.] In Rockbox, to \setting{Queue} a song means to put the song |
31 | into a playlist and then to remove the song from the playlist once it has | 31 | into a playlist and then to remove the song from the playlist once it has |
32 | been played. The only difference between \setting{Insert} and | 32 | been played. The only difference between \setting{Insert} and |
33 | \setting{Queue} is that the \setting{Queue} option removes the song from the | 33 | \setting{Queue} is that the \setting{Queue} option removes the song from the |
34 | playlist once it has been played, and the \setting{Insert} option does not. | 34 | playlist once it has been played, and the \setting{Insert} option does not. |
35 | \end{description} | 35 | \end{description} |
36 | 36 | ||
37 | \subsection{Creating playlists} | 37 | \subsection{Creating playlists} |
38 | 38 | ||
39 | Rockbox can create playlists in four different ways. | 39 | Rockbox can create playlists in four different ways. |
40 | 40 | ||
41 | \subsubsection{By playing a song} | 41 | \subsubsection{By playing a song} |
42 | 42 | Whenever a song is selected from the \setting{File Browser} using the | |
43 | Whenever a song is selected from the \setting{File Browser} using the | 43 | \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect} button, Rockbox will |
44 | \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect} button, Rockbox will automatically create a playlist | 44 | automatically create a playlist containing all of the songs in the directory |
45 | containing all of the songs in the directory in which that song is located. | 45 | in which that song is located. |
46 | 46 | ||
47 | \note{If you already have already created a dynamic playlist, playing a new | 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 | 48 | song will \emph{erase} the current playlist and create a new one. If you |
49 | want to add a song to the current playlist rather than erasing the current | 49 | want to add a song to the current playlist rather than erasing the current |
50 | playlist, see the section below on ``Adding music to playlists.''} | 50 | playlist, see the section below on ``Adding music to playlists.''} |
51 | 51 | ||
52 | \subsubsection{By using Insert and Queue functions} | 52 | \subsubsection{By using Insert and Queue functions} |
@@ -57,56 +57,64 @@ containing all of the songs in the directory in which that song is located. | |||
57 | 57 | ||
58 | \subsection{Adding music to playlists} | 58 | \subsection{Adding music to playlists} |
59 | 59 | ||
60 | \subsubsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist} | 60 | \subsubsection{\label{ref:Playlistsubmenu}Adding music to a dynamic playlist} |
61 | \screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{} | 61 | \screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{} |
62 | The \setting{Playlist Submenu} allows you to put tracks into a | 62 | The \setting{Playlist Submenu} allows you to put tracks into a |
63 | ``dynamic playlist''. If there is no music currently playing, Rockbox will | 63 | ``dynamic playlist''. If there is no music currently playing, Rockbox will |
64 | create a new dynamic playlist and put the selected track(s) into the | 64 | create a new dynamic playlist and put the selected track(s) into the |
65 | playlist. If there is music currently playing, Rockbox will put the | 65 | playlist. If there is music currently playing, Rockbox will put the |
66 | selected track(s) into the current playlist. The place in which the newly | 66 | selected track(s) into the current playlist. The place in which the newly |
67 | selected tracks are added to the playlist is determined by the following | 67 | selected tracks are added to the playlist is determined by the following |
68 | options: | 68 | options: |
69 | 69 | ||
70 | \begin{description} | 70 | \begin{description} |
71 | \item [Insert.] Add track(s) to playlist. If no other tracks have been | 71 | \item [Insert.] Add track(s) to playlist. If no other tracks have been |
72 | inserted then the selected track will be added immediately after current | 72 | inserted then the selected track will be added immediately after current |
73 | playing track, otherwise they will be added to end of insertion list. | 73 | playing track, otherwise they will be added to end of insertion list. |
74 | 74 | ||
75 | \item [Insert next.] Add track(s) immediately after current playing | 75 | \item [Insert next.] Add track(s) immediately after current playing |
76 | track, no matter what else has been inserted. | 76 | track, no matter what else has been inserted. |
77 | 77 | ||
78 | \item [Insert last.] Add track(s) to end of playlist. | 78 | \item [Insert last.] Add track(s) to end of playlist. |
79 | 79 | ||
80 | \item [Queue.] Queue is the same as Insert except queued tracks are | 80 | \item [Queue.] Queue is the same as Insert except queued tracks are |
81 | deleted immediately from the playlist after they've been played. Also, | 81 | deleted immediately from the playlist after they've been played. Also, |
82 | queued tracks are not saved to the playlist file (see | 82 | queued tracks are not saved to the playlist file (see |
83 | \reference{ref:playlistoptions}). | 83 | \reference{ref:playlistoptions}). |
84 | 84 | ||
85 | \item [Queue next.] Queue track(s) immediately after current playing track. | 85 | \item [Queue next.] Queue track(s) immediately after current playing track. |
86 | 86 | ||
87 | \item [Queue last.] Queue track(s) at end of playlist. | 87 | \item [Queue last.] Queue track(s) at end of playlist. |
88 | \end{description} | 88 | \end{description} |
89 | 89 | ||
90 | The \setting{Playlist Submenu} can be used to add either single tracks or | 90 | The \setting{Playlist Submenu} can be used to add either single tracks or |
91 | entire directories to a playlist. If the \setting{Playlist Submenu} is | 91 | entire directories to a playlist. If the \setting{Playlist Submenu} is |
92 | invoked on a single track, it will put only that track into the playlist. | 92 | invoked on a single track, it will put only that track into the playlist. |
93 | On the other hand, if the \setting{Playlist Submenu} is invoked on a | 93 | On the other hand, if the \setting{Playlist Submenu} is invoked on a |
94 | directory, Rockbox adds all of the tracks in that directory to the | 94 | directory, Rockbox adds all of the tracks in that directory to the |
95 | playlist. | 95 | playlist. |
96 | 96 | ||
97 | Dynamic playlists are saved so resume will restore them exactly as they | 97 | Dynamic playlists are saved so resume will restore them exactly as they |
98 | were before shutdown. | 98 | were before shutdown. |
99 | 99 | ||
100 | \subsection{Saving playlists} | 100 | \subsection{Saving playlists} |
101 | To save the current playlist either enter the \setting{Playlist} submenu | ||
102 | in the \setting{WPS Context Menu} (see \reference{sec:contextmenu}) and | ||
103 | select \setting{Save Current Playlist} or enter the | ||
104 | \setting{Playlist Options} menu in the \setting{Main Menu} and select | ||
105 | \setting{Save Current Playlist}. | ||
106 | Either method will bring you to the \setting{Virtual Keyboard} (see | ||
107 | \reference{sec:virtual_keyboard}), enter a filename for your playlist and | ||
108 | accept it and you're done. | ||
101 | 109 | ||
102 | \subsection{Loading saved playlists} | 110 | \subsection{Loading saved playlists} |
103 | 111 | ||
104 | \subsection{Helpful Hints} | 112 | \subsection{Helpful Hints} |
105 | 113 | ||
106 | \subsubsection{Including subdirectories in playlists} | 114 | \subsubsection{Including subdirectories in playlists} |
107 | You can control whether or not Rockbox includes the contents of | 115 | You can control whether or not Rockbox includes the contents of |
108 | subdirectories when adding an entire directory to a playlists. | 116 | subdirectories when adding an entire directory to a playlists. |
109 | Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$ | 117 | Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$ |
110 | Recusively Insert Directories} setting to \setting{Yes} if you would like | 118 | Recusively Insert Directories} setting to \setting{Yes} if you would like |
111 | Rockbox to include tracks in subdirectories as well as tracks in the | 119 | Rockbox to include tracks in subdirectories as well as tracks in the |
112 | currently selected directory. | 120 | currently selected directory. |