Mercurial > mplayer.hg
annotate DOCS/xml/en/ports.xml @ 11531:56abcf68b760
link fixes
author | diego |
---|---|
date | Sat, 29 Nov 2003 00:52:06 +0000 |
parents | 49de4a85957f |
children | d480f7e36b74 |
rev | line source |
---|---|
9675 | 1 <?xml version="1.0" encoding="iso-8859-1"?> |
10913
49b1a67e7381
Add revision keyword to english xml files, to ease translation synchronization
lumag
parents:
10909
diff
changeset
|
2 <!-- $Revision$ --> |
9675 | 3 <chapter id="ports" xreflabel="Ports"> |
4 <title>Ports</title> | |
5 | |
6 <sect1 id="linux"> | |
7 <title>Linux</title> | |
8 <para> | |
9 The main development platform is Linux on x86, although | |
10 <application>MPlayer</application> works on many other Linux ports. | |
11 Binary packages of MPlayer are available from several sources. However, | |
12 <emphasis role="bold">none of these packages are supported</emphasis>. | |
13 Report problems to the authors, not to us. | |
14 </para> | |
15 | |
16 <sect2 id="debian"> | |
17 <title>Debian packaging</title> | |
18 <para> | |
19 To build a Debian package, run the following command in the MPlayer | |
20 source directory: | |
21 <screen>fakeroot debian/rules binary</screen> | |
22 As root you can then install the <filename>.deb</filename> package as usual: | |
23 <screen>dpkg -i ../mplayer_<replaceable>version</replaceable>.deb</screen> | |
24 </para> | |
25 | |
26 <para> | |
27 Christian Marillat has been making unofficial Debian MPlayer, MEncoder and font | |
28 packages for a while, you can (apt-)get them from his | |
29 <ulink url="http://marillat.free.fr/">homepage</ulink>. | |
30 </para> | |
31 </sect2> | |
32 | |
33 <sect2 id="rpm"> | |
34 <title>RPM packaging</title> | |
35 <para> | |
36 Dominik Mierzejewski created and maintains official Red Hat RPM packages of | |
37 <application>MPlayer</application>. They are available from his | |
38 <ulink url="http://www.piorunek.pl/~dominik/linux/pkgs/mplayer/">homepage</ulink>. | |
39 </para> | |
40 | |
41 <para> | |
42 Mandrake RPM packages are available from the <ulink url="http://plf.zarb.org/">P.L.F.</ulink>. | |
11518 | 43 SuSE used to include a crippled version of MPlayer in their distribution. |
44 They have removed it in their latest releases. You can get working RPMs | |
10277 | 45 from <ulink url="http://packman.links2linux.de/?action=128">links2linux.de</ulink>. |
9675 | 46 </para> |
47 </sect2> | |
48 | |
49 <sect2 id="arm"> | |
50 <title>ARM</title> | |
51 <para> | |
52 MPlayer works on Linux PDAs with ARM CPU e.g. Sharp Zaurus, Compaq Ipaq. The | |
53 easiest way to obtain MPlayer is to get it from one of the | |
54 <ulink url="http://www.openzaurus.org">OpenZaurus</ulink> package feeds. If | |
55 you want to compile it yourself, you should look at the | |
56 <ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/mplayer?nav=index.html|src/.|src/packages">MPlayer</ulink> | |
57 and the | |
58 <ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/libavcodec?nav=index.html|src/.|src/packages">libavcodec</ulink> | |
59 directory in the OpenZaurus distribution buildroot. These always have the latest | |
60 Makefile and patches used for building a CVS MPlayer with libavcodec. | |
61 If you need a GUI frontend, you can use xmms-embedded. | |
62 </para> | |
63 </sect2> | |
64 </sect1> | |
65 | |
66 <sect1 id="bsd"> | |
67 <title>*BSD</title> | |
68 <para> | |
69 <application>MPlayer</application> runs on FreeBSD, OpenBSD, NetBSD, | |
70 BSD/OS and Darwin. There are ports/pkgsrc/fink/etc versions of MPlayer | |
71 available that are probably easier to use than our raw sources. | |
72 </para> | |
73 | |
74 <para> | |
75 To build MPlayer you will need GNU make (gmake - native BSD make | |
76 will not work) and a recent version of binutils. | |
77 </para> | |
78 | |
79 <para> | |
80 If MPlayer complains about not finding <filename>/dev/cdrom</filename> or | |
11100 | 81 <filename>/dev/dvd</filename>, create an appropriate symbolic link: |
10958 | 82 <screen>ln -s /dev/<replaceable>your_cdrom_device</replaceable> /dev/cdrom</screen> |
9675 | 83 </para> |
84 | |
85 <para> | |
86 To use Win32 DLLs with MPlayer you will need to re-compile the kernel with | |
87 "<envar>option USER_LDT</envar>" (unless you run FreeBSD-CURRENT, | |
88 where this is the default). | |
89 </para> | |
90 | |
91 | |
92 <sect2 id="freebsd"> | |
93 <title>FreeBSD</title> | |
94 <para> | |
95 If your CPU has SSE, recompile your kernel with | |
96 "<envar>options CPU_ENABLE_SSE</envar>" (FreeBSD-STABLE or kernel | |
97 patches required). | |
98 </para> | |
99 </sect2> | |
100 | |
101 <sect2 id="openbsd"> | |
102 <title>OpenBSD</title> | |
103 <para> | |
104 Due to limitations in different versions of gas (relocation vs MMX), you | |
105 will need to compile in two steps: First make sure that the non-native as | |
106 is first in your <envar>$PATH</envar> and do a <command>gmake -k</command>, then | |
107 make sure that the native version is used and do <command>gmake</command>. | |
108 </para> | |
109 </sect2> | |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
110 |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
111 <sect2 id="darwin"> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
112 <title>Darwin</title> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
113 <para> |
11348 | 114 See the <link linkend="macos">Mac OS</link> section. |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
115 </para> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
116 </sect2> |
9675 | 117 </sect1> |
118 | |
119 <sect1 id="solaris"> | |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
120 <title>Sun Solaris</title> |
9675 | 121 <para> |
122 <application>MPlayer</application> should work on Solaris 2.6 or newer. | |
123 </para> | |
124 | |
125 <para> | |
126 On <emphasis role="bold">UltraSPARCs</emphasis>, MPlayer takes advantage of their | |
127 <emphasis role="bold">VIS</emphasis> extensions (equivalent to MMX), currently | |
128 only in <emphasis>libmpeg2</emphasis>, <emphasis>libvo</emphasis> and | |
129 <emphasis>libavcodec</emphasis>, but not in mp3lib. You can watch a VOB file | |
130 on a 400MHz CPU. You'll need | |
131 <ulink url="http://www.sun.com/sparc/vis/mediaLib.html">mLib</ulink> installed. | |
132 </para> | |
133 | |
134 <para> | |
135 To build the package you will need GNU <application>make</application> | |
136 (<filename>gmake</filename>, <filename>/opt/sfw/gmake</filename>), native | |
137 Solaris make will not work. Typical error you get when building with | |
138 Solaris' make instead of GNU make: | |
139 <screen> | |
140 % /usr/ccs/bin/make | |
141 make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen | |
142 </screen> | |
143 </para> | |
144 | |
145 <para> | |
146 On Solaris SPARC, you need the GNU C/C++ Compiler; it does not matter if | |
147 GNU C/C++ compiler is configured with or without the GNU assembler. | |
148 </para> | |
149 | |
150 <para> | |
151 On Solaris x86, you need the GNU assembler and the GNU C/C++ compiler, | |
152 configured to use the GNU assembler! The mplayer code on the x86 platform | |
153 makes heavy use of MMX, SSE and 3DNOW! instructions that cannot be compiled | |
154 using Sun's assembler <filename>/usr/ccs/bin/as</filename>. | |
155 </para> | |
156 | |
157 <para>The <filename>configure</filename> script tries to find out, which | |
158 assembler program is used by your "gcc" command (in case the autodetection | |
11271
252fb0cf331a
spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents:
11100
diff
changeset
|
159 fails, use the <option>--as=/wherever/you/have/installed/gnu-as</option> |
9675 | 160 option to tell the <filename>configure</filename> script where it can find GNU |
161 "as" on your system). | |
162 </para> | |
163 | |
164 <para> | |
165 Error message from <filename>configure</filename> on a Solaris x86 system using | |
166 GCC without GNU assembler: | |
167 <screen> | |
168 % configure | |
169 ... | |
170 Checking assembler (/usr/ccs/bin/as) ... , failed | |
171 Please upgrade(downgrade) binutils to 2.10.1... | |
172 </screen> | |
173 (Solution: Install and use a gcc configured with <option>--with-as=gas</option>) | |
174 </para> | |
175 | |
176 <para> | |
177 Typical error you get when building with a GNU C compiler that does not use GNU as: | |
178 <screen> | |
179 % gmake | |
180 ... | |
181 gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math | |
182 -fomit-frame-pointer -I/usr/local/include -o mplayer.o mplayer.c | |
183 Assembler: mplayer.c | |
184 "(stdin)", line 3567 : Illegal mnemonic | |
185 "(stdin)", line 3567 : Syntax error | |
186 ... more "Illegal mnemonic" and "Syntax error" errors ... | |
187 </screen> | |
188 </para> | |
189 | |
190 <para> | |
191 Due to bugs in Solaris 8, you may not be able to play DVD discs larger than 4 GB: | |
192 </para> | |
193 | |
194 <itemizedlist> | |
195 <listitem><para> | |
196 The sd(7D) driver on Solaris 8 x86 has a bug when accessing a disk block >4GB | |
197 on a device using a logical blocksize != DEV_BSIZE (i.e. CD-ROM and DVD media). | |
198 Due to a 32Bit int overflow, a disk address modulo 4GB is accessed | |
199 (<ulink url="http://groups.yahoo.com/group/solarisonintel/message/22516"/>). | |
200 This problem does not exist in the SPARC version of Solaris 8. | |
201 </para></listitem> | |
202 | |
203 <listitem><para> | |
204 A similar bug is present in the hsfs(7FS) filesystem code (aka ISO9660), | |
205 hsfs may not not support partitions/disks larger than 4GB, all data is | |
206 accessed modulo 4GB | |
207 (<ulink url="http://groups.yahoo.com/group/solarisonintel/message/22592"/>). | |
208 The hsfs problem can be fixed by installing patch 109764-04 (sparc) / 109765-04 (x86). | |
209 </para></listitem> | |
210 </itemizedlist> | |
211 | |
212 <para> | |
213 On Solaris with an UltraSPARC CPU, you can get some extra speed by using the | |
214 CPU's VIS instructions for certain time consuming operations. VIS acceleration | |
215 can be used in MPlayer by calling functions in Sun's | |
216 <ulink url="http://www.sun.com/sparc/vis/mediaLib.html">mediaLib</ulink>. | |
217 </para> | |
218 | |
219 <para> | |
220 VIS accelerated operations from mediaLib are used for mpeg2 video decoding | |
221 and for color space conversion in the video output drivers. | |
222 </para> | |
223 </sect1> | |
224 | |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
225 <sect1 id="irix"> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
226 <title>Silicon Graphics Irix</title> |
9675 | 227 <para> |
228 You can either try to install the GNU install program, and (if you did | |
229 not put it in your global path) then point to the location with: | |
11485 | 230 <screen>./configure --with-install=/path/and/name/of/install</screen> |
9675 | 231 </para> |
232 | |
233 <para> | |
234 Or you can use the default install delivered with IRIX 6.5 in which case | |
235 you will have to edit the <filename>Makefile</filename> by hand a little bit. | |
236 Change the following two lines: | |
237 <programlisting> | |
238 $(INSTALL) -c -m 644 DOCS/mplayer.1 $(MANDIR)/man1/mplayer.1 | |
239 | |
240 $(INSTALL) -c -m 644 etc/codecs.conf $(CONFDIR)/codecs.conf | |
241 </programlisting> | |
242 to: | |
243 <programlisting> | |
244 $(INSTALL) -m 644 mplayer.1 $(MANDIR)/man1/ | |
245 | |
246 $(INSTALL) -m 644 codecs.conf $(CONFDIR)/ | |
247 </programlisting> | |
248 And then do (from within the MPlayer source dir): | |
249 <screen>cp DOCS/mplayer.1 . ; cp etc/codecs.conf .</screen> | |
250 and then go on with building and installing. | |
251 </para> | |
252 </sect1> | |
253 | |
254 <sect1 id="qnx"> | |
255 <title>QNX</title> | |
256 <para> | |
257 Works. You'll need to download SDL for QNX, and install it. Then run | |
258 <application>MPlayer</application> with <option>-vo sdl:photon</option> | |
259 and <option>-ao sdl:nto</option> options, and it should be fast. | |
260 </para> | |
261 | |
262 <para> | |
263 The <option>-vo x11</option> output will be even slower than on Linux, | |
264 since QNX has only X <emphasis>emulation</emphasis> which is VERY slow. Use SDL. | |
265 </para> | |
266 </sect1> | |
267 | |
10561 | 268 <sect1 id="windows"> |
269 <title>Windows</title> | |
270 | |
271 <para>Yes, MPlayer runs on Windows under | |
272 <ulink url="http://www.cygwin.com/">Cygwin</ulink> and | |
273 <ulink url="http://www.mingw.org/">MinGW</ulink>. | |
274 It does not have a GUI yet, but the command line version is almost completely | |
275 functional. <ulink url="../../tech/patches.txt">Patches</ulink> are always welcome. | |
276 You should check out the | |
277 <ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-cygwin/">mplayer-cygwin</ulink> | |
278 mailing list for help and latest information.</para> | |
279 | |
280 <para>Best results are achieved with the native DirectX video output driver | |
281 (<option>-vo directx</option>) and the native Windows waveout audio driver | |
282 (<option>-ao win32</option>) as OpenGL does not work and SDL is known to | |
283 distort sound and image or crash on some systems. You can make the movie | |
284 window stay on top with <option>-vo directx:ontop</option>. If the image is | |
285 distorted, try turning off hardware acceleration with | |
286 <option>-vo directx:noaccel</option>. Download | |
287 <ulink url="http://www.videolan.org/vlc/dx7headers.tgz">DirectX 7 header files</ulink> | |
288 to compile the DirectX video output driver.</para> | |
9675 | 289 |
11325 | 290 <para>You can use Win32 codecs and Real Win32 codecs (not Real Linux codecs) |
291 if you want to. Put the codecs somewhere in your path or pass | |
10650
6f51d17ecfc8
Binary codecs finally work as they should on Windows.
diego
parents:
10645
diff
changeset
|
292 <option>--with-codecsdir=c:/path/to/your/codecs</option> (alternatively |
6f51d17ecfc8
Binary codecs finally work as they should on Windows.
diego
parents:
10645
diff
changeset
|
293 <option>--with-codecsdir=/path/to/your/codecs</option> only on Cygwin) to |
6f51d17ecfc8
Binary codecs finally work as they should on Windows.
diego
parents:
10645
diff
changeset
|
294 <filename>configure</filename>. We have had some reports that Real DLLs need |
6f51d17ecfc8
Binary codecs finally work as they should on Windows.
diego
parents:
10645
diff
changeset
|
295 to be writable by the user running MPlayer, but only on some systems. Try |
11325 | 296 making them writable if you have problems. QuickTime DLLs also work, but you |
297 will have to put them in your Windows system directory | |
298 (<filename class="directory">C:\Windows\system\</filename> or similar).</para> | |
10645 | 299 |
300 <para>The Cygwin/MinGW console is rather slow. Redirecting output or using | |
301 the <option>-quiet</option> option has been reported to improve performance | |
302 on some systems. Direct rendering (<option>-dr</option>) may also help. | |
303 You can prevent OSD flicker through double buffering with the | |
304 <option>-double</option> option. If playback is jerky, try | |
305 <option>-autosync 100</option>. If some of these options help you, you | |
306 may want to put them in your config file.</para> | |
10561 | 307 |
11531 | 308 <para>Sascha Sommer releases official Windows binaries from time to time, |
309 Joey Parrish makes unofficial Windows packages complete with installer. | |
310 Look for these in the Windows section of | |
311 <ulink url="http://www.mplayerhq.hu/homepage/projects.html">our projects page</ulink>.</para> | |
9675 | 312 |
10561 | 313 <sect2 id="cygwin"> |
314 <title>Cygwin</title> | |
315 | |
11336 | 316 <para>Cygwin versions prior to 1.5.0 do not include <filename>inttypes.h</filename>. |
317 Put this | |
11338 | 318 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32-beta/contrib/inttypes.h">inttypes.h</ulink> |
11336 | 319 in <filename class="directory">/usr/include/</filename> in order to |
11355 | 320 make <application>MPlayer</application> compile.</para> |
10561 | 321 |
322 <para>DirectX header files need to be extracted to <filename class="directory">/usr/include/</filename> or | |
323 <filename class="directory">/usr/local/include/</filename>.</para> | |
324 | |
325 <para>Instructions and files for making SDL run under Cygwin can be found on the | |
326 <ulink url="http://www.libsdl.org/extras/win32/cygwin/">libsdl site</ulink>.</para> | |
9675 | 327 |
10561 | 328 <para>You can play VCDs by playing the <filename>.DAT</filename> or <filename>.MPG</filename> files |
329 that Windows exposes on VCDs. It works like this (adjust for the drive letter | |
330 of your CD-ROM):</para> | |
331 | |
332 <screen>mplayer d:/mpegav/avseq01.dat</screen> | |
9675 | 333 |
334 <screen>mplayer /cygdrive/d/MPEG2/AVSEQ01.MPG</screen> | |
335 | |
10998
b96a23f1fa24
More precise wording as suggested by Maciej Paszta <macp@wp.pl>.
diego
parents:
10958
diff
changeset
|
336 <para>DVDs also work, adjust <option>-dvd-device</option> for the drive letter |
b96a23f1fa24
More precise wording as suggested by Maciej Paszta <macp@wp.pl>.
diego
parents:
10958
diff
changeset
|
337 of your DVD-ROM:</para> |
10561 | 338 |
10184
b6c63ab184a4
Changed a few remaining -dvd and -vcd options to dvd:// and vcd://.
diego
parents:
9675
diff
changeset
|
339 <screen>mplayer dvd://<title> -dvd-device '\\.\d:'</screen> |
10561 | 340 |
341 </sect2> | |
342 | |
343 | |
344 <sect2 id="mingw"> | |
345 <title>MinGW</title> | |
346 | |
347 <para>Installing a version of MinGW that could compile MPlayer used to be quite | |
10909 | 348 tricky, but it works out of the box now. Just install MinGW 3.1.0 or later |
349 and MSYS 1.0.9 or later and tell the MSYS postinstall that MinGW is | |
350 installed.</para> | |
9675 | 351 |
10909 | 352 <para>If you use a version of MinGW before 3.1.0, you need to replace |
353 <filename>/mingw/include/sys/types.h</filename> with this | |
354 <ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32-beta/contrib/types.h"><filename>types.h</filename></ulink>.</para> | |
10561 | 355 |
356 <para>Extract DirectX header files to <filename class="directory">/mingw/include/</filename>.</para> | |
10191 | 357 |
10561 | 358 <para>VCDs and DVDs work almost like Cygwin (adjust for the drive letter of your |
10998
b96a23f1fa24
More precise wording as suggested by Maciej Paszta <macp@wp.pl>.
diego
parents:
10958
diff
changeset
|
359 CD-ROM/DVD-ROM):</para> |
10561 | 360 |
361 <screen>mplayer d:/mpegav/avseq01.dat</screen> | |
362 | |
363 <screen>mplayer /d/MPEG2/AVSEQ01.MPG</screen> | |
364 | |
365 <screen>mplayer dvd://<title> -dvd-device /d/</screen> | |
366 | |
367 </sect2> | |
368 | |
369 | |
9675 | 370 </sect1> |
371 | |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
372 <sect1 id="macos"> |
11348 | 373 <title>Mac OS</title> |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
374 <para> |
11348 | 375 Only Mac OS X 10.2 and up is supported by the "raw" |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
376 <application>MPlayer</application> source. Feel free to make support for older |
11348 | 377 Mac OS versions and send patches! |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
378 </para> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
379 |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
380 <para> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
381 Apple's modified GCC 3.x is preferred for compiling |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
382 <application>MPlayer</application> especially when using libavcodec as Apple's |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
383 modified GCC 2.95.x doesn't support C99 syntax well. |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
384 </para> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
385 |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
386 <para> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
387 One can get an Aqua GUI for <application>MPlayer</application> together with |
11355 | 388 compiled <application>MPlayer</application> binaries for Mac OS X from the |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
389 <ulink url="http://mplayerosx.sf.net/">MPlayerOSX</ulink> project. |
11341 | 390 </para> |
11340
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
391 </sect1> |
5d1438e8511a
a bit of consistency changes and new macos&darwin sections
alex
parents:
11338
diff
changeset
|
392 |
9675 | 393 </chapter> |