annotate README @ 8971:1a55bd301c66

sync
author nicolas
date Fri, 17 Jan 2003 20:14:10 +0000
parents 7078f0139bed
children 32cf06859120
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
6 also used for displaying subtitles. A GUI with skin support is in the alpha
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
7 development stage, but not completely finished yet.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
8
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
9 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
10 of your questions. If you have problems, please read the documentation in
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
11 DOCS/documentation.html, which should help you solve most of your problems.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
12 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
13
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
14
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
15 Requirements:
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
16 - 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
17 packages installed.
7674
7078f0139bed cosmetics
arpi
parents: 7320
diff changeset
18 - 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
19
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
20
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
21 Before you start...
6244
e792875ac769 few fixes
arpi
parents: 6243
diff changeset
22 Unless you know what are you doing, consult DOCS/video.html to see which driver
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
23 to use with your video card to get the best quality and performance. Most cards
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
24 require special drivers not included with XFree86 to drive their 2-D video
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
25 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
26
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
27 A quick and incomplete list of recommendations:
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
28 - 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
29 - 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
30 - 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
31 - 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
32 - NeoMagic cards: Get an Xv capable driver from our homepage as described in
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
33 DOCS/video.html.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
34
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
35 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
36
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
37
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
38 ______________________
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
39 STEP0: Getting MPlayer
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
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
42 Official releases, prereleases and CVS snapshots, as well as fonts for the
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
43 OSD, Win32 codecs and a number of different skins for the GUI are available
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
44 from the download section of our homepage at
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 http://www.mplayerhq.hu/homepage/dload.html
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 A set of fonts is necessary for the OSD and subtitles, the GUI needs at least
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
49 one skin and Win32 codecs add support for some more video and audio formats.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
50 MPlayer does not come with any of these by default, you have to download and
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
51 install them separately.
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 MPlayer is also available via anonymous CVS. Issue the following commands to
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
54 get the latest sources:
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
55
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
56 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
57 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
58
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
59 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
60 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
61
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
62 cvs -z3 update -dPA
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 from within that directory.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
65
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
66
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
67 ___________________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
68 STEP1: Installing FFmpeg libavcodec
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
69 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
70
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
71 If you are using an official (pre)release, skip this step, since official
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
72 releases include libavcodec. CVS sources and CVS snapshots do not include
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
73 libavcodec. To verify if you do have libavcodec or not, check if the libavcodec
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
74 subdirectory in the MPlayer source tree is empty or not.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
75
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
76 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
77 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
78 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
79 from the FFmpeg CVS server.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
80
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
81 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
82 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
83
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
84 cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg login
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
85 cvs -z3 -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/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
86
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
87 When asked for a password, you can just hit enter.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
88
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
89 Now, replace the empty libavcodec directory in the MPlayer source tree with the
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
90 FFmpeg libavcodec source by removing the libavcodec subdirectory in the MPlayer
7674
7078f0139bed cosmetics
arpi
parents: 7320
diff changeset
91 source tree and then copying (symbolic linking does NOT suffice) the freshly
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
92 downloaded FFmpeg libavcodec directory back 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
93
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
94
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
95 ______________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
96 STEP2: Installing Win32 Codecs
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
97 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
98
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
99 MPlayer and libavcodec have builtin support for the most common audio and video
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
100 formats, but some others are playable only with the Win32 DLLs or the XAnim
7674
7078f0139bed cosmetics
arpi
parents: 7320
diff changeset
101 binary plugins. Examples include WMV8 video, DivX with WMA audio (not normal
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
102 DivX files) and Indeo. This step is not mandatory, but recommended for getting
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
103 MPlayer to play more different file types. Note that Win32 codecs only work on
7674
7078f0139bed cosmetics
arpi
parents: 7320
diff changeset
104 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
105
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
106 Unpack the codecs archive and put the contents in a directory where MPlayer
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
107 will find them. The default directory is /usr/lib/win32/ but you can change
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
108 that to something else by using the '--with-win32libdir=DIR' option when you
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
109 run './configure'.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
110
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
111
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
112 __________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
113 STEP3: Configuring MPlayer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
114 ~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
115
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
116 MPlayer has a lot of options that get selected in this phase. Run
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 ./configure
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
119
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
120 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
121 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
122
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
123 ./configure --enable-gui
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 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
126
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
127 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
128
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
129 ./configure --help
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 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
132
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
133 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
134 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
135 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
136 you are satisfied with the enabled feature set.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
137
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 ________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
140 STEP4: Compiling MPlayer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
141 ~~~~~~~~~~~~~~~~~~~~~~~~
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 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
144
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
145 make
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 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
148
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
149 make install
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 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
152
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
153 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
154 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
155
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
156 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
157 '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
158 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
159
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
160 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
161 .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
162
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
163 fakeroot debian/rules binary
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
164
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
165
6243
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 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
168 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
169
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
170 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
171 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
172 ~/.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
173
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 ____________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
176 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
177 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
178
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
179 Unpack the archive and put the contents in /usr/local/share/mplayer/Skin/ or
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
180 ~/.mplayer/Skin/. MPlayer will use the skin in the default/ subdirectory of
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
181 /usr/local/share/mplayer/Skin/ or ~/.mplayer/Skin/ unless told otherwise via
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
182 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
183 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
184
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
185
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
186 __________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
187 STEP7: Let's play!
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
188 ~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
189
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
190 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
191
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
192 mplayer <moviefile>
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
193
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
194 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
195
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
196 gmplayer <moviefile>
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
197
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
198 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
199 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
200 filepicker.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
201
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
202 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
203
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
204 mplayer -vcd 2 -cdrom-device /dev/hdc
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
205 mplayer -dvd 1 -alang en -slang hu -dvd-device /dev/hdd
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
206
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
207 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
208
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
209 '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
210 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
211 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
212 '-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
213 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
214 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
215 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
216 option.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
217
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
218 Questions you may have are probably answered in the rest of the documentation.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
219 The places to start reading are the man page, DOCS/documentation.html and
7674
7078f0139bed cosmetics
arpi
parents: 7320
diff changeset
220 DOCS/faq.html. If you find a bug, read DOCS/bugreports.html first!