1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
3 This file is part of DisOrder.
4 Copyright (C) 2004-2008 Richard Kettlewell
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 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
24 <title>@label{help.title}@</title>
28 <h1 class=title>@label{help.title}@</h1>
30 <h2 class=sidebarlink>Introduction</h2>
32 <div class=helpsection>
34 <p>All screens in the DisOrder web interface have a set of
35 hyperlinks at the top. You can use these to visit the various
36 screens described below. Note that if you are not logged in some
37 of these will be greyed out.</p>
41 <h2 class=sidebarlink><a name=playing>Playing</a></h2>
43 <div class=helpsection>
45 <p>This screen displays the currently playing track (if there is one) and
46 lists all the tracks in the queue (the track that will be played soonest
47 being listed first.) Where possible, estimated start times are
50 <p>Each track has a <img class=button
52 title="@label:playing.scratch@"
53 alt="@label:playing.scratch@"> button next to it. For the
54 currently playing track this can be used to stop playing the
55 track before it has finished. For a track in the queue it
56 removes the track from the queue.</p>
58 <p>Depending on the server configuration, you may be able to do
59 this for any track, or only for tracks you submitted or that were
60 randomly picked. See the "restrict" option in <a
61 href="@url@?action=disorder_config.5">disorder_config(5)</a> for more
64 <p>Artist and album names are hyperlinks to the relevant locations
65 in the <a href="#choose">Choose</a> screen (see below).</p>
69 <h2 class=sidebarlink><a name=manage>Manage</a></h2>
71 <div class=helpsection>
73 <p>This screen is almost identical to <a
74 href="#playing">Playing</a> except that it includes extra
75 management features.</p>
77 <p>At the top of the screen are the following controls:</p>
80 <li>Pause. This button can be used to pause playing (provided the
81 player supports it). <img width=16 height=16 class=imgbutton
82 src="@image:enabled@"> indicates that playing is paused,
83 <img width=16 height=16 class=imgbutton
84 src="@image:disabled@"> that it is not.</li>
86 <li>Enable/disable random play. If disabled then queued tracks
87 will still be played but if the queue is empty nothing will be
88 picked at random. <img width=16 height=16 class=imgbutton
89 src="@image:enabled@"> indicates that random play is
90 enabled, <img width=16 height=16 class=imgbutton
91 src="@image:disabled@"> that it is disabled.</li>
93 <li>Enable/disable play. If disabled then tracks in the queue
94 will not be played, but will remain in the queue instead. <img
95 width=16 height=16 class=imgbutton src="@image:enabled@">
96 indicates that play is enabled, <img width=16 height=16
97 class=imgbutton src="@image:disabled@"> that it is
100 <li>Volume control. You can use the <img class=button
102 title="@label:volume.increase@"
103 alt="@label:volume.increase@"> and <img
105 title="@label:volume.reduce@"
106 alt="@label:volume.reduce@"> buttons to increase or
107 decrease the volume, or enter new volume settings for the left
108 and/or right speakers.</li>
112 <p>Below this is the same table of current and queued tracks as for
113 the main playing screen, but with extra buttons for managing the
115 The <img class=button src="@image:up@"
116 title="@label:playing.up@" alt="@label:playing.up@"> and <img
117 src="@image:down@" title="@label:playing.down@"
118 alt="@label:playing.down@"> buttons on each track move that
119 track around in the queue. Similarly the <img class=button
120 src="@image:upall@" title="@label:playing.upall@"
121 alt="@label:playing.upall@"> and <img
122 src="@image:downall@" title="@label:playing.downall@"
123 alt="@label:playing.downall@"> buttons move each track to the head or
125 Depending on server configuration, it may be that only trusted
126 users can move tracks around the queue.</p>
130 <h2 class=sidebarlink><a name=recent>Recent</a></h2>
132 <div class=helpsection>
134 <p>This screen displays recently played tracks, most recent first.
135 The <img class=button src="@image:edit@"
136 title="@label:choose.prefs@" alt="@label:choose.prefs@">
137 button can be used to edit the details for a track; see <a
138 href="#prefs">Editing Preferences</a> below.</p>
140 <p>The number of tracks remembered is controlled by the server
141 configuration. See the "history" option in <a
142 href="@url@?action=disorder_config.5">disorder_config(5)</a> for more
147 <h2 class=sidebarlink><a name=new>New</a></h2>
149 <div class=helpsection>
151 <p>This screen displays tracks recently added to the database,
152 most recent first. The <img class=button
153 src="@image:edit@" title="@label:choose.prefs@"
154 alt="@label:choose.prefs@"> button can be used to edit the details
155 for a track; see <a href="#prefs">Editing Preferences</a> below,
156 and clicking on the track title will add it to the queue.</p>
158 <p>The time tracks are remembered for is controlled by the server
159 configuration. See the "noticed_history" option in <a
160 href="@url@?action=disorder_config.5">disorder_config(5)</a> for
165 <h2 class=sidebarlink><a name=choose>Choose</a></h2>
167 <div class=helpsection>
169 <p>This screen allows you to choose a track to be played, by navigating
170 through the directory structure of the tracks filesystem. The following
173 <table class=helpbuttons>
176 <td class=helpbuttons><img
177 class=button src="@image:edit@"
178 title="@label:choose.prefs@"
179 alt="@label:choose.prefs@"></td>
180 <td class=helpbuttons>This button can be used to edit the details for a
181 track; see <a href="#prefs">Editing Preferences</a> below.</td>
184 <td class=helpbuttons><span class=button>@label{choose.playall}@</span></td>
185 <td class=helpbuttons>This button plays all the tracks in a directory,
186 in order. This is used to efficiently play a whole album.</td>
191 <p>This screen has two forms: <a
192 href="@url@?action=choose&nonce=@nonce@">choose</a>, which give
193 you all the top-level directories at once, and <a
194 href="@url@?action=choosealpha&nonce=@nonce@">choosealpha</a>,
195 which breaks them down by initial letter.</p>
199 <h2 class=sidebarlink><a name=prefs>Editing Preferences</a></h2>
201 <div class=helpsection>
203 <p>This screen, reached from <a href="#choose">Choose</a> or <a
204 href="#recent">Recent</a>, is used to edit a track's preferences.</p>
206 <p>The form can be used to
207 edit artist, album and title fields for the track as displayed, or
208 to set the tags for a track, or to enable or disable random play
211 <p>Tags are separated by commas and can contain any other printing
212 characters (including spaces). Leading and trailing spaces are
215 <p>Random play for any given track is enabled by default, but you
216 can use this screen to disable it for undesirable tracks.</p>
220 <h2 class=sidebarlink>Search</h2>
222 <div class=helpsection>
224 <p>This screen allows you to search for keywords in track names. If you
225 specify more than one keyword then only tracks containing all of them are
226 listed. Results are grouped by artist, album and title.</p>
228 <p>It is possible to limit results to tracks with a particular
229 tag, by using <b>tag:</b><i>TAG</i> among the search terms.</p>
231 <p>Some keywords, known as "stopwords", are excluded from the search, and
232 will never match. See the "stopword" option in <a
233 href="@url@?action=disorder_config.5">disorder_config(5)</a> for further
234 details about this.</p>
238 <h2 class=sidebarlink><a name=Login>Login</a></h2>
240 <div class=helpsection>
242 <p>This screen has two different versions.</p>
244 <p><b>1</b>. When no user is logged in, it has a login form and a
245 registration form. If you do not have a username and password,
246 fill in and submit the registration form. You will be emailed an
247 email with a confirmation URL that you must visit. Only after
248 visiting this URL will your login become active.</p>
250 <p>Once you have a username and password, you can use the login
251 form to authenticate yourself to the web interface. Note that this
252 is your primary DisOrder password, which (in old installations) may
253 differ from your original web password.</p>
255 <p><b>2</b>. When you are logged in, this screen instead has a form
256 to change your email address or password, and a logout button.</p>
260 <h2 class=sidebarlink>Troubleshooting</h2>
262 <div class=helpsection>
264 <p>If you cannot play a track, or it does not appear in the
265 database even after a rescan, check the following things:</p>
269 <li>Are there any error messages in the system log? The server
270 logs to <tt>LOG_DAEMON</tt>, which typically ends up in
271 <i>/var/log/daemon.log</i> or <i>/var/log/messages</i>, though
272 this depends on local configuration.
274 <li>Is the track in a known format? Have a look at the
275 configuration file for the formats recognized by the local
276 installation. The filename matching is case-sensitive.
278 <li>Do permissions on the track allow the server to read it?
280 <li>Do the permissions on the containing directories allow the
281 server to read and execute them?
285 <p>The user the server runs as is determined by the <tt>user</tt>
286 directive in the configuration file. The README recommends using
287 <b>jukebox</b> for this purpose but it could be different
292 <h2 class=sidebarlink>Man Pages</h2>
294 <div class=helpsection>
296 <p><a href="@url@?action=disorder_config.5">disorder_config(5)</a> -
299 <p><a href="@url@?action=disorder.1">disorder(1)</a> - command line
302 <p><a href="@url@?action=disobedience.1">disobedience(1)</a> - GTK+
305 <p><a href="@url@?action=disorderd.8">disorderd(8)</a> - server</p>
307 <p><a href="@url@?action=disorder-dump.8">disorder-dump(8)</a> -
308 dump/restore preferences database</p>
310 <p><a href="@url@?action=disorder.3">disorder(3)</a> - C API</p>
312 <p><a href="@url@?action=disorder_protocol.5">disorder_protocol(5)</a> -
313 DisOrder control protocol</p>
325 sgml-always-quote-attributes:nil