annotate README @ 6757:f72fc85934e5

10L bugs founds by Jindrich Makovicka <makovicki at KMLinux dot fjfi dot cvuti dot cz>
author albeu
date Sat, 20 Jul 2002 14:26:38 +0000
parents e792875ac769
children cdfa9de87202
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.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
4 MPlayer currently works best from the command line, but there is a GUI with
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
5 skin support in the alpha development stage.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
6
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
7 This document is for getting you started in a few minutes. It cannot answer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
8 all of your questions. If you have problems, please read the documentation in
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
9 DOCS/documentation.html. It is extensive and should answer most of your
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
10 questions. Also read the manpage to learn how to use MPlayer.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
11
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
12 To compile MPlayer with X11 support, you need to have the XFree86 development
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
13 packages installed, for the GUI you also need the GTK development packages.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
14
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
15 Before you start...
6244
e792875ac769 few fixes
arpi
parents: 6243
diff changeset
16 Unless you know what are you doing, consult DOCS/video.html to see which driver
e792875ac769 few fixes
arpi
parents: 6243
diff changeset
17 to use with your video card to get the best video quality and performance.
e792875ac769 few fixes
arpi
parents: 6243
diff changeset
18 Most cards require special drivers not included with standard X11, to drive
e792875ac769 few fixes
arpi
parents: 6243
diff changeset
19 the 2-D video acceleration features (YUV, scaling etc) of your card!
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 A quick and incomplete list of recommendations:
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
22 - ATI cards: get the GATOS drivers for X11/Xv or use vidix
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
23 - Matrox G200/G4x0/G550: compile and use mga_vid for Linux, use vidix for BSD
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
24 - 3dfx Voodoo3/Banshee: get XFree86 4.2.0+ for Xv or use the tdfxfb driver
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
25 - nVidia cards: get the X11 driver from www.nvidia.com for Xv support
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
26 Without having accelerated video, even a 800MHz P3 may be slow to play DVD!
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 ___________________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
29 STEP1: Installing FFmpeg libavcodec
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
30 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
31
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
32 If you are using an official release, skip this step, since official releases
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
33 always include libavcodec. To verify this check if the libavcodec subdirectory
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
34 is empty or contains the sources!
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
35
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
36 The FFmpeg project provides libavcodec, a very portable MPEG4/DivX codec with
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
37 excellent speed and quality. It is the preferred codec of MPlayer for playing
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
38 mpeg4 and divx video. You have to get libavcodec directly from the FFmpeg CVS
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
39 server. Use the following commands in a suitable directory outside the MPlayer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
40 source directory:
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
41
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
42 cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg login
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
43 cvs -z9 -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg co ffmpeg/libavcodec
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
44
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
45 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
46
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
47 Now, replace the empty libavcodec directory with the FFmpeg libavcodec source
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
48 by removing the libavcodec subdirectory in the MPlayer source tree and then
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
49 copying (symbolic linking does not suffice!) the freshly downloaded FFmpeg
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
50 libavcodec directory back into the MPlayer source tree.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
51
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
52
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
53 ______________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
54 STEP2: Installing Win32 Codecs
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
55 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
56
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
57 While MPlayer and libavcodec has built-in support for the most common audio
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
58 and video formats, some others are playable only with the Win32 DLLs
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
59 or the XAnim binary plugins. Few examples: WMV video, Divx/WMA audio, Indeo.
6244
e792875ac769 few fixes
arpi
parents: 6243
diff changeset
60 This step is not mandatory, but recommended for getting MPlayer to play more
e792875ac769 few fixes
arpi
parents: 6243
diff changeset
61 different file types!
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
62
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
63 Grab the win32 codecs package from the download page
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
64
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
65 http://www.mplayerhq.hu/homepage/dload.html
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 unpack it and put the contents in a directory where MPlayer will find them.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
68 The default directory is /usr/lib/win32/ but you can change that to something
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
69 else by using the '--with-win32libdir=DIR' option when you run './configure' .
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
70
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
71 __________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
72 STEP3: Configuring MPlayer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
73 ~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
74
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
75 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
76
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
77 ./configure
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 to configure MPlayer with the default options. The options you installed above
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
80 should be autodetected, except GUI support, which has to be enabled separately,
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
81 run
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
82
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
83 ./configure --enable-gui
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
84
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
85 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
86
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
87 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
88
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
89 ./configure --help
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
90
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
91 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
92
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
93 The ./configure script prints a summary of enabled and disabled options.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
94 If you have something installed that ./configure fails to detect, check
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
95 the file configure.log for errors and reasons for the failure. Repeat this
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
96 step until you are satisfied with the enabled feature set.
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 ________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
99 STEP4: Compiling MPlayer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
100 ~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
101
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
102 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
103
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
104 make
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
105
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
106 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
107
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
108 make install
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
109
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
110 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
111
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
112 If all went well, you can run MPlayer by typing 'mplayer'
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
113 You should get a summary of the most common options and keys (help screen).
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 If you get 'unable to load shared library' or similar errors, then run
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
116 'ldd ./mplayer' to check which libraries fail and go back to STEP 3 to fix it.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
117 Sometimes just running 'ldconfig' is enough.
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 NOTE: If you run Debian you can configure, compile and build a proper deb
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
120 package with only one command:
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 fakeroot debian/rules binary
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
123
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
124 ____________________________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
125 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
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 To enable OSD (onscreen status display) and ASCII/TEXT subtitles you need some
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
129 fonts. Get them from our homepage:
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 http://www.mplayerhq.hu/homepage/dload.html
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
132
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
133 Unpack the archive and choose one of the available font sizes. Then copy the
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
134 font files of the corresponding size into /usr/local/share/mplayer/font/
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
135 (or whatever you set with './configure --datadir=DIR').
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
136
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
137 ____________________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
138 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
139 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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 Please remember that the GUI is still in the alpha development stage and not
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
142 completely finished yet. Features like playlist, preferences and equalizer
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
143 do not work at all. Expect them for the 1.0 release
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
144 Basic stuff like file selection and seeking works, though.
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 If you want to use the GUI you need to download a skin, since MPlayer does not
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
147 come with a skin by default. Choose one from the download page
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 http://www.mplayerhq.hu/homepage/dload.html
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 unpack it in /usr/local/share/mplayer/Skin/. MPlayer will use the skin in
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
152 the default/ subdirectory (/usr/local/share/mplayer/Skin/default/*) unless
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
153 told otherwise via the '-skin' switch. You should therefore rename your
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
154 skin subdirectory, make a suitable symbolic link or set the skin name in
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
155 the file mplayer.conf by 'skin=skinname'.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
156
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
157 __________________
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
158 STEP7: Let's play!
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
159 ~~~~~~~~~~~~~~~~~~
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 That's it for the moment. To start playing movies, open a command line and try
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 mplayer <moviefile>
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 or for the GUI:
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 gmplayer <moviefile>
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
168 (just 'gmplayer' is enough to use the GUI fileselector)
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 To play VCD track or DVD title, try:
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
171
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
172 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
173 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
174
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
175 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
176
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
177 'mplayer -vo help' will show you the available video output drivers. Experiment
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
178 with the '-vo' switch to see which one gives you the best performance!
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
179 If you get very jerky playback or no sound, experiment with -ao (see -ao help)
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
180 Note that jerky playback is caused by buggy audio drivers or too slow cpu/vga.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
181 With a good audio and video driver combination, one can play DVDs and 720x576
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
182 DivX files smoothly on a Celeron 366. For slower systems, you need -framedrop.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
183
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
184 Questions you may have are probably answered in the rest of the documentation.
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
185 The place to start reading is DOCS/faq.html and DOCS/documentation.html.