[disorder] / templates / help.tmpl

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<!--
This file is part of DisOrder.
Copyright (C) 2004-2008 Richard Kettlewell

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA
-->
<html>
 <head>
@stdhead{help}
 </head>
 <body>
@stdmenu{help}
   <h1>@label{help.title}</h1>

   <h2 class=sectiontitle>Introduction</h2>

   <div class=section>

     <p>All screens in the DisOrder web interface have a set of
     hyperlinks at the top.  You can use these to visit the various
     screens described below.  Note that if you are not logged in some
     of these will be greyed out.  The link for the currently active
     screen is highlighted.</p>

   </div>
  
   <h2 class=sectiontitle><a name=playing>Playing</a></h2>

   <div class=section>

    <p>This screen displays the currently playing track (if there is one) and
    lists all the tracks in the queue (the track that will be played soonest
    being listed first.)  Where possible, estimated start times are
    given.</p>

    <p>Each track has a <img class=button src="@image{remove}"
    title="@label{playing.remove}" alt="@label{playing.remove}">
    button next to it.  For the currently playing track this can be
    used to stop playing the track before it has finished; this is
    called &ldquo;scratching&rdquo;.  For a track in the queue it
    removes the track from the queue.</p>

    <p>If you are not logged in, or if your user has limited rights,
    you may only be able to scratch or remove certain tracks (for
    instance, those you picked yourself).</p>

    <p>Artist and album names are hyperlinks to the relevant locations
    in the <a href="#choose">Choose</a> screen (see below).</p>

   </div>

   <h2 class=sectiontitle><a name=manage>Manage</a></h2>

   <div class=section>

    <p>This screen is almost identical to <a
    href="#playing">Playing</a> except that it includes extra
    management features.</p>

   <p>At the top of the screen are the following controls:</p>

   <ul>
    <li>Pause.  This button can be used to pause playing (provided the
    player supports it).  <img width=@width height=@height class=imgbutton
    src="@image{enabled}"> indicates that playing is paused,
    <img width=@width height=@height class=imgbutton
    src="@image{disabled}"> that it is not.</li>

    <li>Enable/disable random play.  If disabled then queued tracks
    will still be played but if the queue is empty nothing will be
    picked at random.  <img width=@width height=@height class=imgbutton
    src="@image{enabled}"> indicates that random play is
    enabled, <img width=@width height=@height class=imgbutton
    src="@image{disabled}"> that it is disabled.</li>

    <li>Enable/disable play.  If disabled then tracks in the queue
    will not be played, but will remain in the queue instead.  <img
    width=@width height=@height class=imgbutton src="@image{enabled}">
    indicates that play is enabled, <img width=@width height=@height
    class=imgbutton src="@image{disabled}"> that it is
    disabled.</li>

    <li>Volume control.  You can use the <img class=button
       src="@image{up}"
       title="@label{volume.up}"
       alt="@label{volume.up}"> and <img
       src="@image{down}"
       title="@label{volume.down}"
       alt="@label{volume.down}"> buttons to increase or
    decrease the volume, or enter new volume settings for the left
    and/or right speakers.</li>

   </ul>

   <p>Below this is the same table of current and queued tracks as for
    the main playing screen, but with extra buttons for managing the
    queue.
    The <img class=button src="@image{up}"
     title="@label{playing.up}" alt="@label{playing.up}"> and <img
     src="@image{down}" title="@label{playing.down}"
     alt="@label{playing.down}"> buttons on each track move that
    track around in the queue.  Similarly the <img class=button
     src="@image{upall}" title="@label{playing.upall}"
     alt="@label{playing.upall}"> and <img
     src="@image{downall}" title="@label{playing.downall}"
     alt="@label{playing.downall}"> buttons move each track to the head or
    tail of the queue.</p>

    <p>If you are not logged in, or if your user has limited rights,
    you may only be able to move certain tracks (for instance, those
    you picked yourself), and may not be able to adjust the volume,
    random play setting, etc.</p>

   </div>

   <h2 class=sectiontitle><a name=recent>Recent</a></h2>

   <div class=section>

    <p>This screen displays recently played tracks, most recent first.
    The <img class=button src="@image{edit}"
    title="@label{choose.prefs}" alt="@label{choose.prefs}">
    button can be used to edit the details for a track; see <a
    href="#prefs">Editing Preferences</a> below.</p>

    <p>The number of tracks remembered is controlled by the server
    configuration.  See the <span class=configuration>history</span>
    option in <a
    href="@url?action=disorder_config.5">disorder_config(5)</a> for
    more details.</p>

   </div>

   <h2 class=sectiontitle><a name=new>New</a></h2>

   <div class=section>

    <p>This screen displays tracks recently added to the database,
    most recent first.  The <img class=button
    src="@image{edit}" title="@label{choose.prefs}"
    alt="@label{choose.prefs}"> button can be used to edit the details
    for a track; see <a href="#prefs">Editing Preferences</a> below,
    and clicking on the track title will add it to the queue.</p>

    <p>The time tracks are remembered for is controlled by the server
    configuration.  See the <span
    class=configuration>noticed_history</span> option in <a
    href="@url?action=disorder_config.5">disorder_config(5)</a> for
    more details.</p>

   </div>

   <h2 class=sectiontitle><a name=choose>Choose</a></h2>

   <div class=section>

    <p>This screen allows you to choose a track to be played, by navigating
     through the directory structure of the tracks filesystem.

  @if{@eq{@label{menu.choosewhich}}{choosealpha}}
     {

     <p>At the top of the page is a list of first letters.  Click on
     any of these takes you to a list of directories starting with
     that letter.</p>

     <p>Below this is a search form.  You can enter one or more
     keywords here and select @label{search.search} and get a list of
     tracks containing all those keywords.  It is possible to limit
     search results to tracks with a particular tag, by using
     <b>tag:</b><i>TAG</i> among the search terms.  Select
     @label{search.clear} to clear the search results.</p>

     <p>Initially the rest of the page is empty.  However when you
     have selected an initial letter, you will see a list of the
     matching directories and files.  Select a directory to enter it,
     or a file to play it.
     
     } 
     {

     <p>At the top of the page is a search form.  You can enter one or
     more keywords here and select @label{search.search} and get a
     list of tracks containing all those keywords.  It is possible to
     limit search results to tracks with a particular tag, by using
     <b>tag:</b><i>TAG</i> among the search terms.</p>

     <p>Below this appears a list of top-level files and directories.
     Select a directory to enter it, or a file to play it.</p>
     
     }

     <p>The following icons will also appear:</p>
     
    <table class=helpbuttons>
     <tbody>
      <tr>
       <td><img
       class=button src="@image{edit}"
       title="@label{choose.prefs}"
       alt="@label{choose.prefs}"></td>
       <td>This button can be used to edit the details for a
       track; see <a href="#prefs">Editing Preferences</a> below.</td>
      </tr>
      <tr>
       <td><span class=button>@label{choose.playall}</span></td>
       <td>This button plays all the tracks in a directory,
       in order.  This is used to efficiently play a whole album.</td>
      </tr>
     </tbody>
    </table>
     
    <p>NB.  Some keywords, known as &ldquo;stopwords&rdquo;, are
    excluded from the search, and will never match.  See the <span
    class=configuration>stopword</span> option in <a
    href="@url?action=disorder_config.5">disorder_config(5)</a> for
    further details about this.</p>

    <p>This screen will may not be available if you are not logged in
    or if your user has limited rights.</p>

   </div>

   <h2 class=sectiontitle><a name=prefs>Editing Preferences</a></h2>

   <div class=section>

    <p>This screen, reached from <a href="#choose">Choose</a> or <a
    href="#recent">Recent</a>, is used to edit a track's preferences.
    Note that if you are not logged in, or your user has limited
    rights, you may not be able to edit track preferences.</p>
    
    <p>The form can be used to
    edit artist, album and title fields for the track as displayed; or
    to set the tags or weight for a track; or to enable or disable random play
    for the track.</p>

    <p>Tags are separated by commas and can contain any other printing
    characters (including spaces).  Leading and trailing spaces are
    not significant.</p>

    <p>Weights determine how likely a track is to be picked at
    random.  Tracks with higher weights are more likely to be picked.
    The default weight is 90000 and the maximum is 2147483647.</p>

    <p>By default, any track can be picked for random play.  The check
    box at the bottom can be used to selectivel enable or disable it
    for individual tracks.</p>

    <p>See <a
    href="@url?action=disorder_preferences.5">disorder_preferences(5)</a>
    for full documentation of track preferences.</p>
     
   </div>

  <h2 class=sectiontitle><a name=Login>Login</a></h2>

  <div class=section>

   <p>This screen has two different versions.</p>

   <p><b>1</b>. When no user is logged in, it has a login form and a
   registration form.  If you do not have a username and password,
   fill in and submit the registration form.  You will be emailed an
   email with a confirmation URL that you must visit.  Only after
   visiting this URL will your login become active.</p>

   <p>Once you have a username and password, you can use the login
   form to authenticate yourself to the web interface.  Note that this
   is your primary DisOrder password, which (in old installations) may
   differ from your original web password.</p>

   <p><b>2</b>. When you are logged in, this screen instead has a form
   to change your email address or password, and a logout button.</p>

  </div>

  <h2 class=sectiontitle>Troubleshooting</h2>

  <div class=section>

   <p>If you cannot play a track, or it does not appear in the
   database even after a rescan, check the following things:</p>

   <ul>

    <li>Are there any error messages in the system log?  The server
    logs to <span class=configuration>LOG_DAEMON</span>, which
    typically ends up in <i>/var/log/daemon.log</i> or
    <i>/var/log/messages</i>, though this depends on local
    configuration.

    <li>Is the track in a known format?  Out of the box, OGG, MP3,
     FLAC and WAV are supported.  You can look at the configuration
     file for additional formats recognized by the local installation.

    <li>Do permissions on the track allow the server to read it?  If
    the server cannot read it then it will not be able to play it.
     
    <li>Do the permissions on the containing directories allow the
    server to read and execute them?

   </ul>

   <p>The user the server runs as is determined by the <span
   class=configuration>user</span> directive in the configuration
   file.  The README recommends using <b>jukebox</b> for this purpose
   but it could be different locally.</p>

  </div>

   <h2 class=sectiontitle>Man Pages</h2>

   <div class=section>

    <p><a href="@url?action=disorder_config.5">disorder_config(5)</a> -
     configuration</p>

    <p><a href="@url?action=disorder_templates.5">disorder_templates(5)</a> -
     template language</p>

    <p><a href="@url?action=disorder_preferences.5">disorder_preferences(5)</a> -
     per-track and global preferences</p>

    <p><a href="@url?action=disorder.1">disorder(1)</a> - command line
     client</p>

    <p><a href="@url?action=disobedience.1">disobedience(1)</a> - GTK+
     client</p>

    <p><a href="@url?action=disorderd.8">disorderd(8)</a> - server</p>

    <p><a href="@url?action=disorder-dump.8">disorder-dump(8)</a> -
     dump/restore preferences database</p>

    <p><a href="@url?action=disorder.3">disorder(3)</a> - C API</p>

    <p><a href="@url?action=disorder_protocol.5">disorder_protocol(5)</a> -
     DisOrder control protocol</p>

   </div>

