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