chiark / gitweb /
cgi/cgimain.c: Make the CGI program be (a little) locale-aware.
[disorder] / disobedience / manual / playlists.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
2 <!--
3 This file is part of DisOrder.
4 Copyright (C) 2009 Richard Kettlewell
5
6 This program is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along 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>