@credits
  </div>
 </body>
</html>
@discard{
Local variables:
mode:sgml
sgml-always-quote-attributes:nil
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
fill-column:79
End:
}@#
Commit	Line	Data
460b9539	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
	2	<!--
	3	This file is part of DisOrder.
8f9616f1	4	Copyright (C) 2004-2008 Richard Kettlewell
460b9539	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 2 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, 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.
	15
	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
	19	USA
	20	-->
	21	<html>
	22	<head>
0d0253c9	23	@stdhead{help}
460b9539	24	</head>
460b9539	25	<body>
0d0253c9	26	@stdmenu{help}
595b20dc	27	<h1>@label{help.title}</h1>
460b9539	28
5d30e04b	29	<h2 class=sectiontitle>Introduction</h2>
4a4c673c	30
5d30e04b	31	<div class=section>
4a4c673c	32
	33	<p>All screens in the DisOrder web interface have a set of
	34	hyperlinks at the top. You can use these to visit the various
	35	screens described below. Note that if you are not logged in some
21c8e53a	36	of these will be greyed out. The link for the currently active
21c8e53a	37	screen is highlighted.</p>
4a4c673c	38
	39	</div>
	40
5d30e04b	41	<h2 class=sectiontitle><a name=playing>Playing</a></h2>
460b9539	42
5d30e04b	43	<div class=section>
460b9539	44
	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
	48	given.</p>
	49
