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    <!-- 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
 104    <hr>
 105
 106    <a href="index.html">Back to contents</a>
 107
 108  </body>
 109 </html>