chiark - git - mdw - disorder/blob - 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>