Mercurial > mplayer.hg
annotate README @ 30768:6032dd934340
Ensure that cue_current_pos.track is not set to an invalid value after
attempting to seek to e.g. track 0.
author | reimar |
---|---|
date | Mon, 01 Mar 2010 20:20:13 +0000 |
parents | db90719da3bf |
children | 92d75e703bc0 |
rev | line source |
---|---|
12851 | 1 Welcome to MPlayer, The Movie Player. MPlayer can play most standard video |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
2 formats out of the box and almost all others with the help of external codecs. |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
3 MPlayer currently works best from the command line, but visual feedback for |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
4 many functions is available from its onscreen status display (OSD), which is |
9618
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
5 also used for displaying subtitles. MPlayer also has a GUI with skin support and |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
6 several unofficial alternative graphical frontends are available. |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
7 |
32cf06859120
Updated information, rewordings, codec installation generalized.
diego
parents:
7674
diff
changeset
|
8 MEncoder is a command line video encoder for advanced users that can be built |
22197 | 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 | 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 | 19 - POSIX system: You need a POSIX-compatible shell and POSIX-compatible system |
20 tools like grep, sed, awk, etc. in your path. | |
10228 | 21 - You need a working development environment that can compile programs. |
22 On popular Linux distributions, this means having the glibc development | |
23 package(s) installed. | |
15834 | 24 - To compile MPlayer with X11 support, you need to have the X Window System |
15872 | 25 development packages (like for XFree86 or X.Org) installed. |
23207 | 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 | 30 Make sure that your version of X has Xvideo support, without it even very |
31 fast machines may not be able to properly play high resolution videos in | |
32 fullscreen mode. Consult DOCS/HTML/en/video.html for details. There you may | |
33 also find out about special card-specific video output drivers that can yield | |
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 | 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 | 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 | 66 A directory named 'mplayer' will be created. It will include all necessary |
67 FFmpeg libraries, you don't need to get them separately as was the case in | |
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 | 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 | 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 | 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 | 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 | 93 to configure MPlayer with the default options. GUI support has to be enabled |
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 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
108 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
|
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 | 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 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
136 fakeroot debian/rules binary |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
137 |
13874
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
138 If you want to pass custom options to configure, you can set up the |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
139 DEB_BUILD_OPTIONS environment variable. For instance, if you want GUI |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
140 and OSD menu support you would use: |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
141 |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
142 DEB_BUILD_OPTIONS="--enable-gui --enable-menu" fakeroot debian/rules binary |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
143 |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
144 You can also pass some variables to the Makefile. For example, if you want |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
145 to compile with gcc 3.4 even if it's not the default compiler: |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
146 |
13905 | 147 CC=gcc-3.4 DEB_BUILD_OPTIONS="--enable-gui" fakeroot debian/rules binary |
13874
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
148 |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
149 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
|
150 |
09298a8ba1eb
Explain how to use custom options while building Debian packages, based on a
diego
parents:
13304
diff
changeset
|
151 fakeroot debian/rules clean |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
152 |
19813
738ee921c764
Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents:
19672
diff
changeset
|
153 ______________________________________ |
738ee921c764
Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents:
19672
diff
changeset
|
154 STEP4: Choose an onscreen display font |
738ee921c764
Don't explain how to install bitmap fonts, use TrueType fonts instead.
diego
parents:
19672
diff
changeset
|
155 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
156 |
19867
7110631d6601
Reword the font section to be a bit more descriptive.
diego
parents:
19813
diff
changeset
|
157 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
|
158 /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
|
159 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
|
160 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
|
161 /usr/local/share/mplayer/subfont.ttf to your TrueType font. |
14921 | 162 |
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 ____________________________ |
18659 | 165 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
|
166 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
167 |
17974
9a5a62f480e6
Rename the default GUI skins directory from 'Skin' to 'skins', keeping
diego
parents:
17706
diff
changeset
|
168 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
|
169 ~/.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
|
170 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
|
171 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
|
172 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
|
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 __________________ |
18659 | 176 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
|
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 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
|
180 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
181 mplayer <moviefile> |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
182 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
183 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
|
184 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
185 gmplayer <moviefile> |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
186 |
6813
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
187 gmplayer is a symbolic link to mplayer created by 'make install'. |
22197 | 188 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
|
189 |
cdfa9de87202
Reorganized the README. More general information up front, more concise
diego
parents:
6244
diff
changeset
|
190 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
|
191 |
10431 | 192 mplayer vcd://2 -cdrom-device /dev/hdc |
10405 | 193 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
|
194 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
195 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
|
196 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
197 '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
|
198 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
|
199 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
|
200 '-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
|
201 is caused by buggy audio drivers or a slow processor and video card. With a |
22197 | 202 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
|
203 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
|
204 option. |
6243
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
205 |
20389bf27dd4
quick install guide, based on draft and patches by Diego Biurrun <diego@biurrun.de>
arpi
parents:
3372
diff
changeset
|
206 Questions you may have are probably answered in the rest of the documentation. |
11183 | 207 The places to start reading are the man page, DOCS/HTML/en/index.html and |
208 DOCS/HTML/en/faq.html. If you find a bug, please report it, but first read | |
209 DOCS/HTML/en/bugreports.html. |