chiark / gitweb /
cgi/cgimain.c: Make the CGI program be (a little) locale-aware.
[disorder] / 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    <hr>
181
182    <a href="index.html">Back to contents</a>
183
184  </body>
185 </html>