chiark - git - mdw - disorder/blob - disobedience/manual/tabs.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: Tabs</title>
  22    <link rel=stylesheet
  23          type="text/css"
  24          href="disobedience.css">
  25  </head>
  26  <body>
  27    <h1>3. Tabs</h1>
  28
  29    <p>The chapter contains detailed descriptions of the Queue, Recent,
  30    Choose and Added tabs.</p>
  31
  32    <h2><a name=queue>3.1 The Queue</a></h2>
  33
  34    <p>The <b>Queue</b> tab has already
  35    been <a href="window.html#main">briefly described</a>, but there
  36    are some more things to say about.  To start with, the meaning of
  37    the columns:</p>
  38
  39    <table>
  40      <tr>
  41        <td><b>When</b></td>
  42        <td>This is the server's estimate of when the track will start.
  43        If play is disabled but the queue isn't empty, then it is based
  44        on the assumption that play is about to be enabled.</td>
  45      </tr>
  46      <tr>
  47        <td><b>Who</b></td>
  48        <td>This is the person who selected the track.  If the track
  49        was picked at random by the server it is empty.  You can
  50        &ldquo;adopt&rdquo; a randomly picked track; see below.</td>
  51      </tr>
  52      <tr>
  53        <td><b>Artist</b></td>
  54        <td>The artist responsible for the track.  Like the other track
  55        name columns, this depends on the server's logic for parsing
  56        filename, so can be a bit wrong.  You can edit the track
  57        properties to correct it.</td>
  58      </tr>
  59      <tr>
  60        <td><b>Album</b></td>
  61        <td>The album that the track came from.</td>
  62      </tr>
  63      <tr>
  64        <td><b>Title</b></td>
  65        <td>The title of the track.</td>
  66      </tr>
  67      <tr>
  68        <td><b>Length</b></td>
  69        <td>The length the track will play for.  For the playing track
  70        this will include the amount of time it's been playing so
  71        far.</td>
  72      </tr>
  73    </table>
  74
  75    <p>You can select tracks in the queue by clicking on them.  You can
  76    select multiple tracks by clicking in a second location with SHIFT
  77    depressed (to select all tracks between the first and second click)
  78    or with CTRL depressed (to add a single track to the selection).</p>
  79
  80    <p>Having selected tracks you can drag them to a new location in
  81    the queue.  Of course, you can't drag the playing track, nor can
  82    you drag other tracks before it.</p>
  83
  84    <p>Right-clicking in the queue will create a pop-up menu:</p>
  85
  86    <p class=image><img src="queue-menu.png"></p>
  87
  88    <p><b>Track Properties</b> will create a window with editable
  89    properties of each selected track.  <b>Scratch playing track</b>
  90    only works if the playing track is the selected track and will stop
  91    it playing.  <b>Remove track from queue</b> will remove the
  92    selected (non-playing) tracks from the queue.</p>
  93
  94    <p><b>Adopt track</b> will apply your name to one without an entry
  95    in the <b>Who</b> column, i.e. one that was randomly picked by the
  96    server.  The reason you might do this is to signal to other users
  97    that you did want this track to play.  (For instance, it might be
  98    an accepted convention that randomly picked tracks were fair game
  99    for removal but that tracks picked by a human should normally be
 100    left alone.)</p>
 101
 102    <h2><a name=recent>3.2 Recently Played Tracks</a></h2>
 103
 104    <p class=image><img src="recent.png"></p>
 105
 106    <p>The <b>Recent</b> tab is similar in structure to the queue but
 107    it shows tracks that have played recently.  The <b>When</b> column
 108    indicates when the track played rather than when it will
 109    played.</p>
 110
 111    <p>Right clicking will create a pop-up menu with similar options to
 112    those found in the queue's equivalent menu.  The one additional
 113    option is <b>Play track</b>, which allows a recently played track
 114    to be added back to the queue.</p>
 115
 116    <p>The other way of adding tracks from this tab back to the queue
 117    is to drag them to the queue tab and then to the desired point into
 118    the queue.</p>
 119
 120    <h2><a name=choose>3.3 Choosing Tracks</a></h2>
 121
 122    <p>The <b>Choose</b> tab contains all the tracks known to the
 123    server, organized into a hierarchical structure based on the
 124    underlying file and directory structure.</p>
 125
 126    <p class=image><img src="choose.png"></p>
 127
 128    <p>The boxes in the <b>Queued</b> column are ticked if the track is
 129    somewhere in the queue.  You can click on an unticked box to add
 130    the track to the queue, but clicking an already-ticked one will
 131    have no effect.</p>
 132
 133    <p>Directories can be expanded or collapsed by clicking on the
 134    triangular signs left of their names.  Tracks can be selected and
 135    deselected by clicking on them.  You can select multiple tracks by
 136    clicking in a second location with SHIFT depressed (to select all
 137    tracks between the first and second click) or with CTRL depressed
 138    (to add a single track to the selection).</p>
 139
 140    <p>Right clicking will create a pop-up menu with what are hopefuly
 141    now familiar options.  <b>Play track</b> will add the selected
 142    track(s) to the queue and <b>Track Properties</b> will create a
 143    window with editable properties of each selected track.</p>
 144
 145    <p>Note that when tracks are added to the queue these ways they
 146    will be added before any tracks picked at random by the server, so
 147    that users don't have to wait for them to play out.</p>
 148
 149    <p>Selected tracks can also be dragged to the queue, by dragging
 150    first to the <b>Queue</b> tab itself and then to the desired
 151    location in the queue.</p>
 152
 153    <p class=image><img src="choose-search.png"></p>
 154
 155    <p>To do a word search over all tracks, you can just start typing.
 156    Your search terms will appear in the input box at the bottom of the
 157    window.  Directories containing matching tracks are automatically
 158    opened and the matches highlighted in yellow.  You can jump to the
 159    previous or next search result with the up and down arrows at the
 160    bottom right of the screen (or jump to the next one by pressing
 161    CTRL+G).</p>
 162
 163    <p>If you enter more than one word at a time then only tracks which
 164    match <i>both</i> words will be listed.</p>
 165
 166    <p>You can search for <a href="properties.html#tags">tags</a> as
 167    well as words.  For instance to search for the tag
 168    &ldquo;happy&rdquo; you would enter <tt>tag:happy</tt> in the
 169    search box.</p>
 170
 171    <p>To clear the search, press the <b>Cancel</b> button.</p>
 172
 173    <h2><a name=added>3.4 Newly Added Tracks</a></h2>
 174
 175    <p>The <b>Added</b> tab shows tracks that have been newly detected
 176    by the server, in order to allow those tracks to be conveniently
 177    played.  In behavior it is the same as the
 178    recently <a href="#recent">played tracks list</a>.</p>
 179
 180  </body>
 181 </html>