chiark / gitweb /
Tree structure for playlist picker
[disorder] / disobedience / manual / playlists.html
CommitLineData
0f839d0f
RK
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 <!-- TODO rewrite with screenshots -->
66
67 <p>To create a playlist, click the <b>Add</b> button in the
68 playlist editor. This will create a pop-up window where you can
69 enter the name of the new playlist and decide whether it is
70 shared, public or private.</p>
71
72 <p>Only Roman letters (without any accents) and digits are allowed
73 in playlist names.</p>
74
75 <h2><a name=editing>5.3 Editing Playlists</a></h2>
76
77 <!-- TODO rewrite with screenshots - might be worth waiting until
78 picker is a tree -->
79
80 <p>When a playlist is selected, you can edit in the right hand half
81 of the playlist window. The editor is very similar in structure
82 and function to the <a href="tabs.html#queue">queue</a>. You can
83 rearrange tracks within it by drag and drop and you can drag tracks
84 from the <b>Choose</b> tab into it.</p>
85
86 <h2><a name=playing>5.3 Playing Playlists</a></h2>
87
88 <p>There are three ways to play a playlist:</p>
89
90 <ol>
91
92 <li>Right clicking in the playlist editor will create a pop-up
93 menu. In addition to the familiar options there is an option to
94 play this playlist.</li>
95
96 <li>You can select all the tracks and drag them to the desired
97 point in the <b>Queue</b> tab.</li>
98
99 <li>You can use <b>Control > Activate Playlist</b> from the main
100 menu.</li>
101
102 </ol>
103
f326f12d
RK
104 <hr>
105
106 <a href="index.html">Back to contents</a>
107
0f839d0f
RK
108 </body>
109</html>