daf0351f RK	50	<p>Each track has a <img class=button src="@image{remove}"
daf0351f RK	51	title="@label{playing.remove}" alt="@label{playing.remove}">
21c8e53a	52	button next to it. For the currently playing track this can be
	53	used to stop playing the track before it has finished; this is
	54	called “scratching”. For a track in the queue it
	55	removes the track from the queue.</p>
460b9539	56
21c8e53a	57	<p>If you are not logged in, or if your user has limited rights,
	58	you may only be able to scratch or remove certain tracks (for
	59	instance, those you picked yourself).</p>
460b9539	60
21c8e53a	61	<p>Artist and album names are hyperlinks to the relevant locations
21c8e53a	62	in the <a href="#choose">Choose</a> screen (see below).</p>
460b9539	63
	64	</div>
	65
5d30e04b	66	<h2 class=sectiontitle><a name=manage>Manage</a></h2>
460b9539	67
5d30e04b	68	<div class=section>
460b9539	69
	70	<p>This screen is almost identical to <a
	71	href="#playing">Playing</a> except that it includes extra
	72	management features.</p>
	73
	74	<p>At the top of the screen are the following controls:</p>
	75
	76	<ul>
	77	<li>Pause. This button can be used to pause playing (provided the
0d0253c9 RK	78	player supports it). <img width=@width height=@height class=imgbutton
	79	src="@image{enabled}"> indicates that playing is paused,
	80	<img width=@width height=@height class=imgbutton
	81	src="@image{disabled}"> that it is not.</li>
