summaryrefslogtreecommitdiffstats
path: root/doc/en/howto-installation.docbook
blob: 5dad72d1fe498b30f6b4d37ce80f07df978103e4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
<sect1 id="howto-installation">
<title>Installation</title>

<sect2 id="howto-installation-dependencies">
<title>Dependencies</title>

<sect3 id="howto-installation-mplayer">
<title>MPlayer</title>

<para>&kplayer; uses <ulink url="http://www.mplayerhq.hu/">&mplayer;</ulink>
as the multimedia backend for playing audio and video files and streams.
This ensures maximum variety of supported types of files and encodings.</para>

<para>You need to have &mplayer; version 1.0-pre8 or later. If there are good
binary packages for your distribution, use those. For example on Debian you
would do</para>

<para><userinput><command>echo</command>
'deb http://debian-multimedia.org unstable main' >>
<filename>/etc/apt/sources.list</filename></userinput></para>

<para><userinput><command>apt-get</command> update</userinput></para>

<para><userinput><command>apt-get</command> install mplayer</userinput></para>

<para>Substitute <literal>unstable</literal> for <literal>stable</literal> or
<literal>testing</literal> as required. The same repository also has a &kplayer;
package, so you can install it as well:</para>

<para><userinput><command>apt-get</command> install kplayer</userinput></para>

<para>As always <ulink
url="http://www.mplayerhq.hu/DOCS/HTML/en/faq.html#faq-compilation">compiling
from source</ulink> is an option.</para>

</sect3>

<sect3 id="howto-installation-xvideo">
<title>X11 and XVideo</title>

<para>X11 is required. The X Server and libraries released by X.org are
recommended. XFree86 may also work.</para>

<para>XVideo extension is recommended. You can check your
<filename>/etc/X11/xorg.conf</filename> or
<filename>/etc/X11/XF86Config-4</filename> file for a line that reads</para>

<para><userinput>Load "extmod"</userinput></para>

<para>This is the line that loads XVideo extension, so make sure it is not
disabled. Also check <filename>/var/log/Xorg.0.log</filename> or
<filename>/var/log/XFree86.0.log</filename> to make sure that XVideo is loaded
without error.</para>

<para>See the <link linkend="howto-configuration">Configuration
micro-HOWTO</link> if you want to use a different video output.</para>

</sect3>

<sect3 id="howto-installation-kde">
<title>Qt and KDE</title>

<para>&kplayer; 0.6 supports &kde; 3.1 and later, so you need to either run a
relatively recent &kde; (recommended) or at least have &kde; libraries and the
corresponding Qt libraries on your system.</para>

</sect3>

</sect2>

<sect2 id="howto-installation-installation">
<title>Installation</title>

<sect3 id="howto-installation-binary">
<title>Binary install</title>

<para>The recommended way to install &kplayer; is by using the binary package
built specifically for your distribution. The
<ulink url="http://kplayer.sourceforge.net/#downloads">Downloads section</ulink>
of the &kplayer; home page lists the available packages and repositories.</para>

</sect3>

<sect3 id="howto-installation-source">
<title>Compiling from source</title>

<para>If you cannot install a precompiled binary for any reason, you can compile
&kplayer; yourself. See the <link linkend="howto-compilation">Compilation
Micro-HOWTO</link> for instructions.</para>

</sect3>

<sect3 id="howto-installation-cvs">
<title>Compiling from CVS</title>
<para>If you want to try the latest and greatest &kplayer; features at the risk
of getting some parts of it broken, you can compile the latest
<acronym>CVS</acronym> code. See the
<link linkend="howto-compilation">Compilation Micro-HOWTO</link> for
details.</para>

</sect3>

</sect2>

</sect1>