diff options
author | Christian Soffke <christian.soffke@gmail.com> | 2023-01-08 16:11:39 +0100 |
---|---|---|
committer | Christian Soffke <christian.soffke@gmail.com> | 2024-04-24 05:50:28 +0200 |
commit | b50178862906fa1a9030cacb3332c8aa2e00f677 (patch) | |
tree | 62ffcffc29816525257f157b34dd8dcef6795c81 /manual/working_with_playlists | |
parent | e8816552f6adc2bb458860759bd15a31b7d9d0d1 (diff) | |
download | rockbox-b50178862906fa1a9030cacb3332c8aa2e00f677.tar.gz rockbox-b50178862906fa1a9030cacb3332c8aa2e00f677.zip |
manual: update browsing, playlists, bookmarking, ipod keymap
Change-Id: I7f3fd66fc973d3ed8d41cf24fba6aa4a44256354
Diffstat (limited to 'manual/working_with_playlists')
-rw-r--r-- | manual/working_with_playlists/main.tex | 135 |
1 files changed, 56 insertions, 79 deletions
diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex index dd25d41c26..553418a80a 100644 --- a/manual/working_with_playlists/main.tex +++ b/manual/working_with_playlists/main.tex | |||
@@ -2,85 +2,66 @@ | |||
2 | \section{\label{ref:working_with_playlists}Working with Playlists} | 2 | \section{\label{ref:working_with_playlists}Working with Playlists} |
3 | 3 | ||
4 | \subsection{Playlist terminology} | 4 | \subsection{Playlist terminology} |
5 | Some common terms that are used in Rockbox when referring to | ||
6 | playlists: | ||
7 | 5 | ||
8 | \begin{description} | 6 | \begin{description} |
9 | \item[Directory.] A playlist! One of the keys to getting the most out of | 7 | \item[Directory.] Rockbox always considers the song that is playing to be part of |
10 | Rockbox is understanding that Rockbox \emph{always} considers the song that | 8 | a playlist, and will create a playlist automatically when you are playing the |
11 | it is playing to be part of a playlist, and in some situations, Rockbox will | 9 | contents of a directory. Meaning, just about anything that is described in this |
12 | create a playlist automatically. For example, if you are playing the | 10 | chapter with respect to playlists also applies to directories. |
13 | contents of a directory, Rockbox will automatically create a playlist | 11 | |
14 | containing all songs in it. This means that just about anything | 12 | \item[Dynamic playlist.] A dynamic playlist is a playlist created |
15 | that is described in this chapter with respect to playlists also applies to | 13 | ``on the fly.'' Any time you use the \setting{Playing Next...} menu |
16 | directories. | 14 | (see \reference{ref:playingnext_submenu}), or play something |
17 | 15 | from the database, you are creating or adding to a dynamic playlist. | |
18 | \item[Dynamic playlist.] A dynamic playlist is a playlist that is created | 16 | |
19 | ``On the fly.'' Any time you insert or queue tracks using the | 17 | \item[Play / Add.] \setting{Play} or \setting{Add} a track to |
20 | \setting{Playing Next Submenu} (see \reference{ref:playingnext_submenu}), you are | 18 | put it into the current (dynamic) playlist. |
21 | creating (or adding to) a dynamic playlist. | 19 | |
22 | 20 | \item[Queue.] \setting{Queued} tracks are also put into the dynamic playlist, | |
23 | \item[Play/Add.] In Rockbox, to \setting{Play} or \setting{Add} an item means | 21 | but removed again as soon as they've been played. |
24 | putting it into a playlist and leaving it there, even after it is | 22 | Note: Options for queuing tracks are hidden by default (see \reference{ref:queuing} for more details). |
25 | played. | ||
26 | |||
27 | \item[Queue.] To \setting{Queue} a song means to put it into a playlist, but then | ||
28 | to remove the song from the playlist once it has been played. | ||
29 | \end{description} | 23 | \end{description} |
30 | 24 | ||
31 | \subsection{Creating playlists} | 25 | \subsection{Creating playlists} |
32 | 26 | ||
33 | Rockbox can create playlists in four different ways. | 27 | \subsubsection{By selecting a song for playback} |
34 | 28 | When a song is selected from the \setting{File Browser} or \setting{Database} by pressing | |
35 | \subsubsection{By selecting (``playing'') a song from the File Browser} | 29 | \ActionTreeEnter, Rockbox will automatically create a playlist containing all of the |
36 | Whenever a song is selected from the \setting{File Browser} with | 30 | listed songs and will start playback. |
37 | \ActionTreeEnter, Rockbox will automatically create a playlist containing | 31 | |
38 | all of the songs in that directory and start playback with the selected | 32 | \note{Playing a new song will erase the existing dynamic playlist |
39 | song. | 33 | and create a new one. If you want to \emph{add} a song to it instead, |
40 | 34 | see \reference{ref:playingnext_submenu} on how to choose what's playing next.} | |
41 | \note{If you already have created a dynamic playlist, playing a new | 35 | |
42 | song will \emph{erase} the current dynamic playlist and create a new one. | 36 | \subsubsection{By choosing ``Play`` or ``Play Shuffled`` from ``Playing Next...``} |
43 | If you want to add a song to the current playlist | 37 | Replaces an existing dynamic playlist with the selected tracks. |
44 | rather than erasing the current | 38 | |
45 | playlist, see the section below on how to add music to a playlist.} | 39 | \subsubsection{\label{ref:addtoplaylist_submenu}By choosing ``Add to Playlist...``} |
46 | 40 | Choose \setting{Add to Playlist...} from the \setting{Context Menu} to | |
47 | \subsubsection{By using the Play or Play Shuffled functions} | 41 | add selected track(s) or directory to a new or existing playlist that is not currently |
48 | The \setting{Play} function as described in \ref{ref:playingnext_submenu} | 42 | playing. |
49 | will replace the dynamic playlist with the selected tracks. The \setting{Play | ||
50 | Shuffled} function is similar, except the selected tracks will be added to the | ||
51 | playlist in a random order. | ||
52 | |||
53 | \subsubsection{\label{ref:addtoplaylist_submenu}By using the Add to Playlist submenu} | ||
54 | The \setting{Add to Playlist submenu} makes it possible to modify and create | ||
55 | playlists that are not currently playing. To do this select \setting{Add to Playlist...} | ||
56 | in the \setting{Context Menu}. There you will have two choices, | ||
57 | \setting{Add to Existing Playlist} adds the selected track or directory to an existing | ||
58 | playlist and \setting{Add to New Playlist} creates a new playlist containing | ||
59 | the selected track or directory. | ||
60 | 43 | ||
61 | \note{All playlists in the \setting{Playlist catalogue} are stored by default | 44 | \note{All playlists in the \setting{Playlist catalogue} are stored by default |
62 | in the \fname{/Playlists} directory in the root of your \daps{} disk and | 45 | in the \fname{/Playlists} directory in the root of your \daps{} disk and |
63 | playlists stored in other locations are not included in the catalogue. It is | 46 | playlists stored in other locations are not included in the catalogue. It is |
64 | however possible to move existing playlists there (see | 47 | however possible to move existing playlists there or change the default playlist |
65 | \reference{ref:Contextmenu}).} | 48 | directory (see \reference{ref:Contextmenu}).} |
66 | 49 | ||
67 | \subsubsection{By using the Main Menu} | 50 | \subsubsection{By using the Main Menu} |
68 | To create a playlist containing some or all of the music on your \dap{}, you can use the | 51 | To create a playlist containing some or all of the music on your \dap{}, you can use the |
69 | \setting{Create Playlist} command in the \setting{Playlist Catalogue Context Menu} | 52 | \setting{Create Playlist} command in the \setting{Playlist Catalogue Context Menu} |
70 | (see \reference{ref:playlistcatalogue_contextmenu}). | 53 | (see \reference{ref:playlistcatalogue_contextmenu}). |
71 | 54 | ||
72 | \subsection{Adding music to playlists} | 55 | \subsection{Choosing what's playing next} |
73 | 56 | ||
74 | \subsubsection{\label{ref:playingnext_submenu}Adding music to a dynamic playlist} | 57 | \subsubsection{\label{ref:playingnext_submenu}Adding music to a dynamic playlist} |
75 | \screenshot{rockbox_interface/images/ss-playlist-menu}{The Playing Next Submenu}{} | 58 | \screenshot{rockbox_interface/images/ss-playlist-menu}{Playing Next...}{} |
76 | The \setting{Playing Next Submenu} is a submenu in the \setting{Context Menu} (see | 59 | \setting{Playing Next...} is a submenu in the \setting{Context Menu} (see |
77 | \reference{ref:Contextmenu}), it allows you to put tracks into a | 60 | \reference{ref:Contextmenu}) that can be invoked on a selection of tracks in various |
78 | ``dynamic playlist''. The place in which the newly | 61 | places, such as the File Browser, Database, or even PictureFlow: |
79 | selected tracks are added to the playlist is determined by these | ||
80 | options: | ||
81 | 62 | ||
82 | \begin{description} | 63 | \begin{description} |
83 | \item [Play Next.] Play track(s) immediately after the currently playing track. | 64 | \item [Play Next.] Track(s) will play immediately after the currently playing track. |
84 | 65 | ||
85 | \item [Add.] Add track(s) after the most recently added tracks or, if tracks | 66 | \item [Add.] Add track(s) after the most recently added tracks or, if tracks |
86 | have not been added yet, immediately after the currently playing track. | 67 | have not been added yet, immediately after the currently playing track. |
@@ -92,8 +73,7 @@ have not been added yet, immediately after the currently playing track. | |||
92 | \item [Play Last Shuffled.] Add tracks in a random order to the end of the playlist. | 73 | \item [Play Last Shuffled.] Add tracks in a random order to the end of the playlist. |
93 | \end{description} | 74 | \end{description} |
94 | 75 | ||
95 | If you'd like to replace the current playlist with the new selection, the | 76 | To replace the current dynamic playlist with your selection, choose: |
96 | following two options will achieve that effect. | ||
97 | 77 | ||
98 | \begin{description} | 78 | \begin{description} |
99 | \item [Play.] Replace all entries in the dynamic playlist with the selected | 79 | \item [Play.] Replace all entries in the dynamic playlist with the selected |
@@ -106,10 +86,12 @@ following two options will achieve that effect. | |||
106 | playlist in random order. | 86 | playlist in random order. |
107 | \end{description} | 87 | \end{description} |
108 | 88 | ||
109 | Another possibility is to add tracks \emph{temporarily} to the dynamic playlist. | 89 | \label{ref:queuing}The following options are hidden by default, due to their |
110 | In Rockbox’s parlance, this is called queuing. Queued tracks are automatically | 90 | more complicated behavior. Queued tracks are temporarily added to the dynamic |
111 | removed from the playlist after they have been played. They are also not saved | 91 | playlist, but are automatically removed as soon as the tracks have been played. |
112 | to the playlist file (see \reference{ref:playlistoptions}). | 92 | Queued tracks will not be saved to a playlist file. |
93 | A current playlist containing queued tracks can not be bookmarked, even after saving it, | ||
94 | unless you confirm the tracks' removal first (see \reference{ref:createbookmark}). | ||
113 | 95 | ||
114 | \begin{description} | 96 | \begin{description} |
115 | \item [Queue Next.] Corresponds to \setting{Play Next}. | 97 | \item [Queue Next.] Corresponds to \setting{Play Next}. |
@@ -128,12 +110,8 @@ to the playlist file (see \reference{ref:playlistoptions}). | |||
128 | $\rightarrow$ \setting{Current Playlist}. Select either \setting{Show Shuffled Adding Options} | 110 | $\rightarrow$ \setting{Current Playlist}. Select either \setting{Show Shuffled Adding Options} |
129 | or \setting{Show Queue Options} to customize the displayed set of options.} | 111 | or \setting{Show Queue Options} to customize the displayed set of options.} |
130 | 112 | ||
131 | The \setting{Playing Next Submenu} can be used to add either single tracks or | 113 | If \setting{Playing Next...} is invoked on a directory, Rockbox adds all of the tracks in |
132 | entire directories to a playlist. If the \setting{Playing Next Submenu} is | 114 | that directory to the playlist. |
133 | invoked on a single track, it will put only that track into the playlist. | ||
134 | On the other hand, if the \setting{Playing Next Submenu} is invoked on a | ||
135 | directory, Rockbox adds all of the tracks in that directory to the | ||
136 | playlist. | ||
137 | 115 | ||
138 | \note{You can control whether or not Rockbox includes the contents of | 116 | \note{You can control whether or not Rockbox includes the contents of |
139 | subdirectories when adding an entire directory to a playlist. Set the | 117 | subdirectories when adding an entire directory to a playlist. Set the |
@@ -142,23 +120,22 @@ playlist. | |||
142 | you would like Rockbox to include tracks in subdirectories as well as tracks | 120 | you would like Rockbox to include tracks in subdirectories as well as tracks |
143 | in the currently-selected directory.} | 121 | in the currently-selected directory.} |
144 | 122 | ||
145 | Dynamic playlists are saved so resume will restore them exactly as they | 123 | Dynamic playlists are saved, so resume will restore them exactly as they |
146 | were before shutdown. | 124 | were before shutdown. |
147 | 125 | ||
148 | \note{To view, save, reshuffle, or display the play time of the current | 126 | \note{To view, save, reshuffle, or display the play time of the current |
149 | dynamic playlist use the | 127 | dynamic playlist use the |
150 | \setting{Playlist} sub menu in the WPS context menu or in the | 128 | \setting{Current Playlist} sub menu in the WPS context menu.} |
151 | \setting{Main Menu}.} | ||
152 | 129 | ||
153 | \subsection{Modifying playlists} | 130 | \subsection{Modifying playlists} |
154 | \subsubsection{Reshuffling} | 131 | \subsubsection{Reshuffling} |
155 | Reshuffling the current playlist is easily done from the \setting{Current Playlist} | 132 | Reshuffling the current playlist is easily done from the \setting{Current Playlist} |
156 | sub menu in the WPS, just select \setting{Reshuffle}. | 133 | sub menu in the WPS. |
157 | 134 | ||
158 | \subsubsection{Moving and removing tracks} | 135 | \subsubsection{Moving and removing tracks} |
159 | To move or remove a track from the current playlist enter the | 136 | To move or remove a track from the current playlist, enter the |
160 | \setting{Playlist Viewer} by selecting \setting{View Current Playlist} in the | 137 | \setting{Playlist Viewer} by selecting \setting{View Current Playlist} in the |
161 | \setting{Current Playlist} submenu in the WPS context menu or the \setting{Main Menu}. | 138 | \setting{Current Playlist} submenu in the WPS context menu. |
162 | Once in the \setting{Playlist Viewer} open the context menu on the track you | 139 | Once in the \setting{Playlist Viewer} open the context menu on the track you |
163 | want to move or remove. If you want to move the track, select \setting{Move} in | 140 | want to move or remove. If you want to move the track, select \setting{Move} in |
164 | the context menu and then move the blinking cursor to the place where you want | 141 | the context menu and then move the blinking cursor to the place where you want |
@@ -166,9 +143,9 @@ the track to be moved and confirm with \ActionStdOk. To remove a track, simply | |||
166 | select \setting{Remove} in the context menu. | 143 | select \setting{Remove} in the context menu. |
167 | 144 | ||
168 | \subsection{Saving playlists} | 145 | \subsection{Saving playlists} |
169 | To save the current playlist either enter the \setting{Current Playlist} submenu | 146 | To save the current playlist, either enter the \setting{Current Playlist} submenu |
170 | in the \setting{WPS Context Menu} (see \reference{sec:contextmenu}) and | 147 | in the \setting{WPS Context Menu} (see \reference{sec:contextmenu}) and |
171 | select \setting{Save Current Playlist} or enter the context menu for the | 148 | select \setting{Save Current Playlist}, or enter the context menu for the |
172 | \setting{Playlist catalogue} in the \setting{Main Menu} and select | 149 | \setting{Playlist catalogue} in the \setting{Main Menu} and select |
173 | \setting{Save Current Playlist}. | 150 | \setting{Save Current Playlist}. |
174 | Either method will bring you to the \setting{Virtual Keyboard} (see | 151 | Either method will bring you to the \setting{Virtual Keyboard} (see |