Commit | Line | Data |
---|---|---|
d365231a RK |
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 | ||
a9ace56d | 29 | <p>The chapter contains detailed descriptions of the Queue, Recent, |
d365231a RK |
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 | “adopt” 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 | ||
a9ace56d RK |
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 | “happy” you would enter <tt>tag:happy</tt> in the | |
169 | search box.</p> | |
170 | ||
d365231a RK |
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 | ||
f326f12d RK |
180 | <hr> |
181 | ||
182 | <a href="index.html">Back to contents</a> | |
183 | ||
d365231a RK |
184 | </body> |
185 | </html> |