460b9539	82
	83	<li>Enable/disable random play. If disabled then queued tracks
	84	will still be played but if the queue is empty nothing will be
0d0253c9 RK	85	picked at random. <img width=@width height=@height class=imgbutton
	86	src="@image{enabled}"> indicates that random play is
	87	enabled, <img width=@width height=@height class=imgbutton
	88	src="@image{disabled}"> that it is disabled.</li>
460b9539	89
	90	<li>Enable/disable play. If disabled then tracks in the queue
	91	will not be played, but will remain in the queue instead. <img
0d0253c9 RK	92	width=@width height=@height class=imgbutton src="@image{enabled}">
	93	indicates that play is enabled, <img width=@width height=@height
	94	class=imgbutton src="@image{disabled}"> that it is
460b9539	95	disabled.</li>
	96
	97	<li>Volume control. You can use the <img class=button
0d0253c9 RK	98	src="@image{up}"
	99	title="@label{volume.up}"
	100	alt="@label{volume.up}"> and <img
	101	src="@image{down}"
	102	title="@label{volume.down}"
	103	alt="@label{volume.down}"> buttons to increase or
460b9539	104	decrease the volume, or enter new volume settings for the left
	105	and/or right speakers.</li>
	106
	107	</ul>
	108
	109	<p>Below this is the same table of current and queued tracks as for
	110	the main playing screen, but with extra buttons for managing the
	111	queue.
