annotate README @ 32366:3a6a61ffbb34

Add fallback values to aspect_save_screenres to avoid division by 0 if screen dimensions are not known.
author reimar
date Sat, 09 Oct 2010 01:31:52 +0000
parents 4b6dc3f9b281
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12851
28347c761182 name change, codec download location
diego
parents: 12652
diff changeset
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
22197
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
9 from the MPlayer source tree. Unofficial graphical frontends exist but are
9618
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
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
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:
28387
db90719da3bf Add a note about POSIX system requirements.
diego
parents: 27777
diff changeset
19 - POSIX system: You need a POSIX-compatible shell and POSIX-compatible system
db90719da3bf Add a note about POSIX system requirements.
diego
parents: 27777
diff changeset
20 tools like grep, sed, awk, etc. in your path.
10228
3aba8a7ab91f Better wording as suggested by Rich.
diego
parents: 10222
diff changeset
21 - You need a working development environment that can compile programs.
3aba8a7ab91f Better wording as suggested by Rich.
diego
parents: 10222
diff changeset
22 On popular Linux distributions, this means having the glibc development
3aba8a7ab91f Better wording as suggested by Rich.
diego
parents: 10222
diff changeset
23 package(s) installed.
15834
1d2234930e70 mentioning xorg
alex
parents: 15176
diff changeset
24 - To compile MPlayer with X11 support, you need to have the X Window System
15872
diego
parents: 15834
diff changeset
25 development packages (like for XFree86 or X.Org) installed.
23207
daba1c391a48 The GUI no longer depends on libpng.
diego
parents: 22197
diff changeset
26 - For the GUI you need the GTK development packages.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
27
6243
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 Before you start...
22197
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
30 Make sure that your version of X has Xvideo support, without it even very
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
31 fast machines may not be able to properly play high resolution videos in
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
32 fullscreen mode. Consult DOCS/HTML/en/video.html for details. There you may
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
33 also find out about special card-specific video output drivers that can yield
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
34 optimal performance.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
35
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 STEP0: Getting MPlayer
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
39 ~~~~~~~~~~~~~~~~~~~~~~
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
40
19813
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
41 Official releases and Subversion snapshots, as well as binary codec packages
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
42 and a number of different skins for the GUI are available from the download
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
43 section of our homepage at
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
44
17706
83c1acef76d5 New website structure, the /homepage subdirectory is gone.
diego
parents: 16170
diff changeset
45 http://www.mplayerhq.hu/dload.html
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
46
27777
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
47 MPlayer has builtin support for the most common audio and video formats. For a
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
48 few formats no native decoder exists and external binary codecs are required
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
49 to handle them. Examples are newer RealVideo variants and a variety of rare
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
50 formats. However, binary codecs are NOT required in this day and age, they are
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
51 strictly optional.
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
52
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
53 Please note that binary codecs only work on the processor architecture they
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
54 were compiled for. Choose the correct package for your processor. No other
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
55 package is necessary.
52a85f0b08d4 Try to improve binary codec pack installation instructions.
diego
parents: 23207
diff changeset
56
19813
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
57 The GUI needs at least one skin and codec packages add support for some more
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
58 video and audio formats. MPlayer does not come with any of these by default,
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
59 you have to download and install them separately.
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
60
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
61 You can also get MPlayer via Subversion. Issue the following commands to get
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
62 the latest sources:
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
63
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
64 svn checkout svn://svn.mplayerhq.hu/mplayer/trunk mplayer
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
65
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
66 A directory named 'mplayer' will be created. It will include all necessary
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
67 FFmpeg libraries, you don't need to get them separately as was the case in
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
68 the past. You can later update your sources by saying
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
69
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
70 svn update
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
71
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
72 from within that directory.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
73
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
74
10156
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
75 _______________________________
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
76 STEP1: Installing Binary Codecs
10156
eafe9a587896 Default codec location is now /usr/local/lib/codecs/, the location is now
diego
parents: 10154
diff changeset
77 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
78
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
79 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
80 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
81 /usr/local/lib/win32 in the past, this also works) but you can change that to
20545
150596447eda --with-codecsdir --> --codecsdir
diego
parents: 19868
diff changeset
82 something else by passing the '--codecsdir' option to './configure'.
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
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
85 __________________________
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
86 STEP2: Configuring MPlayer
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
87 ~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
88
9618
32cf06859120 Updated information, rewordings, codec installation generalized.
diego
parents: 7674
diff changeset
89 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
90
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
91 ./configure
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
92
22197
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
93 to configure MPlayer with the default options. GUI support has to be enabled
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
94 separately, run
6243
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 ./configure --enable-gui
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 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
99
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
100 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
101
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
102 ./configure --help
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 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
105
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
106 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
107 have something installed that configure fails to detect, check the file
31349
92d75e703bc0 Rename configure.log file to the more standard name config.log.
diego
parents: 28387
diff changeset
108 config.log for errors and reasons for the failure. Repeat this step until
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
109 you are satisfied with the enabled feature set.
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
110
6243
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 ________________________
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
113 STEP3: Compiling MPlayer
6243
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 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
117
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
118 make
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
119
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
120 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
121
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
122 make install
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 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
125
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
126 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
127 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
128
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
129 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
130 '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
131 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
132
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
133 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
134 .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
135
31833
c9f9a077d760 Add new debian packaging based on official distro packages
siretart
parents: 31349
diff changeset
136 debian/daily-build.sh -b
13874
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
137
31863
4b6dc3f9b281 restore functionality to be able to pass custom configure flags or override the used compiler
siretart
parents: 31833
diff changeset
138 You can also pass some variables to the Makefile. For example, if you
4b6dc3f9b281 restore functionality to be able to pass custom configure flags or override the used compiler
siretart
parents: 31833
diff changeset
139 want to compile with gcc 3.4 even if it's not the default compiler, or
4b6dc3f9b281 restore functionality to be able to pass custom configure flags or override the used compiler
siretart
parents: 31833
diff changeset
140 pass extra configure options you would use:
4b6dc3f9b281 restore functionality to be able to pass custom configure flags or override the used compiler
siretart
parents: 31833
diff changeset
141
4b6dc3f9b281 restore functionality to be able to pass custom configure flags or override the used compiler
siretart
parents: 31833
diff changeset
142 CC=gcc-3.4 DEB_EXTRA_CONFIGURE_FLAGS="--disable-libdvdcss-internal" debian/daily-build.sh -b
4b6dc3f9b281 restore functionality to be able to pass custom configure flags or override the used compiler
siretart
parents: 31833
diff changeset
143
13874
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
144
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
145 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
146
09298a8ba1eb Explain how to use custom options while building Debian packages, based on a
diego
parents: 13304
diff changeset
147 fakeroot debian/rules clean
31833
c9f9a077d760 Add new debian packaging based on official distro packages
siretart
parents: 31349
diff changeset
148 rm debian/changelog
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
149
19813
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
150 ______________________________________
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
151 STEP4: Choose an onscreen display font
738ee921c764 Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents: 19672
diff changeset
152 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
153
19867
7110631d6601 Reword the font section to be a bit more descriptive.
diego
parents: 19813
diff changeset
154 You can use any TrueType font installed on your system. Just pass '-font
7110631d6601 Reword the font section to be a bit more descriptive.
diego
parents: 19813
diff changeset
155 /path/to/font.ttf' on the command line or add 'font=/path/to/font.ttf' to
7110631d6601 Reword the font section to be a bit more descriptive.
diego
parents: 19813
diff changeset
156 your configuration file. The manual page has more details. Alternatively
7110631d6601 Reword the font section to be a bit more descriptive.
diego
parents: 19813
diff changeset
157 you can create a symbolic link from either ~/.mplayer/subfont.ttf or
7110631d6601 Reword the font section to be a bit more descriptive.
diego
parents: 19813
diff changeset
158 /usr/local/share/mplayer/subfont.ttf to your TrueType font.
14921
1f82d63df1cd add a short note about how to use ttf fonts
attila
parents: 14583
diff changeset
159
6243
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 ____________________________
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
162 STEP5: Installing a GUI skin
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
163 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
164
17974
9a5a62f480e6 Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents: 17706
diff changeset
165 Unpack the archive and put the contents in /usr/local/share/mplayer/skins/ or
9a5a62f480e6 Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents: 17706
diff changeset
166 ~/.mplayer/skins/. MPlayer will use the skin in the subdirectory named default
9a5a62f480e6 Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents: 17706
diff changeset
167 of /usr/local/share/mplayer/skins/ or ~/.mplayer/skins/ unless told otherwise
9a5a62f480e6 Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents: 17706
diff changeset
168 via the '-skin' switch. You should therefore rename your skin subdirectory or
9a5a62f480e6 Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents: 17706
diff changeset
169 make 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
170
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 __________________
18659
db8821b163e5 CVS --> Subversion
diego
parents: 17974
diff changeset
173 STEP6: Let's play!
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
174 ~~~~~~~~~~~~~~~~~~
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
175
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
176 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
177
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
178 mplayer <moviefile>
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
179
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
180 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
181
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
182 gmplayer <moviefile>
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
183
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
184 gmplayer is a symbolic link to mplayer created by 'make install'.
22197
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
185 Without <moviefile>, gmplayer will start with the GUI filepicker.
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
186
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
187 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
188
10431
1fafac4b6abe better consistency
diego
parents: 10405
diff changeset
189 mplayer vcd://2 -cdrom-device /dev/hdc
10405
a5785a0b9ee1 -dvd -> dvd:// and -vcd -> vcd://
jonas
parents: 10228
diff changeset
190 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
191
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
192 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
193
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
194 '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
195 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
196 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
197 '-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
198 is caused by buggy audio drivers or a slow processor and video card. With a
22197
ebf5462a08b7 some clarifications and updates
diego
parents: 20545
diff changeset
199 good audio and video driver combination, one can play DVDs and 720x576 MPEG-4
6813
cdfa9de87202 Reorganized the README. More general information up front, more concise
diego
parents: 6244
diff changeset
200 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
201 option.
6243
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
202
20389bf27dd4 quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents: 3372
diff changeset
203 Questions you may have are probably answered in the rest of the documentation.
11183
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
204 The places to start reading are the man page, DOCS/HTML/en/index.html and
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
205 DOCS/HTML/en/faq.html. If you find a bug, please report it, but first read
604a27a2b966 DOCS/en/ ---> DOCS/HTML/en/
diego
parents: 11076
diff changeset
206 DOCS/HTML/en/bugreports.html.