chiark / gitweb /
Improve playlists section of disobedience manual
[disorder] / disobedience / manual / playlists.html
... / ...
CommitLineData
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2<!--
3This file is part of DisOrder.
4Copyright (C) 2009 Richard Kettlewell
5
6This program is free software: you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
8the Free Software Foundation, either version 3 of the License, or
9(at your option) any later version.
10
11This program is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with this program. If not, see <http://www.gnu.org/licenses/>.
18-->
19<html>
20 <head>
21 <title>Disobedience: Playlists</title>
22 <link rel=stylesheet
23 type="text/css"
24 href="disobedience.css">
25 </head>
26 <body>
27 <h1>5. Playlists</h1>
28
29 <p>The chapter describes playlist and how to use them.</p>
30
31 <h2><a name=what>5.1 What are playlists?</a></h2>
32
33 <p>A playlist is a named list of tracks stored by the server. It
34 can be edit by either just its owner or, alternatively, by all
35 users. It can be played as a unit when required.</p>
36
37 <p>Playlists fall into three categories:</p>
38
39 <table>
40 <tr>
41 <td><b>Shared</b></td>
42 <td>Shared playlists have no owner and can be seen and edited
43 by anybody.</td>
44 </tr>
45
46 <tr>
47 <td><b>Public</b></td>
48 <td>Public playlist are owned by their creator and can be seen
49 by anybody. Only their creator can edit them, however.</td>
50 </tr>
51
52 <tr>
53 <td><b>Private</b></td>
54 <td>Private playlists are owned by their creator and can only
55 be seen or edited by their creator.</td>
56 </tr>
57
58 </table>
59
60 <p>To bring up the playlist window, select <b>Edit > Edit
61 Playlists</b> from the menu.</p>
62
63 <h2><a name=creating>5.2 Creating Playlists</a></h2>
64
65 <p>To create a playlist, click the <b>Add</b> button in the
66 playlist editor. This will create a pop-up window where you can
67 enter the name of the new playlist and decide whether it is
68 shared, public or private.</p>
69
70 <p>Only Roman letters (without any accents) and digits are allowed
71 in playlist names.</p>
72
73 <p class=image><img src="playlist-create.png"></p>
74
75 <h2><a name=editing>5.3 Editing Playlists</a></h2>
76
77 <p>You can select the playlist to edit from the left side of the
78 window. Shared playlists are listed first, then the public
79 playlists of each user (plus private playlists that you own).</p>
80
81 <p class=image><img src="playlist-window.png"></p>
82
83 <p>When a playlist is selected, you can edit in the right hand half
84 of the playlist window. The editor is very similar in structure
85 and function to the <a href="tabs.html#queue">queue</a>. You can
86 rearrange tracks within it by drag and drop and you can drag tracks
87 from the <b>Choose</b> tab into it.</p>
88
89 <p>Right clicking will create a pop-up menu which you can use to
90 play indivudual tracks or the whole playlist, as well as the
91 usual options as found in the <b>Queue</b> tab.</p>
92
93 <p class=image><img src="playlist-popup-menu.png"></p>
94
95 <h2><a name=playing>5.3 Playing Playlists</a></h2>
96
97 <p>There are three ways to play a playlist:</p>
98
99 <ol>
100
101 <li>You can use <b>Control > Activate Playlist</b> from the main
102 menu.</li>
103
104 <li>Right clicking in either half of the playlist editor will
105 create a pop-up menu. There is an option to play this
106 playlist.</li>
107
108 <li>You can select all the tracks and drag them to the desired
109 point in the <b>Queue</b> tab.</li>
110
111 </ol>
112
113 <hr>
114
115 <a href="index.html">Back to contents</a>
116
117 </body>
118</html>