chiark / gitweb /
DisOrder 4.2
[disorder] / doc /
1 .\"
2 .\" Copyright (C) 2004-2008 Richard Kettlewell
3 .\"
4 .\" This program is free software; you can redistribute it and/or modify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
8 .\"
9 .\" This program is distributed in the hope that it will be useful, but
10 .\" WITHOUT ANY WARRANTY; without even the implied warranty of
12 .\" General Public License for more details.
13 .\"
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program; if not, write to the Free Software
16 .\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
17 .\" USA
18 .\"
19 .TH disobedience 1
21 disobedience \- GUI client for DisOrder jukebox
23 .B disobedience
24 .RI [ OPTIONS ]
26 .B disobedience
27 is a graphical client for DisOrder.
29 .SS "Server Menu"
30 This has the following options:
31 .TP
32 .B Login
33 Brings up the \fBLogin Details Window\fR; see below.
34 .TP
35 .B "Manage Users"
36 Brings up the \fBUser Management Window\fR; see below.
37 .TP
38 .B Quit
39 Terminates the program.
40 .SS "Edit Menu"
41 This has the following options:
42 .TP
43 .B "Select All"
44 Select all tracks in whichever of the Queue or Recent tabs are showing.
45 .TP
46 .B Properties
47 Edit the details of the selected tracks.
48 See
49 .B "Properties Window"
50 below.
51 .SS "Control Menu"
52 This has the following options:
53 .TP
54 .B Scratch
55 Interrupts the currently playing track.
56 .TP
57 .B Playing
58 Pause and resume the current track.
59 .TP
60 .B "Random play"
61 Enable and disable random play.
62 Does not take effect until the currently playing track finishes.
63 .TP
64 .B "Network player"
65 Enables or disables network play.
66 See
68 below.
69 .SS "Help Menu"
70 This has only one option, "About DisOrder", which pops up a box giving the
71 name, author and version number of the software.
72 .SS "Controls"
73 .TP
74 .B "Pause button"
75 The pause button can be used to pause and resume tracks.
76 .TP
77 .B "Scratch button"
78 The scratch button, a red cross, can be used to interrupt the currently playing
79 track.
80 .TP
81 .B "Random play button"
82 The random play button can be used to enable and disable random play.
83 It does not take effect until the currently playing track finishes.
84 .TP
85 .B "Play button"
86 The play button controls whether tracks will be played at all.
87 As above it does not take effect until the currently playing track finishes.
88 .TP
89 .B "Network play button"
90 The network play buttons enables or disables network play.
91 See
93 below.
94 .TP
95 .B "Volume slider"
96 The volume slider indicates the current volume level and can be used to adjust
97 it.
98 0 is silent and 10 is maximum volume.
99 .TP
100 .B "Balance slider"
101 The balance slider indicates the current balance and can be used to adjust it.
102 -1 means only the left speaker, 0 means both speakers at equal volume and +1
103 means the only the right speaker.
104 .SS "Queue Tab"
105 This displays the currently playing track and the queue.
106 The currently playing track is at the top, and can be distinguished by
107 the constantly updating timer.
108 Queued tracks appear below it.
109 .PP
110 The left button can be use to select and deselect tracks.
111 On its own it just selects the pointed track and deselects everything else.
112 With CTRL it flips the state of the pointed track without affecting anything
113 else.
114 With SHIFT it selects every track from the last click to the current position
115 and deselects everything else.
116 With both CTRL and SHIFT it selects everything from the last click to the
117 current position without deselecting anything.
118 .PP
119 Tracks can be moved within the queue by dragging them to a new position with
120 the left button.
121 .PP
122 The right button pops up a menu.
123 This has the following options:
124 .TP
125 .B Properties
126 Edit the details of the selected tracks.
127 See
128 .B "Properties Window"
129 below.
130 .TP
131 .B "Select All"
132 Select all tracks.
133 .TP
134 .B Scratch
135 Interrupt the currently playing track.
136 (Note that this appears even if you right click over a queued track rather
137 than the currently playing track.)
138 .TP
139 .B Remove
140 Remove the selected tracks from the queue.
141 .SS "Recent Tab"
142 This displays recently played tracks, the most recent at the top.
143 .PP
144 The left button functions as above, except that drag-and-drop rearrangement
145 is not possible.
146 The right button pops up a menu with the following options:
147 .TP
148 .B Properties
149 Edit the details of the selected tracks.
150 See
151 .B "Properties Window"
152 below.
153 .TP
154 .B "Select All"
155 Select all tracks.
156 .SS "Choose Tab"
157 This displays all the tracks known to the server in a tree structure.
158 .PP
159 Directories are represented with an arrow to their left.
160 This can be clicked to reveal or hide the contents of the directory.
161 The top level "directories" break up tracks by their first letter.
162 .PP
163 Playable files are represented by their name.
164 If they are playing or in the queue then a notes icon appears next to them.
165 .PP
166 Left clicking on a file will select it.
167 As with the queue tab you can use SHIFT and CTRL to select multiple files.
168 .PP
169 The text box at the bottom is a search form.
170 If you enter search terms here then tracks containing all those words will be
171 highlighted.
172 You can also limit the results to tracks with particular tags, by including
173 \fBtag:\fITAG\fR for each tag.
174 .PP
175 To start a new search just edit the contents of the search box.
176 The cancel button to its right clears the current search.
177 The up and down arrows will scroll the window to make the previous or next
178 search result visible.
179 .PP
180 Right clicking over a track will pop up a menu with the following options:
181 .TP
182 .B Play
183 Play selected tracks.
184 .TP
185 .B Properties
186 Edit properties of selected tracks.
187 See
188 .B "Properties Window"
189 below.
190 .PP
191 A middle click on a track will add it to the queue.
192 .PP
193 Right clicking over a directory will pop up a menu with the following options:
194 .TP
195 .B "Play all tracks"
196 Play all the tracks in the directory, in the order they appear on screen.
197 .TP
198 .B "Track properties"
199 Edit properties of all tracks in the directory.
200 .TP
201 .B "Select all tracks"
202 Select all the tracks in the directory (and deselect everything else).
203 .PP
204 Note that these options do not apply recursively - only the tracks in the
205 relevant directory are affected, not those in its subdirectories.
206 .SS "Added Tab"
207 This displays a list of tracks recently added to the server's database.
208 The most recently added track is at the top.
209 .PP
210 Left clicking a track will select it.
211 CTRL and SHIFT work as above to select muliple files.
212 .PP
213 Right clicking over a track will pop up a menu with the following options:
214 .TP
215 .B "Track properties"
216 Edit properties of selected tracks.
217 See
218 .B "Properties Window"
219 below.
220 .TP
221 .B "Play track"
222 Play selected tracks.
223 .TP
224 .B "Select All Tracks"
225 Select all tracks.
226 .SS "Login Details Window"
227 The login details window allows you to edit the connection details and
228 authorization information used by Disobedience.
229 .PP
230 At the top is a 'remote' switch.
231 If this is enabled then you can use the \fBHostname\fR and \fBService\fR
232 fields to connect to a remote server.
233 If it is disabled then then Disobedience will connect to a local server
234 instead.
235 .PP
236 Below this are four text entry fields:
237 .TP
238 .B Hostname
239 The host to connect to.
240 .TP
241 .B Service
242 The service name or port number to connect to.
243 .TP
244 .B "User name"
245 The user name to log in as.
246 .TP
247 .B Password
248 The password to use when logging in.
249 Note that this is NOT your login password but is your password to the
250 DisOrder server.
251 .PP
252 It has two buttons:
253 .TP
254 .B Login
255 This button attempts to (re-)connect to the server with the currently displayed
256 settings.
257 The settings are saved in
258 .IR $HOME/.disorder/passwd .
259 on success.
260 .TP
261 .B Close
262 This button closes the window, discarding any unsaved changes.
263 .SS "Properties Window"
264 This window contains details of one or more tracks and allows them to be
265 edited.
266 .PP
267 The Artist, Album and Title fields determine how the tracks appear in
268 the queue and recently played tabs.
269 .PP
270 The Tags field determine which tags apply to the track.
271 Tags are separated by commas and can contain any printing characters except
272 comma.
273 .PP
274 The Weight field determines the track weight.  Tracks with higher weights are
275 proportionately more likely to be picked at random.  The default weight is
276 90000, and the maximum weight is 2147483647.
277 .PP
278 The Random checkbox determines whether the track will be picked at random.
279 Random play is enabled for every track by default, but it can be turned off
280 here.
281 .PP
282 The double-headed arrow to the right of each preference will propagate its
283 value to all the other tracks in the window.
284 For instance, this can be used to efficiently correct the artist or album
285 fields, or bulk-disable random play for many tracks.
286 .PP
287 Press "OK" to confirm all changes and close the window, "Apply" to confirm
288 changes but keep the window open and "Cancel" to close the window and discard
289 all changes.
290 .SS "User Management Window"
291 This window is primarily of interest to adminstrators, and will not be
292 available to users without admin rights.  The left hand side is a list of all
293 users; the right hand side contains the editable details of the currently
294 selected user.
295 .PP
296 When you select any user you can edit their email address or change their
297 password.  It is also possible to edit the individual user rights.  Click on
298 the "Apply" button to commit any changes you make.
299 .PP
300 The "Add" button creates a new user.  You must enter at least a username.
301 Default rights are setting according to local configuration, \fInot\fR server
302 configuration (but this may be changed in the future).  As above, click on
303 "Apply" to actually create the new user.
304 .PP
305 The "Delete" button deletes the selected user.  This operation cannot be
306 undone.
308 .TP
309 .B CTRL+A
310 Select all tracks (queue/recent)
311 .TP
312 .B CTRL+L
313 Brings up the \fBLogin Details Window\fR.
314 .TP
315 .B CTRL+Q
316 Quit.
318 Network play uses a background
319 .BR disorder\-playrtp (1)
320 process.
321 If you quit Disobedience the player will continue playing and can be
322 disabled from a later run of Disobedience.
323 .PP
324 The player will log to
325 .I ~/.disorder/HOSTNAME\-rtp.log
326 so look there if it does not seem to be working.
327 .PP
328 You can stop it without running Disobedience by the command
329 .BR "killall disorder\-playrtp" .
331 .TP
332 .B \-\-config \fIPATH\fR, \fB\-c \fIPATH
333 Set the configuration file.
334 The default is
335 .IR pkgconfdir/config .
336 .TP
337 .B \-\-debug\fR, \fB\-d
338 Enable debugging.
339 .TP
340 .B \-\-help\fR, \fB\-h
341 Display a usage message.
342 .TP
343 .B \-\-version\fR, \fB\-V
344 Display version number.
345 .SS "GTK+ Options"
346 Additional options are supported by the GTK+ library.
347 Refer to GTK+ documentation for further information.
348 Under X11 they include:
349 .TP
350 .B \-\-display \fIDISPLAY\fR
351 The X display to use.
352 .TP
353 .B \-\-screen \fISCREEN\fR
354 The screen number to use.
355 .\" If know enough to use it you know enough to find it
356 .\" .TP
357 .\" .B \-\-sync
358 .\" Make all X requests synchronously.
360 If you are using
361 .B disobedience
362 on the same host as the server then no additional configuration should be
363 required.
364 .PP
365 If it is running on a different host then the easiest way to set it up is to
366 use the login details window in Disobedience.
367 Enter the connection details, use Login to connect to the server, and then
368 use Save to store them for future sessions.
369 .PP
370 The other clients read their configuration from the same location so after
371 setting up with Disobedience, tools such as
372 .BR disorder (1)
373 should work as well.
374 .SH BUGS
375 There is no particular provision for multiple users of the same computer
376 sharing a single \fBdisorder\-playrtp\fR process.
377 This shouldn't be too much of a problem in practice but something could
378 perhaps be done given demand.
379 .PP
380 Try to do remote user management when the server is configured to refuse this
381 produces rather horrible error behavior.
382 .PP
383 Only one track can be dragged at a time.
384 .PP
385 Resizing columns doesn't work very well.
386 This is a GTK+ bug.
388 .TP
389 .I ~/.disorder/HOSTNAME\-rtp
390 Socket for communication with RTP player.
391 .TP
392 .I ~/.disorder/HOSTNAME\-rtp.log
393 Log file for RTP player.
394 .SH "SEE ALSO"
395 .BR disorder\-playrtp (1),
396 .BR disorder_config (5)
397 .PP
398 .B
399 .br
400 - DisOrder home page
401 .PP
402 .B\-x11.html
403 .br
404 - Using GTK+ on the X Window System
405 .\" Local Variables:
406 .\" mode:nroff
407 .\" fill-column:79
408 .\" End: