Mercurial > mplayer.hg
annotate DOCS/mplayer.1 @ 1516:0053e6d0cda0
*** empty log message ***
author | gabucino |
---|---|
date | Tue, 14 Aug 2001 17:10:22 +0000 |
parents | 526047bdda07 |
children | 30078d692e63 |
rev | line source |
---|---|
1 | 1 .\" MPlayer (C) 2000-2001 Arpad Gereoffy <arpi@esp-team.scene.hu> |
2 .\" This manpage was/is done by Gabucino | |
3 .\" | |
733 | 4 .TH MPlayer-CVS |
1 | 5 .SH NAME |
6 mplayer \- Movie Player for Linux | |
7 .SH SYNOPSIS | |
8 .B mplayer | |
1516 | 9 .RB [ \-v\ ] |
10 .RB [ \-quiet\ ] | |
1287 | 11 .RB [ \-vo\ <driver>[:<device>]\ ] |
12 .RB [ \-ao\ <driver>[:<device>]\ ] | |
1 | 13 .RB [ \-vcd\ track\ number ] |
14 .RB [ \-sb\ byte\ position ] | |
15 .RB [ \-nosound\ ] | |
16 .RB [ \-abs\ seconds ] | |
17 .RB [ \-delay\ secs ] | |
1483 | 18 .RB [ \-bps\ ] |
1 | 19 .RB [ \-aid\ id ] |
20 .RB [ \-vid\ id ] | |
21 .RB [ \-fps\ rate ] | |
22 .RB [ \-mc\ seconds/5f ] | |
23 .RB [ \-fs\ ] | |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
24 .RB [ \-vm\ ] |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
25 .RB [ \-zoom\ ] |
1 | 26 .RB [ \-x\ x ] |
27 .RB [ \-y\ y ] | |
28 .RB [ \-xy\ factor ] | |
45 | 29 .RB [ \-pp\ quality ] |
164
2790235db59f
even more updates :) about time to crack a joke, eh? :))
gabucino
parents:
106
diff
changeset
|
30 .RB [ \-include\ configfile ] |
1153 | 31 .RB [ \-lircconf\ configfile ] |
222 | 32 .RB [ \-ffactor\ number ] |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
33 .RB [ \-sub\ file ] |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
34 .RB [ \-subfps\ rate ] |
484 | 35 .RB [ \-subdelay\ sec ] |
1022 | 36 .RB [ \-dvdauth\ device ] |
532
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
37 .RB [ \-z\ <0-8> ] |
574 | 38 .RB [ \-idx ] |
39 .RB [ \-forceidx ] | |
646 | 40 .RB [ \-nodshow ] |
41 .RB [ \-noxv ] | |
42 .RB [ \-forcexv ] | |
656 | 43 .RB [ \-ss\ sec ] |
791 | 44 .RB [ \-dumpaudio ] |
793 | 45 .RB [ \-dumpvideo ] |
801 | 46 .RB [ \-noframedrop ] |
47 .RB [ \-framedrop ] | |
1152 | 48 .RB [ \-nodouble ] |
49 .RB [ \-double ] | |
822 | 50 .RB [ \-dvdkey\ key ] |
868 | 51 .RB [ \-stereo\ mode ] |
986 | 52 .RB [ \-srate\ Hz ] |
1035 | 53 .RB [ \-osdlevel\ level ] |
1036 | 54 .RB [ \-config\ file ] |
1071 | 55 .RB [ \-display\ name ] |
1072 | 56 .RB [ \-unicode ] |
1389 | 57 .RB [ \-utf8 ] |
1273 | 58 .RB [ \-fsmode\ mode ] |
1363 | 59 .RB [ \-vc\ video\ codec\ name ] |
60 .RB [ \-ac\ audio\ codec\ name ] | |
61 .RB [ \-vfm\ video\ codec\ family ] | |
62 .RB [ \-afm\ audio\ codec\ family ] | |
1479 | 63 .RB [ \-frames\ number ] |
1493 | 64 .RB [ \-autoq\ quality ] |
1500 | 65 .RB [ \-fb\ device ] |
66 .RB [ \-fbmode\ modename ] | |
67 .RB [ \-fbmodeconfig filename ] | |
693 | 68 .I - or file |
1 | 69 .PP |
70 .SH DESCRIPTION | |
71 .I mplayer | |
72 Yes. Yet another movie player for linux. | |
73 What is the special with this? It works, at least for me :) | |
74 I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN, | |
75 xine,xanim,avifile,xmmp) but they all have some problem. Mostly with | |
76 special files or with audio/video sync. Most of them is unable to play | |
77 both mpeg1, mpeg2 and avi (DivX) files. Many players have image quality | |
78 or speed problems too. So I've decided to write/modify one... | |
79 .LP | |
80 .SH "GENERAL OPTIONS" | |
81 .TP | |
82 .I NOTE | |
83 MPlayer works out-of-the-box, so you generally don't have to mess with | |
84 any options. | |
85 .TP | |
790 | 86 .I NOTE |
87 Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs | |
88 .TP | |
1287 | 89 .B \-vo\ <driver>[:<device>] |
1288 | 90 select video output driver and optinaly device. "device" is valid with |
91 SDL and GGI too, it means sub-driver then (for example: -vo sdl:aalib). | |
1 | 92 |
93 you can get the list of available drivers executing | |
94 .I mplayer -vo help | |
95 | |
96 .TP | |
1287 | 97 .B \-ao\ <driver>[:<device>] |
1288 | 98 select audio output driver and optinaly device. "device" is valid with |
99 SDL and GGI too, it means sub-driver then (for example: -vo sdl:esd). | |
1208 | 100 |
101 If using OSS, you can specify which sound device to use like this : | |
1288 | 102 -ao oss:/dev/dsp1 (replaces the old -dsp option) |
986 | 103 |
104 you can get the list of available drivers executing | |
105 .I mplayer -ao help | |
106 | |
107 .TP | |
523 | 108 .B \-vcd\ track |
1 | 109 play video cd track from device instead of plain file |
110 .TP | |
1022 | 111 .B \-dvdauth\ device |
523 | 112 specify DVD-ROM drive to use for MPEG2 decoding. |
113 (use *_only_* when playing from DVD!) | |
114 .TP | |
115 .B \-nosound | |
1 | 116 don't play sound |
117 .TP | |
118 .B \-fs | |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
119 fullscreen playing (centers movie, and makes black |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
120 bands around it) |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
121 .TP |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
122 .B \-vm |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
123 use XF86VidMode extension for mode changing |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
124 .TP |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
125 .B \-zoom |
1035 | 126 use software scaling, where available (use with -nofs) |
1 | 127 .TP |
128 .B \-x\ x | |
129 scale image to x width [if driver suppports!] | |
130 .TP | |
131 .B \-y\ y | |
132 scale image to y height | |
133 .TP | |
134 .B \-xy\ factor | |
135 scale image by <factor> | |
136 .TP | |
45 | 137 .B \-pp\ quality |
1 | 138 apply postprocess filter on decoded image. |
139 You need a STRONG CPU in order to use this! | |
140 The supported formats and settings are: | |
141 | |
181 | 142 MPEG 1/2 0 (none), 1, 3, 7, 15, 31, 63 |
143 OpenDivX 0 (none), 1, 3, 7, 15, 31, 63 | |
144 DivX 0 (none), 1, 2, 3, 4 | |
1 | 145 |
146 .I NOTE | |
52 | 147 Maybe less/more. |
1493 | 148 .TP |
149 .B \-autoq\ quality | |
150 dynamically changes the level of postprocess, depending on spare CPU | |
151 time available. Uses the same value ranges as -pp . The number you | |
152 specify will be the maximum level used. Usually you can use some big | |
153 number. | |
1 | 154 .TP |
222 | 155 .B \-ffactor\ number |
156 resample alphamap of the font. Can be: | |
1 | 157 |
222 | 158 0 plain white fonts |
159 0.75 very narrow black outline [default] | |
160 1 narrow black outline | |
161 10 bold black outline | |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
162 .TP |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
163 .B \-sub\ file |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
164 use/display this subtitle file |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
165 .TP |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
166 .B \-subfps\ rate |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
167 specify frame/sec rate of subtitle file |
521 | 168 (ONLY for frame-based SUB files, i.e. NOT MicroDVD format!) |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
169 (default: the same as the movie) |
484 | 170 .TP |
171 .B \-subdelay\ sec | |
172 delays subtitles by <sec> seconds. Can be negative. | |
1035 | 173 .TP |
174 .B \-osdlevel\ level | |
1037 | 175 specifies which mode the OSD should start in (0 : none, 1 : seek, 2: seek+timer) |
176 (default = 2) | |
1208 | 177 .TP |
1153 | 178 .B \-lircconf\ configfile |
1151 | 179 specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc |
1516 | 180 .TP |
181 .B \-v\ | |
182 enable verbose output (more -v means more verbose) | |
183 .TP | |
184 .B \-quiet\ | |
185 display less output, status messages. | |
1 | 186 .IP |
187 .SH "ADVANCED OPTIONS" | |
188 .TP | |
189 .I NOTE | |
190 These options can help you solve your particular problem.. Also, see the DOCS! | |
191 .TP | |
1363 | 192 .B \-vc <name> |
193 force usage of a specific video codec, according to its name in codecs.conf, | |
194 for example : | |
195 | |
196 -vc divx use VFW DivX codec | |
197 -vc divxds use DirectShow DivX codec | |
198 -vc ffdivx use libavcodec's DivX codec | |
199 -vc divx4 use ProjectMayo's DivX codec | |
200 .TP | |
201 .B \-ac <name> | |
202 force usage of a specific audio codec, according to its name in codecs.conf, | |
203 for example : | |
1 | 204 |
1363 | 205 -ac mp3 use libmp3 MP3 codec |
206 -ac mp3acm use l3codeca.acm MP3 codec | |
207 -ac ac3 use AC3 codec | |
208 .TP | |
209 .B \-vfm <1-5> | |
1380 | 210 force usage of a specific codec FAMILY, and FALLBACK to default if failed. |
1377 | 211 For example: |
1364 | 212 |
213 -vfm 2 use VFW (Win32) codecs | |
1377 | 214 -vfm 3 use OpenDivX codec (YV12) |
1380 | 215 (same as -vc odivx but fallback) |
1364 | 216 -vfm 4 use DirectShow (Win32) codecs |
217 -vfm 5 use libavcodec codecs | |
1377 | 218 -vfm 7 use DivX4Linux codec (YUY2) |
1380 | 219 (same as -vc divx4 but fallback) |
1377 | 220 |
221 NOTE : type 3 and 7 now contains just the one same codec, then OpenDivX 4.0 | |
222 beta. For difference between them and when to use which, check the OpenDivX | |
223 section in the documentation. | |
1363 | 224 .TP |
225 .B \-afm <1-5> | |
226 force usage of a specific audio format. For example: | |
1364 | 227 |
228 -afm 1 use libmp3 (mp1/mp2/mp3) | |
229 -afm 2 suppose raw PCM audio | |
230 -afm 3 use libac3 | |
231 -afm 4 use a matching Win32 codec | |
232 -afm 5 use aLaw/uLaw driver | |
1 | 233 .TP |
523 | 234 .B \-sb\ position |
1 | 235 seek to byte position |
1206 | 236 .TP |
656 | 237 .B \-ss\ second |
238 seek to second position | |
1 | 239 .TP |
523 | 240 .B \-abs\ bytes |
1 | 241 audio buffer size (in bytes, default: measuring) |
242 .TP | |
243 .B \-delay\ secs | |
244 audio delay in seconds (may be +/- float value) | |
245 .TP | |
246 .B \-bps | |
247 use avg. byte/sec value for A-V sync (AVI) | |
248 .TP | |
249 .B \-aid\ id | |
250 select audio channel [MPG: 0-31 AVI: 1-99] | |
251 .TP | |
252 .B \-vid\ id | |
253 select video channel [MPG: 0-15 AVI: -- ] | |
254 .TP | |
255 .B \-fps\ value | |
256 force frame rate (if value is wrong in the header) | |
257 .TP | |
258 .B \-mc\ seconds/5frame | |
259 maximum sync correction per 5 frames (in seconds) | |
260 .TP | |
261 .B \-ni | |
262 force usage of non-interleaved AVI parser | |
164
2790235db59f
even more updates :) about time to crack a joke, eh? :))
gabucino
parents:
106
diff
changeset
|
263 .TP |
2790235db59f
even more updates :) about time to crack a joke, eh? :))
gabucino
parents:
106
diff
changeset
|
264 .B \-include |
2790235db59f
even more updates :) about time to crack a joke, eh? :))
gabucino
parents:
106
diff
changeset
|
265 specify config file to be parsed after the default |
532
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
266 .TP |
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
267 .B \-z\ <0-8> |
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
268 specifies compression level for PNG output |
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
269 0 : no compression |
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
270 8 : max compression |
574 | 271 .TP |
272 .B \-idx | |
273 rebuilds INDEX of the AVI. Useful with broken downloads, or badly | |
274 created AVIs. | |
275 .TP | |
276 .B \-forceidx | |
277 force rebuilding of INDEX. Useful for testing, or AVIs with bad | |
278 indexes. | |
629 | 279 .TP |
280 .B \-nodshow | |
630 | 281 disables usage of DirectShow video codecs |
646 | 282 .TP |
283 .B \-noxv | |
284 disable XVideo hardware acceleration (with SDL only!) | |
285 .TP | |
286 .B \-forcexv | |
287 force using XVideo (SDL!) | |
791 | 288 .TP |
289 .B \-dumpaudio | |
793 | 290 writes audio stream of the file to ./stream.dump (mostly usable |
291 with mpeg/ac3) | |
801 | 292 .TP |
293 .B \-noframedrop | |
1160 | 294 no frame dropping : every frame is played, audio and video may be out of |
295 sync (default) | |
801 | 296 .TP |
297 .B \-framedrop | |
298 frame dropping : decode all frames, video may skip | |
299 .TP | |
1151 | 300 .B \-nodouble |
301 disable doublebuffering (default). Currently this is only honoured by the DGA driver. | |
302 With the DGA driver this also disables OSD support but yields some speed gain. | |
303 .TP | |
304 .B \-double | |
305 enable doublebuffering. Currently this is only honoured by the DGA driver. | |
306 .TP | |
822 | 307 .B \-dvdkey key |
308 key to decrypt stream encrypted with CSS. For example : -dvdkey F169072699 | |
1022 | 309 (this is NOT for DVD playing! For DVD use the -dvdauth option!) |
868 | 310 .TP |
311 .B \-stereo mode | |
312 select type of MPEG1 stereo output. Mode may be 0:stereo 1:left 2:right | |
313 | |
314 Stereo 0 | |
315 Left channel 1 | |
316 Right channel 2 | |
317 | |
986 | 318 .TP |
319 .B \-srate Hz | |
320 specifies Hz to playback audio on. Has effect on playback speed! | |
1036 | 321 .TP |
322 .B \-config configfile | |
323 specifies where to search for config file | |
1071 | 324 .TP |
325 .B \-display name | |
326 specify the hostname and display number of the X server you want | |
327 to display on. For example : -display xtest.localdomain:0 | |
1072 | 328 .TP |
329 .B \-unicode | |
1389 | 330 tells MPlayer to handle the subtitle file as UNICODE. |
1072 | 331 Contrary: -nounicode |
1206 | 332 .TP |
1389 | 333 .B \-utf8 |
334 tells MPlayer to handle the subtitle file as UTF8. | |
335 .TP | |
1273 | 336 .B \-fsmode\ mode |
337 This option workarounds some problems when using specific windowmanagers and | |
338 fullscreen mode. If you experience fullscreen problems, try changing this | |
339 value between 0 and 7. | |
1500 | 340 |
1274 | 341 -fsmode 0 new method (since 0.18pre3) |
342 -fsmode 1 ICCCWM patch (for KDE2/icewm) | |
343 -fsmode 2 old method (0.17a) | |
1275 | 344 -fsmode 3 ICCCWM patch + Motif method |
1479 | 345 .TP |
346 .B \-frames\ number | |
347 MPlayer plays <number> frames, then quits. | |
1500 | 348 .TP |
349 .B \-fb\ device | |
350 Specifies the framebuffer device to use. By default it uses /dev/fb0 . | |
351 Only valid for the fbdev driver. | |
352 .TP | |
353 .B \-fbmode\ modename | |
354 Change videomode to the one that is labelled as <modename> in /etc/fb.modes . | |
355 Only valid for the fbdev driver. | |
356 .TP | |
357 .I NOTE | |
358 VESA framebuffer doesn't support mode changing. | |
359 .TP | |
360 .B \-fbmodeconfig\ filename | |
361 Use this config file instead of the default /etc/fb.modes . | |
362 Only valid for the fbdev driver. | |
1 | 363 .IP |
364 .SH "ALPHA/BETA CODE" | |
365 .TP | |
366 .I NOTE | |
367 These are included in this manpage just for completeness! If you don't | |
368 know what are these, you DON'T need these! In either case, double-check DOCS! | |
369 .TP | |
370 .B \-br\ rate | |
371 used with '-vo odivx' . | |
372 Specifies the bitrate to encode OpenDivx at | |
373 (in bits! e.g: 780000). | |
374 .TP | |
375 .B \-encode\ file | |
376 used with '-vo odivx' . | |
377 Specifies the output OpenDivX file. Won't overwrite. | |
793 | 378 .TP |
379 .B \-dumpvideo | |
380 dump video stream to ./stream.dump (only with MPEG-PS) (not very usable) | |
1 | 381 .IP |
222 | 382 .SH KEYBOARD CONTROL |
383 .TP | |
384 .I NOTE | |
385 These keys may/may not work, depending on your video output driver. | |
386 .TP | |
387 <- or -> seek backward/forward 10 seconds | |
388 | |
389 up or down seek backward/forward 1 minute | |
390 | |
391 p or SPACE pause movie (press any key) | |
392 | |
393 q or ESC stop playing and quit program | |
394 | |
962 | 395 + or - adjust audio delay by +/- 0.1 second |
389 | 396 |
454 | 397 / or * decrease/increase volume |
398 | |
523 | 399 o toggle OSD: none / seek / seek+timer |
474 | 400 |
484 | 401 m toggle using master/pcm volume |
801 | 402 |
948 | 403 z or x adjust subtitle delay by +/- 0.1 second |
222 | 404 .IP |
405 .SH FILES AND DIRECTORIES | |
406 .TP | |
407 .I CONFIG FILES | |
408 Settings are stored system-wide in the /etc/mplayer.conf file, | |
409 and per-user in $HOME/.mplayer/config. The directory | |
410 $HOME/.mplayer and the 'config' are created if doesn't exist. | |
411 .TP | |
412 .I FONTS | |
413 Fonts are searched in $HOME/.mplayer/font. There must be a font.desc | |
414 file, and files with .RAW extension. | |
415 .TP | |
224 | 416 .I SUBTITLE FILES |
899 | 417 MPlayer currently supports 6 subtitle formats : MicroDVD, SubRip, unnamed, |
943 | 418 SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha). |
899 | 419 Sub files are searched in this priority : (for example /mnt/cdrom/movie.avi) |
420 /mnt/cdrom/movie.sub | |
421 (SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT) | |
422 $HOME/.mplayer/sub/movie.sub | |
423 (SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT) | |
424 $HOME/.mplayer/default.sub | |
222 | 425 .IP |
1 | 426 .SH "EXAMPLES" |
427 Just launch it! :) | |
428 .LP | |
429 .SH BUGS | |
96 | 430 Probably. Check DOCS. |
1 | 431 |
432 Bugreports should be addressed to the MPlayer-users mailing list | |
40 | 433 (mplayer-users@lists.sourceforge.net) ! If you want to submit a bugreport |
899 | 434 (which we love to receive!), please double-check the DOCS/BUGREPORTS, and |
1 | 435 tell us all that we need to know to identify your problem. |
436 | |
437 .LP | |
438 .SH AUTHORS | |
439 Check DOCS/AUTHORS ! | |
440 | |
441 MPlayer is (C) 2000-2001 | |
442 .I Arpad Gereoffy <arpi@thot.banki.hu> | |
443 | |
444 This manpage is maintained by | |
445 .I Gabucino. | |
446 .LP | |
447 .SH STANDARD DISCLAIMER | |
448 Use only at your own risk! There may be errors and inaccuracies that could | |
449 be damaging to your system or your eye. Proceed with caution, and although | |
450 this is highly unlikely, the author doesn't take any responsibility for that! | |
451 .\" end of file |