annotate README @ 16950:2ddf991d876d

typo, trailing whitespace
author diego
date Wed, 09 Nov 2005 00:18:48 +0000
parents 7c5d6c82e5ed
children 83c1acef76d5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12851
28347c761182 name change, codec download location
diego
parents: 12652
diff changeset
1 Welcome to MPlayer, The Movie Player. MPlayer can play most standard video
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
2 formats out of the box and almost all others with the help of external codecs.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
3 MPlayer currently works best from the command line, but visual feedback for
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
4 many functions is available from its onscreen status display (OSD), which is
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
5 also used for displaying subtitles. MPlayer also has a GUI with skin support and
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
6 several unofficial alternative graphical frontends are available.
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
7
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
8 MEncoder is a command line video encoder for advanced users that can be built
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
9 from the MPlayer source tree. An unofficial graphical frontend exists but is
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
10 not included.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
11
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
12 This document is for getting you started in a few minutes. It cannot answer all
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
13 of your questions. If you have problems, please read the documentation in
11183
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
14 DOCS/HTML/en/index.html, which should help you solve most of your problems.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
15 Also read the man page to learn how to use MPlayer.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
16
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
17
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
18 Requirements:
10228
3aba8a7ab91f Better wording as suggested by Rich.
diego
parents: 10222
diff changeset
19 - You need a working development environment that can compile programs.
3aba8a7ab91f Better wording as suggested by Rich.
diego
parents: 10222
diff changeset
20 On popular Linux distributions, this means having the glibc development
3aba8a7ab91f Better wording as suggested by Rich.
diego
parents: 10222
diff changeset
21 package(s) installed.
15834
1d2234930e70 mentioning xorg
alex
parents: 15176
diff changeset
22 - To compile MPlayer with X11 support, you need to have the X Window System
15872
diego
parents: 15834
diff changeset
23 development packages (like for XFree86 or X.Org) installed.
7674
7078f0139bed cosmetics
arpi
parents: 7320
diff changeset
24 - For the GUI you need the libpng and GTK 1.2 development packages.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
25
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
26
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
27 Before you start...
13914
efc819eee6e3 devices.html is no more, links updated.
diego
parents: 13905
diff changeset
28 Unless you know what are you doing, consult DOCS/HTML/en/video.html to see
efc819eee6e3 devices.html is no more, links updated.
diego
parents: 13905
diff changeset
29 which driver to use with your video card to get the best quality and
11183
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
30 performance. Most cards require special drivers not included with XFree86 to
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
31 drive their 2-D video acceleration features like YUV and scaling.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
32
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
33 A quick and incomplete list of recommendations:
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
34 - ATI cards: Get the GATOS drivers for X11/Xv or use VIDIX.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
35 - Matrox G200/G4x0/G550: Compile and use mga_vid for Linux, on BSD use VIDIX.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
36 - 3dfx Voodoo3/Banshee: Get XFree86 4.2.0+ for Xv or use the tdfxfb driver.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
37 - nVidia cards: Get the X11 driver from www.nvidia.com for Xv support.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
38 - NeoMagic cards: Get an Xv capable driver from our homepage as described in
13914
efc819eee6e3 devices.html is no more, links updated.
diego
parents: 13905
diff changeset
39 DOCS/HTML/en/video.html.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
40
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
41 Without accelerated video even an 800MHz P3 may be too slow to play DVDs.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
42
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
43
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
44 ______________________
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
45 STEP0: Getting MPlayer
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
46 ~~~~~~~~~~~~~~~~~~~~~~
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
47
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
48 Official releases, prereleases and CVS snapshots, as well as fonts for the
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
49 OSD, codec packages and a number of different skins for the GUI are available
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
50 from the download section of our homepage at
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
51
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
52 http://www.mplayerhq.hu/homepage/dload.html
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
53
12851
28347c761182 name change, codec download location
diego
parents: 12652
diff changeset
54 A set of fonts is necessary for the OSD and subtitles unless you are using
28347c761182 name change, codec download location
diego
parents: 12652
diff changeset
55 TrueType fonts, the GUI needs at least one skin and codec packages add support
28347c761182 name change, codec download location
diego
parents: 12652
diff changeset
56 for some more video and audio formats. MPlayer does not come with any of these
28347c761182 name change, codec download location
diego
parents: 12652
diff changeset
57 by default, you have to download and install them separately.
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
58
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
59 You can also get MPlayer via anonymous CVS. Issue the following commands to get
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
60 the latest sources:
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
61
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
62 cvs -d:pserver:anonymous@mplayerhq.hu:/cvsroot/mplayer login
11679
16c01dbca208 Pruning empty directories is a good idea and even better is using the
diego
parents: 11183
diff changeset
63 cvs -z3 -d:pserver:anonymous@mplayerhq.hu:/cvsroot/mplayer co -P main
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
64
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
65 When asked for a password, just hit enter. A directory named 'main' will be
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
66 created. You can later update your sources by saying
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
67
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
68 cvs -z3 update -dPA
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
69
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
70 from within that directory.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
71
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
72
16170
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
73 _________________________________________________________
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
74 STEP1: Installing FFmpeg libavcodec/libavutil/libavformat
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
75 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
76
12509
b77790d6b43e CVS snapshots come with libavcodec.
diego
parents: 11679
diff changeset
77 If you are using an official (pre)release or a CVS snapshot, skip this step,
b77790d6b43e CVS snapshots come with libavcodec.
diego
parents: 11679
diff changeset
78 since official releases include libavcodec. CVS sources do not include
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
79 libavcodec. To verify if you do have libavcodec or not, check if a subdirectory
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
80 named 'libavcodec' exists in the MPlayer source tree.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
81
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
82 The FFmpeg project provides libavcodec, a very portable codec collection (among
14025
571f08316b2d MPEG-X spelling
diego
parents: 13914
diff changeset
83 the supported formats is MPEG-4/DivX) with excellent quality and speed, that is
571f08316b2d MPEG-X spelling
diego
parents: 13914
diff changeset
84 the preferred MPEG-4/DivX codec of MPlayer. You have to get libavcodec directly
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
85 from the FFmpeg CVS server.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
86
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
87 To get the FFmpeg sources, use the following commands in a suitable directory
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
88 outside the MPlayer source directory:
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
89
11076
64329cda90c5 ffmpeg moved to MPlayerHQ
gabucino
parents: 10431
diff changeset
90 cvs -d:pserver:anonymous@mplayerhq.hu:/cvsroot/ffmpeg login
16170
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
91 cvs -z3 -d:pserver:anonymous@mplayerhq.hu:/cvsroot/ffmpeg co ffmpeg
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
92
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
93 When asked for a password, you can just hit enter. A directory named 'ffmpeg'
16170
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
94 with subdirectories named 'libavcodec' and 'libavutil' inside will be created.
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
95 Copy (symbolic linking does NOT suffice) these subdirectories into the MPlayer
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
96 source tree.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
97
14583
e10a50a36faa Explain how to include libavcodec in cvs updates.
diego
parents: 14025
diff changeset
98 In order to force automatic updates of libavcodec when you update MPlayer, add
16170
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
99 the following lines to main/CVS/Entries:
14583
e10a50a36faa Explain how to include libavcodec in cvs updates.
diego
parents: 14025
diff changeset
100
e10a50a36faa Explain how to include libavcodec in cvs updates.
diego
parents: 14025
diff changeset
101 D/libavcodec////
16170
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
102 D/libavutil////
14583
e10a50a36faa Explain how to include libavcodec in cvs updates.
diego
parents: 14025
diff changeset
103
13304
a8925b9fc147 libavformat
diego
parents: 12851
diff changeset
104 FFmpeg also contains libavformat, a library to decode container formats that
16170
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
105 can optionally be used to extend MPlayer's container format support. If you
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
106 wish to use it, also copy the libavformat subdirectory into the MPlayer
7c5d6c82e5ed libavuti
diego
parents: 15872
diff changeset
107 source tree and add another line to main/CVS/Entries.
13304
a8925b9fc147 libavformat
diego
parents: 12851
diff changeset
108
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
109
10156
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
110 _______________________________
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
111 STEP2: Installing Binary Codecs
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
112 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
113
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
114 MPlayer and libavcodec have builtin support for the most common audio and video
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
115 formats, but some formats require external codecs. Examples include Real, Indeo
10156
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
116 and QuickTime audio formats. Support for Windows Media formats except WMV9
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
117 exists but still has some bugs, your mileage may vary. This step is not
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
118 mandatory, but recommended for getting MPlayer to play a broader range of
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
119 formats. Please note that most codecs only work on Intel x86 compatible PCs.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
120
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
121 Unpack the codecs archives and put the contents in a directory where MPlayer
10156
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
122 will find them. The default directory is /usr/local/lib/codecs/ (it used to be
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
123 /usr/local/lib/win32 in the past, this also works) but you can change that to
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
124 something else by using the '--with-codecsdir=DIR' option when you run
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
125 './configure'.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
126
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
127
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
128 __________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
129 STEP3: Configuring MPlayer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
130 ~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
131
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
132 MPlayer can be adapted to all kinds of needs and hardware environments. Run
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
133
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
134 ./configure
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
135
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
136 to configure MPlayer with the default options. The codecs you installed above
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
137 should be autodetected. GUI support has to be enabled separately, run
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
138
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
139 ./configure --enable-gui
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
140
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
141 if you want to use the GUI.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
142
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
143 If something does not work as expected, try
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
144
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
145 ./configure --help
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
146
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
147 to see the available options and select what you need.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
148
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
149 The configure script prints a summary of enabled and disabled options. If you
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
150 have something installed that configure fails to detect, check the file
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
151 configure.log for errors and reasons for the failure. Repeat this step until
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
152 you are satisfied with the enabled feature set.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
153
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
154
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
155 ________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
156 STEP4: Compiling MPlayer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
157 ~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
158
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
159 Now you can start the compilation by typing
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
160
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
161 make
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
162
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
163 You can install MPlayer with
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
164
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
165 make install
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
166
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
167 provided that you have write permission in the installation directory.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
168
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
169 If all went well, you can run MPlayer by typing 'mplayer'. A help screen with a
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
170 summary of the most common options and keyboard shortcuts should be displayed.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
171
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
172 If you get 'unable to load shared library' or similar errors, run
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
173 'ldd ./mplayer' to check which libraries fail and go back to STEP 3 to fix it.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
174 Sometimes running 'ldconfig' is enough to fix the problem.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
175
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
176 NOTE: If you run Debian you can configure, compile and build a proper Debian
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
177 .deb package with only one command:
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
178
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
179 fakeroot debian/rules binary
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
180
13874
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
181 If you want to pass custom options to configure, you can set up the
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
182 DEB_BUILD_OPTIONS environment variable. For instance, if you want GUI
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
183 and OSD menu support you would use:
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
184
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
185 DEB_BUILD_OPTIONS="--enable-gui --enable-menu" fakeroot debian/rules binary
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
186
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
187 You can also pass some variables to the Makefile. For example, if you want
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
188 to compile with gcc 3.4 even if it's not the default compiler:
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
189
13905
gpoirier
parents: 13874
diff changeset
190 CC=gcc-3.4 DEB_BUILD_OPTIONS="--enable-gui" fakeroot debian/rules binary
13874
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
191
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
192 To clean up the source tree run the following command:
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
193
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
194 fakeroot debian/rules clean
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
195
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
196 ____________________________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
197 STEP5: Installing the onscreen display fonts
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
198 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
199
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
200 Unpack the archive and choose one of the available font sizes. Then copy the
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
201 font files of the corresponding size into /usr/local/share/mplayer/font/ or
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
202 ~/.mplayer/font/ (or whatever you set with './configure --datadir=DIR').
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
203
15176
4dbd572fa869 Clarify/correct TTF font usage description.
diego
parents: 14921
diff changeset
204 Alternatively you can use a TrueType font installed on your system. Just
4dbd572fa869 Clarify/correct TTF font usage description.
diego
parents: 14921
diff changeset
205 make a symbolic link from either /usr/local/share/mplayer/subfont.ttf or
4dbd572fa869 Clarify/correct TTF font usage description.
diego
parents: 14921
diff changeset
206 ~/.mplayer/subfont.ttf to your TrueType font.
14921
1f82d63df1cd add a short note about how to use ttf fonts
attila
parents: 14583
diff changeset
207
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
208
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
209 ____________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
210 STEP6: Installing a GUI skin
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
211 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
212
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
213 Unpack the archive and put the contents in /usr/local/share/mplayer/Skin/ or
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
214 ~/.mplayer/Skin/. MPlayer will use the skin in the subdirectory named default
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
215 of /usr/local/share/mplayer/Skin/ or ~/.mplayer/Skin/ unless told otherwise via
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
216 the '-skin' switch. You should therefore rename your skin subdirectory or make
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
217 a suitable symbolic link.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
218
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
219
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
220 __________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
221 STEP7: Let's play!
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
222 ~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
223
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
224 That's it for the moment. To start playing movies, open a command line and try
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
225
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
226 mplayer <moviefile>
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
227
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
228 or for the GUI
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
229
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
230 gmplayer <moviefile>
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
231
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
232 gmplayer is a symbolic link to mplayer created by 'make install'.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
233 Without <moviefile>, MPlayer will come up and you will be able to use the GUI
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
234 filepicker.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
235
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
236 To play a VCD track or a DVD title, try:
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
237
10431
1fafac4b6abe better consistency
diego
parents: 10405
diff changeset
238 mplayer vcd://2 -cdrom-device /dev/hdc
10405
a5785a0b9ee1 -dvd -> dvd:// and -vcd -> vcd://
jonas
parents: 10228
diff changeset
239 mplayer dvd://1 -alang en -slang hu -dvd-device /dev/hdd
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
240
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
241 See 'mplayer -help' and 'man mplayer' for further options.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
242
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
243 'mplayer -vo help' will show you the available video output drivers. Experiment
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
244 with the '-vo' switch to see which one gives you the best performance.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
245 If you get jerky playback or no sound, experiment with the '-ao' switch (see
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
246 '-ao help') to choose between different audio drivers. Note that jerky playback
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
247 is caused by buggy audio drivers or a slow processor and video card. With a
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
248 good audio and video driver combination, one can play DVDs and 720x576 DivX
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
249 files smoothly on a Celeron 366. Slower systems may need the '-framedrop'
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
250 option.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
251
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
252 Questions you may have are probably answered in the rest of the documentation.
11183
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
253 The places to start reading are the man page, DOCS/HTML/en/index.html and
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
254 DOCS/HTML/en/faq.html. If you find a bug, please report it, but first read
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
255 DOCS/HTML/en/bugreports.html.