0d0253c9 RK	112	The <img class=button src="@image{up}"
	113	title="@label{playing.up}" alt="@label{playing.up}"> and <img
	114	src="@image{down}" title="@label{playing.down}"
	115	alt="@label{playing.down}"> buttons on each track move that
460b9539	116	track around in the queue. Similarly the <img class=button
0d0253c9 RK	117	src="@image{upall}" title="@label{playing.upall}"
	118	alt="@label{playing.upall}"> and <img
	119	src="@image{downall}" title="@label{playing.downall}"
	120	alt="@label{playing.downall}"> buttons move each track to the head or
21c8e53a	121	tail of the queue.</p>
	122
	123	<p>If you are not logged in, or if your user has limited rights,
	124	you may only be able to move certain tracks (for instance, those
	125	you picked yourself), and may not be able to adjust the volume,
	126	random play setting, etc.</p>
460b9539	127
	128	</div>
	129
5d30e04b	130	<h2 class=sectiontitle><a name=recent>Recent</a></h2>
460b9539	131
5d30e04b	132	<div class=section>
460b9539	133
460b9539	134	<p>This screen displays recently played tracks, most recent first.
0d0253c9 RK	135	The <img class=button src="@image{edit}"
0d0253c9 RK	136	title="@label{choose.prefs}" alt="@label{choose.prefs}">
460b9539	137	button can be used to edit the details for a track; see <a
	138	href="#prefs">Editing Preferences</a> below.</p>
	139
	140	<p>The number of tracks remembered is controlled by the server
21c8e53a	141	configuration. See the <span class=configuration>history</span>
21c8e53a	142	option in <a
0d0253c9	143	href="@url?action=disorder_config.5">disorder_config(5)</a> for
21c8e53a	144	more details.</p>
460b9539	145
	146	</div>
	147
5d30e04b	148	<h2 class=sectiontitle><a name=new>New</a></h2>
78efa64e	149
5d30e04b	150	<div class=section>
78efa64e RK	151
	152	<p>This screen displays tracks recently added to the database,
	153	most recent first. The <img class=button
0d0253c9 RK	154	src="@image{edit}" title="@label{choose.prefs}"
0d0253c9 RK	155	alt="@label{choose.prefs}"> button can be used to edit the details
78efa64e RK	156	for a track; see <a href="#prefs">Editing Preferences</a> below,
	157	and clicking on the track title will add it to the queue.</p>
	158
	159	<p>The time tracks are remembered for is controlled by the server
21c8e53a	160	configuration. See the <span
21c8e53a	161	class=configuration>noticed_history</span> option in <a
0d0253c9	162	href="@url?action=disorder_config.5">disorder_config(5)</a> for
78efa64e RK	163	more details.</p>
	164
	165	</div>
	166
5d30e04b	167	<h2 class=sectiontitle><a name=choose>Choose</a></h2>
460b9539	168
5d30e04b	169	<div class=section>
460b9539	170
460b9539	171	<p>This screen allows you to choose a track to be played, by navigating
0e2b222f RK	172	through the directory structure of the tracks filesystem.
	173
	174	@if{@eq{@label{menu.choosewhich}}{choosealpha}}
	175	{
	176
	177	<p>At the top of the page is a list of first letters. Click on
	178	any of these takes you to a list of directories starting with
	179	that letter.</p>
	180
	181	<p>Below this is a search form. You can enter one or more
	182	keywords here and select @label{search.search} and get a list of
	183	tracks containing all those keywords. It is possible to limit
	184	search results to tracks with a particular tag, by using
	185	<b>tag:</b><i>TAG</i> among the search terms. Select
	186	@label{search.clear} to clear the search results.</p>
	187
	188	<p>Initially the rest of the page is empty. However when you
	189	have selected an initial letter, you will see a list of the
	190	matching directories and files. Select a directory to enter it,
	191	or a file to play it.
	192
	193	}
	194	{
	195
	196	<p>At the top of the page is a search form. You can enter one or
	197	more keywords here and select @label{search.search} and get a
	198	list of tracks containing all those keywords. It is possible to
	199	limit search results to tracks with a particular tag, by using
	200	<b>tag:</b><i>TAG</i> among the search terms.</p>
	201
	202	<p>Below this appears a list of top-level files and directories.
	203	Select a directory to enter it, or a file to play it.</p>
	204
	205	}
	206
	207	<p>The following icons will also appear:</p>
	208
