|
1201
|
1 MPlayer - Movie Player for LINUX (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team)
|
|
|
2 ================================ * See the file AUTHORS for the complete list *
|
|
|
3 http://mplayer.sourceforge.net (or http://mplayer.dev.hu)
|
|
1
|
4
|
|
|
5 About:
|
|
|
6 ~~~~~~
|
|
907
|
7 MPlayer is a movie player for LINUX. It plays most MPEG, AVI and ASF files,
|
|
|
8 supported by many native and Win32 DLL codecs. You can watch VCD, DVD and even
|
|
860
|
9 DivX movies too. The another big feature of mplayer is the wide range of
|
|
|
10 supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev,
|
|
1201
|
11 but you can use SDL (and this way all drivers of SDL, for example AAlib) and
|
|
|
12 some lowlevel card-specific drivers (for Matrox) too! Most of them supports
|
|
|
13 software or hardware scaling, so you can enjoy movies in fullscreen. And what
|
|
|
14 about the nice big antialiased shaded subtitles (7 supported types!!!) with
|
|
|
15 hungarian, english, cyrillic, czech, korean fonts, and OSD?
|
|
540
|
16
|
|
|
17 History:
|
|
|
18 ~~~~~~~~
|
|
1201
|
19 This began a year ago...
|
|
1
|
20 I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN,
|
|
|
21 xine,xanim,avifile,xmmp) but they all have some problem. Mostly with
|
|
|
22 special files or with audio/video sync. Most of them is unable to play
|
|
907
|
23 both MPEG1, MPEG2 and AVI (DivX) files. Many players have image quality
|
|
1
|
24 or speed problems too. So I've decided to write/modify one...
|
|
|
25
|
|
540
|
26 - mpg12play v0.1-v0.3:
|
|
|
27 The first try, hacked together in a half hour!
|
|
|
28 I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3,
|
|
|
29 but there were image quality and speed problems with it.
|
|
|
30 - mpg12play v0.5-v0.87:
|
|
|
31 Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff,
|
|
|
32 but it was slow and was written in C++ (I hate C++!!!)
|
|
|
33 - mpg12play v0.9-v0.95pre5:
|
|
|
34 Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse.
|
|
|
35 It's great, optimized very fast C code with perfect image quality and
|
|
907
|
36 100% MPEG standard conformance.
|
|
540
|
37 - MPlayer v0.3-v0.9:
|
|
|
38 It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI
|
|
|
39 player 'avip' based on avifile's Win32 DLL loader.
|
|
|
40 - MPlayer v0.10:
|
|
907
|
41 The MPEG and AVI player in a single binary!
|
|
540
|
42 - MPlayer v0.11:
|
|
1201
|
43 Some new developers joined and from 0.11 the mplayer project is a team-work!
|
|
907
|
44 Added .ASF file support, and OpenDivX (see www.projectmayo.com) en/decoding.
|
|
540
|
45 - MPlayer v0.17 "The IdegCounter"
|
|
|
46 The release version of the 0.11pre after 4 months of heavy development!
|
|
|
47 Try it, and be amazed! Thousands of new features added... and of course
|
|
|
48 old code was improved too, bugs removed etc.
|
|
1083
|
49 - MPlayer 0.18
|
|
|
50 2 months since 0.17 and here's a new release.. Completed ASF support,
|
|
|
51 more subtitle formats, introduced libao (similar to libvo but to audio),
|
|
|
52 even more stable than ever, and so on. It's a MUST !
|
|
1
|
53
|
|
749
|
54 As you see, I didn't write any codecs, just some players. Instead I spent
|
|
1
|
55 a lot of time finding the best way to parse bad damaged input files
|
|
907
|
56 (both MPEG and AVI) and to do perfect A-V sync with seeking ability.
|
|
|
57 My player is rock solid playing damaged MPEG files (useful for some VCDs),
|
|
1
|
58 and it plays bad AVI files which are unplayable with the famous
|
|
749
|
59 windows media player. Even AVI files without index chunk are playable, and
|
|
|
60 you can rebuild their indexes with the -idx option, thus enabling seeking!
|
|
1
|
61 As you see, stability and quality are the most important things for me,
|
|
907
|
62 but the speed is also amazing.
|
|
1
|
63
|
|
|
64 What about the GUI?
|
|
540
|
65 ~~~~~~~~~~~~~~~~~~~
|
|
1
|
66 I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console.
|
|
|
67 So the player has only keyboard control from the controlling console/xterm now.
|
|
907
|
68 There is a GUI development for the player, coordinated by Pontscho/Fresh!
|
|
749
|
69 It's still under development, but it will be merged and released real soon.
|
|
1
|
70 BTW he needs some nice skins, if you are a good graphician, contact him!!!
|
|
|
71
|
|
|
72 Supported input formats:
|
|
|
73 ~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
74 - VCD (Video CD) directly from CD-ROM or from CDRwin's .bin image file
|
|
540
|
75 - DVD, directly from your DVD disk, using optional libcss for decryption
|
|
|
76 - MPEG 1/2 System Stream (PS/PES/VOB) and Elementary Stream (ES) file formats
|
|
1
|
77 - RIFF AVI file format
|
|
|
78 - ASF 1.0 file format
|
|
1201
|
79 - supports reading from file, stdin, DVD drive or network via HTTP
|
|
|
80
|
|
|
81 Note: about quicktime (.mov/.qt) and realmedia (.ra/.rm) support read the FAQ!
|
|
1
|
82
|
|
352
|
83 Supported audio & video codecs:
|
|
|
84 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
745
|
85 *** See http://mplayer.sourceforge.net/DOCS/codecs.html ***
|
|
1201
|
86 *** for the complete, daily updated list!!! ***
|
|
540
|
87
|
|
|
88 The most important video codecs:
|
|
907
|
89 - MPEG1 (VCD) and MPEG2 (DVD) video
|
|
540
|
90 - DivX, OpenDivX and other MPEG4 variants
|
|
|
91 - Windows Media Video 7 (WMV1) used in .wmv files
|
|
|
92 - Intel Indeo codecs (3.1,3.2,4.1,5.0)
|
|
|
93 - MJPEG, ASV2 and other hardware formats
|
|
|
94
|
|
|
95 The most important audio codecs:
|
|
1201
|
96 - MPEG layer 2, and layer 3 (MP3) audio (native code, with 3dnow optimization)
|
|
|
97 - AC3 dolby audio (native code, with 3dnow optimization)
|
|
670
|
98 - Voxware audio
|
|
540
|
99 - alaw, msgsm, pcm and other simple old audio formats
|
|
1
|
100
|
|
744
|
101 If you have a codec not listed here, and not supported yet, just
|
|
749
|
102 read http://mplayer.sourceforge.net/DOCS/codecs.html and DOCS/CODECS
|
|
|
103 to get info about its status and about how to help us adding support for it!
|
|
670
|
104
|
|
1
|
105 Supported video output devices:
|
|
|
106 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
540
|
107 General:
|
|
1201
|
108 - x11: X11 with optional SHM extension
|
|
540
|
109 - xv: X11 using overlays with the Xvideo extension (hardware YUV & scaling)
|
|
908
|
110 - gl: OpenGL renderer, so far works only with :
|
|
|
111 - all cards with Utah-GLX
|
|
|
112 - Matrox cards with X/DRI >=4.0.3
|
|
|
113 - Radeon with X/DRI CVS
|
|
540
|
114 - dga: X11 DGA extension
|
|
|
115 - fbdev:Output to general framebuffers
|
|
|
116 - svga: Output to SVGAlib
|
|
1056
|
117 - sdl: 1.1.7 : supports software scaling
|
|
1201
|
118 1.1.8 : supports Xvideo (hardware scaling/fullscreen)
|
|
|
119 1.2.0 : supports aalib (textmode rendering, very funny!)
|
|
|
120 - ggi: similar to SDL
|
|
540
|
121
|
|
|
122 Card specific:
|
|
96
|
123 - mga: Matrox G200/G400 hardware YUV overlay via the mga_vid device
|
|
|
124 - xmga: Matrox G200/G400 overlay (mga_vid) in X11 window
|
|
1
|
125 (Xv emulation on X 3.3.x !)
|
|
907
|
126 - syncfb: Matrox G400 YUV support on framebuffer (obsoleted, use mga/xmga)
|
|
540
|
127 - 3dfx: Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)
|
|
|
128
|
|
|
129 Special:
|
|
|
130 - png: PNG files output (use -z switch to set compression)
|
|
670
|
131 - pgm: PGM files output (for testing purposes or ffmpeg encoding)
|
|
907
|
132 - md5: MD5sum output (for MPEG conformance tests)
|
|
540
|
133 - odivx:OpenDivX AVI File writer (use -br to set encoding bitrate)
|
|
352
|
134 - null: Null output (for speed tests/benchmarking)
|
|
96
|
135
|
|
1201
|
136 NOTE: check DOCS/VIDEOCARDS for details and requirements!
|
|
1
|
137
|
|
|
138 Supported audio output devices:
|
|
|
139 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
1201
|
140 - OSS (ioctl) driver
|
|
|
141 - SDL driver (supports up/downsampling, esd, arts etc)
|
|
|
142 - native ALSA 0.5 driver
|
|
|
143 - native ALSA 0.9 driver (buggy, use OSS emulation!)
|
|
|
144 - native ESD driver (under development?)
|
|
|
145 - SUN audio driver (/dev/audio) for BSD and Solaris8 users
|
|
1
|
146
|
|
540
|
147 NOTE: check DOCS/SOUNDCARDS for details!
|
|
96
|
148
|
|
1
|
149 Speed:
|
|
|
150 ~~~~~~
|
|
764
|
151 Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!/3DNow!Ex.
|
|
1
|
152 You can improve rendering speed by setting up MTRR registers, see doc in MTRR.
|
|
907
|
153 Some *old* benchmark results can be found in the file DOCS/SPEED.
|
|
1
|
154
|
|
|
155 Usage:
|
|
|
156 ~~~~~~
|
|
1201
|
157 file: mplayer [options] [path/]filename
|
|
|
158 VCD: mplayer [options] -vcd trackno /dev/cdrom
|
|
|
159 DVD: mplayer [options] -dvdauth /dev/dvd filename.VOB
|
|
|
160 net: mplayer [options] http://site.com/file.[mpg|avi]
|
|
1
|
161
|
|
|
162 Options:
|
|
540
|
163 see `mplayer -h' for options
|
|
1201
|
164 see `mplayer -vo help' for list of available video output drivers
|
|
|
165 see `mplayer -ao help' for list of available audio output drivers
|
|
1
|
166
|
|
|
167 Keys:
|
|
|
168 <- or -> seek backward/forward 10 seconds
|
|
|
169 up or down seek backward/forward 1 minute
|
|
|
170 p or SPACE pause movie (press any key to continue)
|
|
|
171 q or ^C stop playing and quit program
|
|
522
|
172 o toggle OSD : none / seek / seek+timer
|
|
|
173 / and * decrease/increase volume
|
|
|
174 m toggle using master/pcm channel for volume setting
|
|
670
|
175 f toggle fullscreen (only with -vo sdl)
|
|
1
|
176
|
|
|
177 Examples:
|
|
|
178 mplayer -vo x11 /mnt/Films/Contact/contact2.mpg
|
|
670
|
179 mplayer -vcd 2 /dev/cdrom
|
|
1
|
180 mplayer -afm 3 /mnt/DVDtrailers/alien4.vob
|
|
522
|
181 mplayer -dvd /dev/dvd /mnt/dvd/matrix.vob
|
|
747
|
182 mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi
|
|
1
|
183
|
|
522
|
184 Note: in order to use Matrox YUV driver (-vo mga or xmga), first you'll have
|
|
764
|
185 to load the driver: see DOCS/VIDEOCARDS .
|
|
1
|
186
|
|
1071
|
187 Playing from Net & stdin:
|
|
|
188 ~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
693
|
189 Now it's possible.
|
|
|
190
|
|
|
191 To play something by reading from stdin, just use '-' as filename:
|
|
|
192
|
|
|
193 cat test.mpg | mplayer -vo xv -
|
|
|
194
|
|
|
195 Restrictions:
|
|
|
196 mpg: no backward seeking
|
|
|
197 asf: no backward seeking
|
|
|
198 avi: no index reading -> no seeking at all, and playing of some files are
|
|
|
199 +impossible
|
|
|
200
|
|
|
201 No control from controlling terminal/xterm, but hotkeys and osd works
|
|
|
202 from the window. or course LIRC still works everywhere.
|
|
|
203
|
|
|
204 This feature combined with external wrappers extends possibilities.
|
|
|
205 For example, to play a movie just downloaded from your favourite divx
|
|
|
206 server:
|
|
|
207 rar p ast-nssvcd.rar | mplayer -vo xmga -fs -
|
|
1071
|
208 or:
|
|
694
|
209 wget ftp://micorsops.com/something.avi -O - | mplayer -
|
|
|
210
|
|
693
|
211
|
|
1
|
212 TV output:
|
|
|
213 ~~~~~~~~~~
|
|
670
|
214 If you have a Matrox G400 Dual-Head card, you can watch movies on TV, using
|
|
|
215 the TV-out feature of the second head. Read DOCS/TVout-G400 for details!
|
|
1
|
216
|
|
670
|
217 Sending bugreports, comments, feature requests etc:
|
|
|
218 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
219 First please read all the docs in this package, most of the problems are
|
|
|
220 described somewhere. At least read DOCS/BUGS ! We don't like answering
|
|
|
221 questions which are already answered in this readme or other docs.
|
|
1
|
222
|
|
674
|
223 Read the DOCS/MPlayer-FAQ. Most common problems are answered there!
|
|
1
|
224
|
|
670
|
225 You should try the latest development version (from CVS) too, maybe your
|
|
|
226 bug is already fixed, but the new version hasn't been released.
|
|
|
227 If you couldn't solve the problem, then send a quality bugreport:
|
|
|
228 read DOCS/BUGREPORTS for instructions (where, what and how...)
|
|
1
|
229
|
|
670
|
230 Subscribe to the mplayer-users mailing list. There are many MPlayer
|
|
|
231 users, maybe they can help or know the solution to your problem.
|
|
|
232 You also should send ideas, feature requests, comments to there!
|
|
|
233 Please do not ask for features already listed in the DOCS/TODO!
|
|
1
|
234
|
|
6
|
235 Contact information:
|
|
|
236 ~~~~~~~~~~~~~~~~~~~~
|
|
10
|
237 Homepage: http://mplayer.sourceforge.net
|
|
1
|
238
|
|
|
239 Mailing lists:
|
|
|
240 ~~~~~~~~~~~~~~
|
|
107
|
241 There are some public mailing lists on MPlayer. Subscribing can be achieved on
|
|
40
|
242 the following addresses:
|
|
1
|
243
|
|
1074
|
244 - MPlayer core/hungarian developers list:
|
|
749
|
245 http://lists.sourceforge.net/lists/listinfo/mplayer-devel
|
|
|
246
|
|
1074
|
247 I dunno, it is the FLAME list in hungarian language :)
|
|
|
248 Also some talking about mplayer core team internals, like mplayer
|
|
|
249 party, sponsors etc can be here.
|
|
|
250
|
|
|
251 - MPlayer developers list:
|
|
749
|
252 http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng
|
|
|
253
|
|
1074
|
254 This list is about mplayer development! Talking about interface/API changes,
|
|
|
255 new libraryes, code optimization, ./configure changes, and send patches here.
|
|
|
256 Do NOT send bugreports, user questions, feature requests here!
|
|
|
257 This list should be kept low-traffic.
|
|
|
258
|
|
|
259 - MPlayer users list:
|
|
60
|
260 http://lists.sourceforge.net/lists/listinfo/mplayer-users
|
|
107
|
261
|
|
1074
|
262 - send bugreports here (after reading DOCS/BUGS, BUGREPORTS)
|
|
|
263 - send feature requests here (after reading DOCS/TODO)
|
|
|
264 - send user questions here (after reading DOCS/README, INSTALL, FAQ etc)
|
|
|
265
|
|
|
266 - MPlayer & Matrox G200/G400/G450 users:
|
|
670
|
267 http://lists.sourceforge.net/lists/listinfo/mplayer-matrox
|
|
|
268
|
|
1074
|
269 Send matrox-related questions here,
|
|
|
270 - things about mga_vid,
|
|
1201
|
271 - matrox's official beta drivers (for X 4.x.x)
|
|
1074
|
272 - and about matroxfb-TVout stuff.
|
|
|
273
|
|
806
|
274 - mpg12play-portable developers:
|
|
|
275 http://lists.sourceforge.net/lists/listinfo/mplayer-mpg12play
|
|
|
276
|
|
1074
|
277 This list is for talking about mplayer ports to non-x86 platforms
|
|
|
278 (IRIX, Solaris-SPARC, Alpha, Commodore64, Sharp Calculator,
|
|
|
279 Teapot etc...)
|
|
|
280
|
|
|
281 - MPlayer announce:
|
|
60
|
282 http://lists.sourceforge.net/lists/listinfo/mplayer-announce
|
|
107
|
283
|
|
1074
|
284 Very low traffic list :)
|
|
|
285 And it's read-only. I'll post something shit there if a new release
|
|
|
286 is done.
|
|
|
287
|
|
|
288 - MPlayer CVS-log:
|
|
107
|
289 http://lists.sourceforge.net/lists/listinfo/mplayer-cvslog
|
|
1
|
290
|
|
1074
|
291 Send only questions about CVS changes here.
|
|
|
292 (if you don't understand why a change is required or you've better fix)
|
|
|
293 Be sure in that your target developer reads this list!
|
|
|
294
|
|
749
|
295 NOTE: language of above lists are ENGLISH, unless explicitly stated otherwise.
|
|
|
296 Please do not send messages using other language!
|
|
670
|
297
|
|
764
|
298 License:
|
|
670
|
299 ~~~~~~~~
|
|
907
|
300 MPlayer incorporates a lot of code from other projects, but for now everything
|
|
|
301 except the OpenDivX stuff is under General Public License (GPL) version 2 or
|
|
|
302 later. See DOCS/COPYING
|
|
670
|
303
|
|
1
|
304 Standard Disclaimer:
|
|
|
305 ~~~~~~~~~~~~~~~~~~~~
|
|
522
|
306 Use only at your own risk! There may be errors and inaccuracies that could
|
|
907
|
307 damage your system, your eye or ear. Proceed with caution, and although this is
|
|
522
|
308 highly unlikely, we don't take any responsibility for that!
|
