Mercurial > mplayer.hg
annotate README @ 17670:f5f338e543b6
Fix rgb32tobgr16, rgb32to15, and rgb32tobgr15. All had the same problem that
was fixed in rgb32to16 about a year ago: using only the first 8 bits of the
32-bit pixel.
author | pacman |
---|---|
date | Fri, 24 Feb 2006 09:52:59 +0000 |
parents | 7c5d6c82e5ed |
children | 83c1acef76d5 |
rev | line source |
---|---|
12851 | 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 | 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. | |
15834 | 22 - To compile MPlayer with X11 support, you need to have the X Window System |
15872 | 23 development packages (like for XFree86 or X.Org) 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... |
13914 | 28 Unless you know what are you doing, consult DOCS/HTML/en/video.html to see |
29 which driver to use with your video card to get the best quality and | |
11183 | 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 |
13914 | 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 | 54 A set of fonts is necessary for the OSD and subtitles unless you are using |
55 TrueType fonts, the GUI needs at least one skin and codec packages add support | |
56 for some more video and audio formats. MPlayer does not come with any of these | |
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 | 73 _________________________________________________________ |
74 STEP1: Installing FFmpeg libavcodec/libavutil/libavformat | |
75 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
76 |
12509 | 77 If you are using an official (pre)release or a CVS snapshot, skip this step, |
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 | 83 the supported formats is MPEG-4/DivX) with excellent quality and speed, that is |
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 | 90 cvs -d:pserver:anonymous@mplayerhq.hu:/cvsroot/ffmpeg login |
16170 | 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 | 94 with subdirectories named 'libavcodec' and 'libavutil' inside will be created. |
95 Copy (symbolic linking does NOT suffice) these subdirectories into the MPlayer | |
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 | 98 In order to force automatic updates of libavcodec when you update MPlayer, add |
16170 | 99 the following lines to main/CVS/Entries: |
14583 | 100 |
101 D/libavcodec//// | |
16170 | 102 D/libavutil//// |
14583 | 103 |
13304 | 104 FFmpeg also contains libavformat, a library to decode container formats that |
16170 | 105 can optionally be used to extend MPlayer's container format support. If you |
106 wish to use it, also copy the libavformat subdirectory into the MPlayer | |
107 source tree and add another line to main/CVS/Entries. | |
13304 | 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 | 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 | 204 Alternatively you can use a TrueType font installed on your system. Just |
205 make a symbolic link from either /usr/local/share/mplayer/subfont.ttf or | |
206 ~/.mplayer/subfont.ttf to your TrueType font. | |
14921 | 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 | 238 mplayer vcd://2 -cdrom-device /dev/hdc |
10405 | 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 | 253 The places to start reading are the man page, DOCS/HTML/en/index.html and |
254 DOCS/HTML/en/faq.html. If you find a bug, please report it, but first read | |
255 DOCS/HTML/en/bugreports.html. |