460b9539	209	<table class=helpbuttons>
	210	<tbody>
	211	<tr>
3225872d	212	<td><img
0d0253c9 RK	213	class=button src="@image{edit}"
	214	title="@label{choose.prefs}"
	215	alt="@label{choose.prefs}"></td>
3225872d	216	<td>This button can be used to edit the details for a
460b9539	217	track; see <a href="#prefs">Editing Preferences</a> below.</td>
	218	</tr>
	219	<tr>
595b20dc	220	<td><span class=button>@label{choose.playall}</span></td>
3225872d	221	<td>This button plays all the tracks in a directory,
460b9539	222	in order. This is used to efficiently play a whole album.</td>
	223	</tr>
	224	</tbody>
	225	</table>
0e2b222f RK	226
	227	<p>NB. Some keywords, known as “stopwords”, are
	228	excluded from the search, and will never match. See the <span
	229	class=configuration>stopword</span> option in <a
	230	href="@url?action=disorder_config.5">disorder_config(5)</a> for
	231	further details about this.</p>
460b9539	232
21c8e53a	233	<p>This screen will may not be available if you are not logged in
	234	or if your user has limited rights.</p>
	235
460b9539	236	</div>
460b9539	237
5d30e04b	238	<h2 class=sectiontitle><a name=prefs>Editing Preferences</a></h2>
460b9539	239
5d30e04b	240	<div class=section>
460b9539	241
460b9539	242	<p>This screen, reached from <a href="#choose">Choose</a> or <a
21c8e53a	243	href="#recent">Recent</a>, is used to edit a track's preferences.
	244	Note that if you are not logged in, or your user has limited
	245	rights, you may not be able to edit track preferences.</p>
460b9539	246
4a4c673c	247	<p>The form can be used to
68a1bff0 RK	248	edit artist, album and title fields for the track as displayed; or
68a1bff0 RK	249	to set the tags or weight for a track; or to enable or disable random play
460b9539	250	for the track.</p>
	251
	252	<p>Tags are separated by commas and can contain any other printing
	253	characters (including spaces). Leading and trailing spaces are
	254	not significant.</p>
	255
68a1bff0 RK	256	<p>Weights determine how likely a track is to be picked at
	257	random. Tracks with higher weights are more likely to be picked.
	258	The default weight is 90000 and the maximum is 2147483647.</p>
	259
21c8e53a	260	<p>By default, any track can be picked for random play. The check
	261	box at the bottom can be used to selectivel enable or disable it
	262	for individual tracks.</p>
460b9539	263
3d1452ab RK	264	<p>See <a
	265	href="@url?action=disorder_preferences.5">disorder_preferences(5)</a>
	266	for full documentation of track preferences.</p>
	267
460b9539	268	</div>
460b9539	269
5d30e04b	270	<h2 class=sectiontitle><a name=Login>Login</a></h2>
460b9539	271
5d30e04b	272	<div class=section>
460b9539	273
4a4c673c	274	<p>This screen has two different versions.</p>
460b9539	275
4a4c673c	276	<p><b>1</b>. When no user is logged in, it has a login form and a
	277	registration form. If you do not have a username and password,
	278	fill in and submit the registration form. You will be emailed an
	279	email with a confirmation URL that you must visit. Only after
	280	visiting this URL will your login become active.</p>
