Make a branch to make krunner Good Enough For Aaron™.
[kdebase/uwolfer.git] / runtime / doc / faq / sound.docbook
blobd7db604bcdea7d166afd878f45fc2e29dbde85ec
1 <chapter id="sound">
2 <title>Troubleshooting sound problems</title>
4 <para>&kde; uses the &arts; sound system which is complex and powerful,
5 making it difficult for some users to troubleshoot when things go
6 wrong. Here are some tips to help you diagnose what it's doing when your
7 sound misbehaves :</para>
9 <qandaset>
10 <qandaentry>
11 <question>
12 <para>How can I troubleshoot sound related problems in &kde;?</para>
13 </question>
15 <answer><para> To check that sound is working independently of &arts;, make
16 sure that <command>artsd</command> isn't running and then try playing sound
17 through <application>XMMS</application> or another multimedia application
18 that isn't a part of &kde;. If that application doesn't play sound, then
19 your general sound setup is probably broken and it's not a &kde;
20 problem.</para>
22 <para>Try playing sound with
23 <userinput><command>artsplay</command><option><replaceable>
24 /path/to/some/soundfile</replaceable></option></userinput>. Try various
25 formats, ogg, mp3 and wav.  Any error messages there might be useful in
26 pointing you in the right direction.</para>
28 <para>Try setting the &arts; output method to <acronym>OSS</acronym>. In the
29 &kcontrolcenter; go to <menuchoice><guimenu>Sound &amp; Multimedia</guimenu>
30 <guimenuitem>Sound System</guimenuitem></menuchoice>. On the
31 <guilabel>Hardware</guilabel> tab, under <guilabel>Select the audio
32 device</guilabel> choose <guilabel>Open Sound System</guilabel>. If you are
33 running <acronym>alsa</acronym> this will use the <acronym>OSS</acronym>
34 emulation, which may give better or worse results.</para>
36 <para>Running <userinput><command>artsd</command><option> -l
37 0</option></userinput> from a terminal will give you a lot of debug output,
38 some of which might help you to diagnose the problem. Trying this in
39 conjunction with using <command>artsplay</command> in a second terminal can give a wealth of information. If an <application>artsd</application> instance is already running, exit it with <userinput><command>artsshell
40 </command><parameter>terminate</parameter></userinput></para>
41 </answer>
42 </qandaentry>
43 <qandaentry>
44 <question><para>
45 I've upgraded to the latest version of &kde; keeping my old configuration, and my system sounds don't work anymore!</para></question>
46 <answer><para>
47 Assuming you've installed &arts; correctly and you still have the codecs installed your previous &kde; installation needed, chances are this is a small problem with your <filename>knotifyrc</filename>. To confirm this, try creating an entirely new user and seeing if system notifications work under the new account. If they do, try moving your <filename>$<envar>KDEHOME</envar>/share/config/knotifyrc</filename> out of the way for your original user to see if this solves the problem.
48 </para></answer>
49 </qandaentry>
52 </qandaset>
54 </chapter>