Mercurial > mplayer.hg
annotate README @ 12804:0106b9917013
Status updates and comments about other dll required by some codecs
author | rtognimp |
---|---|
date | Mon, 12 Jul 2004 21:49:37 +0000 |
parents | 01d2d0e7340f |
children | 28347c761182 |
rev | line source |
---|---|
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
1 Welcome to MPlayer, the Unix movie player. MPlayer can play most standard video |
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 | 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 | 19 - You need a working development environment that can compile programs. |
20 On popular Linux distributions, this means having the glibc development | |
21 package(s) installed. | |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
22 - To compile MPlayer with X11 support, you need to have the XFree86 development |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
23 packages installed. |
7674 | 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... |
11183 | 28 Unless you know what are you doing, consult DOCS/HTML/en/devices.html#video-dev |
29 to see which driver to use with your video card to get the best quality and | |
30 performance. Most cards require special drivers not included with XFree86 to | |
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 |
11183 | 39 DOCS/HTML/en/devices.html#video-dev. |
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 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
54 A set of fonts is necessary for the OSD and subtitles, the GUI needs at least |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
55 one skin and codec packages add support for some more video and audio formats. |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
56 MPlayer does not come with any of these by default, you have to download and |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
57 install them separately. A wide range of codec packages can be downloaded at |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
58 |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
59 http://www.mplayerhq.hu/MPlayer/releases/codecs/ |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
60 |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
61 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
|
62 the latest sources: |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
63 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
64 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
|
65 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
|
66 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
67 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
|
68 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
|
69 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
70 cvs -z3 update -dPA |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
71 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
72 from within that directory. |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
73 |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
74 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
75 ___________________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
76 STEP1: Installing FFmpeg libavcodec |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
77 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
78 |
12509 | 79 If you are using an official (pre)release or a CVS snapshot, skip this step, |
80 since official releases include libavcodec. CVS sources do not include | |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
81 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
|
82 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
|
83 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
84 The FFmpeg project provides libavcodec, a very portable codec collection (among |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
85 the supported formats is MPEG4/DivX) with excellent quality and speed, that is |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
86 the preferred MPEG4/DivX codec of MPlayer. You have to get libavcodec directly |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
87 from the FFmpeg CVS server. |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
88 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
89 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
|
90 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
|
91 |
11076 | 92 cvs -d:pserver:anonymous@mplayerhq.hu:/cvsroot/ffmpeg login |
93 cvs -z3 -d:pserver:anonymous@mplayerhq.hu:/cvsroot/ffmpeg co ffmpeg/libavcodec | |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
94 |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
95 When asked for a password, you can just hit enter. A directory named 'ffmpeg' |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
96 with a subdirectory named 'libavcodec' inside will be created. Copy (symbolic |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
97 linking does NOT suffice) this subdirectory into 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
|
98 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
99 |
10156
eafe9a587896
Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents:
10154
diff
changeset
|
100 _______________________________ |
eafe9a587896
Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents:
10154
diff
changeset
|
101 STEP2: Installing Binary Codecs |
eafe9a587896
Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents:
10154
diff
changeset
|
102 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
103 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
104 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
|
105 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
|
106 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
|
107 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
|
108 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
|
109 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
|
110 |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
111 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
|
112 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
|
113 /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
|
114 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
|
115 './configure'. |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
116 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
117 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
118 __________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
119 STEP3: Configuring MPlayer |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
120 ~~~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
121 |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
122 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
|
123 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
124 ./configure |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
125 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
126 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
|
127 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
|
128 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
129 ./configure --enable-gui |
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 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
|
132 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
133 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
|
134 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
135 ./configure --help |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
136 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
137 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
|
138 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
139 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
|
140 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
|
141 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
|
142 you are satisfied with the enabled feature set. |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
143 |
6243
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 ________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
146 STEP4: Compiling MPlayer |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
147 ~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
148 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
149 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
|
150 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
151 make |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
152 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
153 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
|
154 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
155 make install |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
156 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
157 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
|
158 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
159 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
|
160 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
|
161 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
162 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
|
163 '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
|
164 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
|
165 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
166 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
|
167 .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
|
168 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
169 fakeroot debian/rules binary |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
170 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
171 |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
172 ____________________________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
173 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
|
174 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
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 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
|
177 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
|
178 ~/.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
|
179 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
180 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
181 ____________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
182 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
|
183 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
184 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
185 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
|
186 ~/.mplayer/Skin/. MPlayer will use the skin in the subdirectory named default |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
187 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
|
188 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
|
189 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
|
190 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
191 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
192 __________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
193 STEP7: Let's play! |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
194 ~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
195 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
196 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
|
197 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
198 mplayer <moviefile> |
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 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
|
201 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
202 gmplayer <moviefile> |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
203 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
204 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
|
205 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
|
206 filepicker. |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
207 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
208 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
|
209 |
10431 | 210 mplayer vcd://2 -cdrom-device /dev/hdc |
10405 | 211 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
|
212 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
213 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
|
214 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
215 '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
|
216 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
|
217 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
|
218 '-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
|
219 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
|
220 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
|
221 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
|
222 option. |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
223 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
224 Questions you may have are probably answered in the rest of the documentation. |
11183 | 225 The places to start reading are the man page, DOCS/HTML/en/index.html and |
226 DOCS/HTML/en/faq.html. If you find a bug, please report it, but first read | |
227 DOCS/HTML/en/bugreports.html. |