Mercurial > mplayer.hg
annotate README @ 11583:2af52902e7dc
Send HTTP Cookies (reading from mozilla/netscape files) support by Dave Lambley <mplayer-dev-eng@dlambley.freeserve.co.uk>. Disabled by default.
author | alex |
---|---|
date | Mon, 08 Dec 2003 13:25:35 +0000 |
parents | 604a27a2b966 |
children | 16c01dbca208 |
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 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
2 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
|
3 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
|
4 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
|
5 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
|
6 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
|
7 several unofficial alternative graphical frontends are available. |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
8 |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
9 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
|
10 from the MPlayer source tree. An unofficial graphical frontend exists but is |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
11 not included. |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
12 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
13 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
|
14 of your questions. If you have problems, please read the documentation in |
11183 | 15 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
|
16 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
|
17 |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
18 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
19 Requirements: |
10228 | 20 - You need a working development environment that can compile programs. |
21 On popular Linux distributions, this means having the glibc development | |
22 package(s) installed. | |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
23 - 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
|
24 packages installed. |
7674 | 25 - 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
|
26 |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
27 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
28 Before you start... |
11183 | 29 Unless you know what are you doing, consult DOCS/HTML/en/devices.html#video-dev |
30 to see which driver to use with your video card to get the best quality and | |
31 performance. Most cards require special drivers not included with XFree86 to | |
32 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
|
33 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
34 A quick and incomplete list of recommendations: |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
35 - 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
|
36 - 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
|
37 - 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
|
38 - 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
|
39 - NeoMagic cards: Get an Xv capable driver from our homepage as described in |
11183 | 40 DOCS/HTML/en/devices.html#video-dev. |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
41 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
42 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
|
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 ______________________ |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
46 STEP0: Getting MPlayer |
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 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
49 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
|
50 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
|
51 from the download section of our homepage at |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
52 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
53 http://www.mplayerhq.hu/homepage/dload.html |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
54 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
55 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
|
56 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
|
57 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
|
58 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
|
59 |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
60 http://www.mplayerhq.hu/MPlayer/releases/codecs/ |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
61 |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
62 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
|
63 the latest sources: |
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 cvs -d:pserver:anonymous@mplayerhq.hu:/cvsroot/mplayer login |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
66 cvs -z3 -d:pserver:anonymous@mplayerhq.hu:/cvsroot/mplayer co main |
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 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
|
69 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
|
70 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
71 cvs -z3 update -dPA |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
72 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
73 from within that directory. |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
74 |
6243
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 ___________________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
77 STEP1: Installing FFmpeg libavcodec |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
78 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
79 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
80 If you are using an official (pre)release, skip this step, since official |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
81 releases include libavcodec. CVS sources and thus CVS snapshots do not include |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
82 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
|
83 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
|
84 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
85 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
|
86 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
|
87 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
|
88 from the FFmpeg CVS server. |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
89 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
90 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
|
91 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
|
92 |
11076 | 93 cvs -d:pserver:anonymous@mplayerhq.hu:/cvsroot/ffmpeg login |
94 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
|
95 |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
96 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
|
97 with a subdirectory named 'libavcodec' inside will be created. Copy (symbolic |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
98 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
|
99 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
100 |
10156
eafe9a587896
Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents:
10154
diff
changeset
|
101 _______________________________ |
eafe9a587896
Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents:
10154
diff
changeset
|
102 STEP2: Installing Binary Codecs |
eafe9a587896
Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents:
10154
diff
changeset
|
103 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
104 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
105 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
|
106 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
|
107 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
|
108 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
|
109 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
|
110 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
|
111 |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
112 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
|
113 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
|
114 /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
|
115 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
|
116 './configure'. |
6243
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 __________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
120 STEP3: Configuring MPlayer |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
121 ~~~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
122 |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
123 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
|
124 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
125 ./configure |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
126 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
127 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
|
128 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
|
129 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
130 ./configure --enable-gui |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
131 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
132 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
|
133 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
134 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
|
135 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
136 ./configure --help |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
137 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
138 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
|
139 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
140 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
|
141 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
|
142 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
|
143 you are satisfied with the enabled feature set. |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
144 |
6243
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 ________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
147 STEP4: Compiling MPlayer |
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 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
150 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
|
151 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
152 make |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
153 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
154 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
|
155 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
156 make install |
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 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
|
159 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
160 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
|
161 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
|
162 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
163 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
|
164 '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
|
165 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
|
166 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
167 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
|
168 .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
|
169 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
170 fakeroot debian/rules binary |
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 |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
173 ____________________________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
174 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
|
175 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
176 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
177 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
|
178 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
|
179 ~/.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
|
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 ____________________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
183 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
|
184 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
185 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
186 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
|
187 ~/.mplayer/Skin/. MPlayer will use the skin in the subdirectory named default |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
188 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
|
189 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
|
190 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
|
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 __________________ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
194 STEP7: Let's play! |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
195 ~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
196 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
197 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
|
198 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
199 mplayer <moviefile> |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
200 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
201 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
|
202 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
203 gmplayer <moviefile> |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
204 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
205 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
|
206 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
|
207 filepicker. |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
208 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
209 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
|
210 |
10431 | 211 mplayer vcd://2 -cdrom-device /dev/hdc |
10405 | 212 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
|
213 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
214 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
|
215 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
216 '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
|
217 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
|
218 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
|
219 '-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
|
220 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
|
221 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
|
222 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
|
223 option. |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
224 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
225 Questions you may have are probably answered in the rest of the documentation. |
11183 | 226 The places to start reading are the man page, DOCS/HTML/en/index.html and |
227 DOCS/HTML/en/faq.html. If you find a bug, please report it, but first read | |
228 DOCS/HTML/en/bugreports.html. |