460b9539	281
4a4c673c	282	<p>Once you have a username and password, you can use the login
	283	form to authenticate yourself to the web interface. Note that this
	284	is your primary DisOrder password, which (in old installations) may
	285	differ from your original web password.</p>
	286
	287	<p><b>2</b>. When you are logged in, this screen instead has a form
	288	to change your email address or password, and a logout button.</p>
460b9539	289
4a4c673c	290	</div>
460b9539	291
5d30e04b	292	<h2 class=sectiontitle>Troubleshooting</h2>
460b9539	293
5d30e04b	294	<div class=section>
460b9539	295
	296	<p>If you cannot play a track, or it does not appear in the
	297	database even after a rescan, check the following things:</p>
	298
	299	<ul>
	300
	301	<li>Are there any error messages in the system log? The server
21c8e53a	302	logs to <span class=configuration>LOG_DAEMON</span>, which
	303	typically ends up in <i>/var/log/daemon.log</i> or
	304	<i>/var/log/messages</i>, though this depends on local
	305	configuration.
460b9539	306
21c8e53a	307	<li>Is the track in a known format? Out of the box, OGG, MP3,
	308	FLAC and WAV are supported. You can look at the configuration
	309	file for additional formats recognized by the local installation.
460b9539	310
21c8e53a	311	<li>Do permissions on the track allow the server to read it? If
21c8e53a	312	the server cannot read it then it will not be able to play it.
460b9539	313
	314	<li>Do the permissions on the containing directories allow the
	315	server to read and execute them?
	316
	317	</ul>
	318
21c8e53a	319	<p>The user the server runs as is determined by the <span
	320	class=configuration>user</span> directive in the configuration
	321	file. The README recommends using <b>jukebox</b> for this purpose
	322	but it could be different locally.</p>
460b9539	323
	324	</div>
	325
5d30e04b	326	<h2 class=sectiontitle>Man Pages</h2>
460b9539	327
5d30e04b	328	<div class=section>
460b9539	329
0d0253c9	330	<p><a href="@url?action=disorder_config.5">disorder_config(5)</a> -
460b9539	331	configuration</p>
460b9539	332
3e1616b6 RK	333	<p><a href="@url?action=disorder_templates.5">disorder_templates(5)</a> -
	334	template language</p>
	335
3d1452ab RK	336	<p><a href="@url?action=disorder_preferences.5">disorder_preferences(5)</a> -
	337	per-track and global preferences</p>
	338
0d0253c9	339	<p><a href="@url?action=disorder.1">disorder(1)</a> - command line
460b9539	340	client</p>
460b9539	341
0d0253c9	342	<p><a href="@url?action=disobedience.1">disobedience(1)</a> - GTK+
460b9539	343	client</p>
460b9539	344
0d0253c9	345	<p><a href="@url?action=disorderd.8">disorderd(8)</a> - server</p>
460b9539	346
0d0253c9	347	<p><a href="@url?action=disorder-dump.8">disorder-dump(8)</a> -
460b9539	348	dump/restore preferences database</p>
460b9539	349
0d0253c9	350	<p><a href="@url?action=disorder.3">disorder(3)</a> - C API</p>
460b9539	351
0d0253c9	352	<p><a href="@url?action=disorder_protocol.5">disorder_protocol(5)</a> -
460b9539	353	DisOrder control protocol</p>
	354
	355	</div>
	356
0d0253c9	357	@credits
460b9539	358	</div>
	359	</body>
	360	</html>
0d0253c9	361	@discard{
460b9539	362	Local variables:
	363	mode:sgml
	364	sgml-always-quote-attributes:nil
	365	sgml-indent-step:1
	366	sgml-indent-data:t
0d0253c9 RK	367	indent-tabs-mode:nil
0d0253c9 RK	368	fill-column:79
460b9539	369	End:
0d0253c9	370	}@#