aboutsummaryrefslogtreecommitdiffhomepage
path: root/DOCS/mplayer.1
blob: c30358de9e4de999ae2c23e5fa367c5e042a58e8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
.\" MPlayer (C) 2000-2001 Arpad Gereoffy <arpi@esp-team.scene.hu>
.\" This manpage was/is done by Gabucino
.\"
.TH MPlayer
.SH NAME
mplayer \- Movie Player for Linux
.SH SYNOPSIS
.B mplayer
.RB [ \-gui ]
.RB [ \-v ]
.RB [ \-quiet ]
.RB [ \-vo\ <driver>[:<device>] ]
.RB [ \-ao\ <driver>[:<device>] ]
.RB [ \-vcd\ track\ number ]
.RB [ \-sb\ byte\ position ]
.RB [ \-nosound ]
.RB [ \-abs\ bytes ]
.RB [ \-delay\ secs ]
.RB [ \-nobps ]
.RB [ \-aid\ id ]
.RB [ \-vid\ id ]
.RB [ \-fps\ rate ]
.RB [ \-mc\ seconds/5f ]
.RB [ \-fs ]
.RB [ \-vm ]
.RB [ \-zoom ]
.RB [ \-x\ x ]
.RB [ \-y\ y ]
.RB [ \-xy\ factor ]
.RB [ \-pp\ quality ]
.RB [ \-include\ configfile ]
.RB [ \-lircconf\ configfile ]
.RB [ \-ffactor\ number ]
.RB [ \-sub\ file ]
.RB [ \-subfps\ rate ]
.RB [ \-subdelay\ sec ]
.RB [ \-z\ <0-8> ]
.RB [ \-idx ]
.RB [ \-forceidx ]
.RB [ \-nodshow ]
.RB [ \-noxv ]
.RB [ \-forcexv ]
.RB [ \-ss\ time ]
.RB [ \-dumpaudio ]
.RB [ \-dumpvideo ]
.RB [ \-noframedrop ]
.RB [ \-framedrop ]
.RB [ \-nodouble ]
.RB [ \-double ]
.RB [ \-stereo\ mode ]
.RB [ \-srate\ Hz ]
.RB [ \-osdlevel\ level ]
.RB [ \-config\ file ]
.RB [ \-display\ name ]
.RB [ \-unicode ]
.RB [ \-utf8 ]
.RB [ \-fsmode\ mode ]
.RB [ \-vc\ video\ codec\ name ]
.RB [ \-ac\ audio\ codec\ name ]
.RB [ \-vfm\ video\ codec\ family ]
.RB [ \-afm\ audio\ codec\ family ]
.RB [ \-frames\ number ]
.RB [ \-autoq\ quality ]
.RB [ \-fb\ device ]
.RB [ \-fbmode\ modename ]
.RB [ \-fbmodeconfig\ filename ]
.RB [ \-benchmark ]
.RB [ \-dvd\ titleid ]
.RB [ \-chapter\ chapterid ]
.RB [ \-dvdangle\ angleid ]
.RB [ \-dvdkey\ key ]
.RB [ \-skin\ skin ]
.RB [ \-aspect\ ratio ]
.RB [ \-monitoraspect\ ratio ]
.RB [ \-subcp\ codepage ]
.RB [ \-dumpmpsub ]
.RB [ \-screenw\ pixels ]
.RB [ \-screenh\ pixels ]
.RB [ \-cache\ kbytes ]
.RB [ \-bpp\ depth ]
.RB [ \-flip ]
.I - or file or device
.PP
.SH DESCRIPTION
.I mplayer
MPlayer is a movie player for LINUX (runs on many other Unices, and
non-x86 CPUs, see section 6). It plays most MPEG, AVI and ASF/WMV files,
supported by many native and Win32 DLL codecs. You can watch VideoCD,
SVCD, DVD and even DivX movies too (and you don't need the avifile library
at all!). The another big feature of mplayer is the wide range of
supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib,
fbdev, AAlib, but you can use SDL (and this way all drivers of SDL) and
some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon) too!
Most of them supports software or hardware scaling, so you can enjoy
movies in fullscreen. And what about the nice big antialiased shaded
subtitles (7 supported types!!!) with european/ISO 8859-1,2 (hungarian,
english, czech, etc), cyrillic, korean fonts, and OSD?
.LP
.SH "GENERAL OPTIONS"
.TP
.I NOTE
Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs
.TP
.B \-gui
start MPlayer with the GUI mode. You have to compile it in, for details
see the documentation.
.TP
.B \-dvd\ titleid
tell MPlayer which movies (marked with titleid) to play. For example
sometimes '1' are trailers, and '2' is the real movie.
.TP
.B \-chapter\ chapterid
specify which chapter to start playing at. Examples can be found below.
.TP
.B \-dvdangle\ angleid
some DVD discs contain scenes that can be viewed from multiple angles.
Here you can tell MPlayer which angles to use. Examples can be found below.
.TP
.B \-vo\ <driver>[:<device>]
select video output driver and optinaly device. "device" is valid with
SDL and GGI too, it means sub-driver then (for example: -vo sdl:aalib).

you can get the list of available drivers executing
.I mplayer -vo help

.TP
.B \-ao\ <driver>[:<device>]
select audio output driver and optinaly device. "device" is valid with
SDL too, it means sub-driver then (for example: -vo sdl:esd).

If using OSS, you can specify which sound device to use like this :
-ao oss:/dev/dsp1     (replaces the old -dsp option)

you can get the list of available drivers executing
.I mplayer -ao help

.TP
.B \-vcd\ track
play video cd track from device instead of plain file
.TP
.B \-nosound
don't play sound
.TP
.B \-fs
fullscreen playing (centers movie, and makes black
bands around it)
.TP
.B \-vm
try to change to a different video mode. dga2, x11 (XF86VidMode) and sdl
output drivers support it.
.TP
.B \-zoom
use software scaling, where available (use with -nofs). svga, x11, vesa
output drivers support it.
.TP
.B \-flip
flip image (useful for example for old Indeo codecs). Supported only(?)
by the 'sdl' and 'x11' outputs.
.TP
.B \-x\ x
scale image to x width [if driver suppports!]
.TP
.B \-y\ y
scale image to y height
.TP
.B \-xy\ factor
scale image by <factor>
.TP
.B \-pp\ quality
apply postprocess filter on decoded image.
You need a STRONG CPU in order to use this!
The supported formats and settings are:

        MPEG 1/2   0 (none), 1, 3, 7, 15, 31, 63
        OpenDivX   0 (none), 1, 3, 7, 15, 31, 63
        DivX4      0 (none) - 60
        DivX       0 (none), 1, 2, 3, 4

.TP
.B \-autoq\ quality
dynamically changes the level of postprocess, depending on spare CPU
time available. Uses the same value ranges as -pp . The number you
specify will be the maximum level used. Usually you can use some big
number. You don't have to (and don't) use together with -pp !
.TP
.B \-ffactor\ number
resample alphamap of the font. Can be:

        0    plain white fonts
        0.75 very narrow black outline [default]
        1    narrow black outline
        10   bold black outline
.TP
.B \-sub\ file
use/display this subtitle file
.TP
.B \-subfps\ rate
specify frame/sec rate of subtitle file
(ONLY for frame-based SUB files, i.e. NOT MicroDVD format!)
(default: the same as the movie)
.TP
.B \-subdelay\ sec
delays subtitles by <sec> seconds. Can be negative.
.TP
.B \-osdlevel\ level
specifies which mode the OSD should start in (0 : none, 1 : seek, 2: seek+timer)
(default = 2)
.TP
.B \-lircconf\ configfile
specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc 
.TP
.B \-v
enable verbose output (more -v means more verbose)
.TP
.B \-quiet
display less output, status messages.
.TP
.B \-benchmark
used in combination with -nosound and -vo null for benchmarking.
.TP
.B \-skin skin directory
load skin from this directory (WITHOUT path name!). For example '-skin fittyfene' tries these :

    /usr/local/share/mplayer/Skin/fittyfene
    ~/.mplayer/Skin/fittyfene
.TP
.B \-aspect ratio
set aspect ratio of movies. It's autodetected on MPEG files, and can't be
autodetected on AVI files. Examples:

    -aspect 4:3  or -aspect 1.3333
    -aspect 16:9 or -aspect 1.7777

(has -noaspect pair)
.TP
.B \-monitoraspect ratio
set aspect ratio of your screen. Examples:

    -monitoraspect 4:3  or 1.3333
    -monitoraspect 16:9 or 1.7777

.IP
.SH "ADVANCED OPTIONS"
.TP
.I NOTE
These options can help you solve your particular problem.. Also, see the
documentation !
.TP
.B \-vc <name>
force usage of a specific video codec, according to its name in codecs.conf,
for example :

    -vc divx       use VFW DivX codec
    -vc divxds     use DirectShow DivX codec
    -vc ffdivx     use libavcodec's DivX codec
    -vc ffmpeg12   use libavcodec's MPEG1/2 codec
    -vc divx4      use ProjectMayo's DivX codec

See -vc help for FULL list !
.TP
.B \-ac <name>
force usage of a specific audio codec, according to its name in codecs.conf,
for example :

    -ac mp3        use libmp3 MP3 codec
    -ac mp3acm     use l3codeca.acm MP3 codec
    -ac ac3        use AC3 codec
    -ac hwac3      enable Hardware AC3 passthrough
                   (see documentation)
    -ac vorbis     use libvorbis
    -ac ffmp3      use ffmpeg's MP3 decoder (SLOW)

See -ac help for FULL list !
.TP
.B \-vfm <1-5>
force usage of a specific codec FAMILY, and FALLBACK to default if failed.
For example:

    -vfm 2         use VFW (Win32) codecs
    -vfm 3         use OpenDivX/DivX4 codec (YV12)
                   (same as -vc odivx but fallback)
    -vfm 4         use DirectShow (Win32) codecs
    -vfm 5         use libavcodec codecs
    -vfm 7         use DivX4 codec (YUY2)
                   (same as -vc divx4 but fallback)
    -vfm 10        use XAnim codecs

See -vc help for FULL list !

NOTE : if libdivxdecore support was compiled in, then type 3 and 7 now contains
just the same DivX4 codec, but different APIs to reach it. For difference
between them and when to use which, check the DivX4 section in the
documentation.
.TP
.B \-afm <1-5>
force usage of a specific audio format. For example:

    -afm 1         use libmp3 (mp2/mp3,
                   but not mp1)
    -afm 2         suppose raw PCM audio
    -afm 3         use libac3
    -afm 4         use a matching Win32 codec
    -afm 5         use aLaw/uLaw driver
    -afm 10        use libvorbis
    -afm 11        use ffmpeg's MP3 decoder (even mp1)

See -ac help for FULL list !
.TP
.B \-sb\ position
seek to byte position
.TP
.B \-ss\ time
seek to given time position. For example :

    -ss 56
    -ss 01:10:00

.TP
.B \-bpp\ depth
use different color depth than autodetect. Not all -vo drivers support
it (fbdev, dga2, svga, vesa).
.TP
.B \-abs\ bytes
sound card audio buffer size (in bytes, default: measuring)
.TP
.B \-delay\ secs
audio delay in seconds (may be +/- float value)
.TP
.B \-nobps
don't use avg. byte/sec value for A-V sync (AVI)
.TP
.B \-aid\ id
select audio channel [MPG: 0-31 AVI: 1-99 ASF: 0-127 VOB: 128-...]
.TP
.B \-vid\ id
select video channel [MPG: 0-15  AVI:  -- ]
.TP
.B \-fps\ value
force frame rate (if value is wrong in the header)
.TP
.B \-mc\ seconds/5frame
maximum sync correction per 5 frames (in seconds)
.TP
.B \-ni
force usage of non-interleaved AVI parser
.TP
.B \-include configfile
specify config file to be parsed after the default
.TP
.B \-z\ <0-8>
specifies compression level for PNG output
          0 : no compression
          8 : max compression
.TP
.B \-idx
rebuilds INDEX of the AVI. Useful with broken downloads, or badly
created AVIs.
.TP
.B \-forceidx
force rebuilding of INDEX. Useful for testing, or AVIs with bad
indexes.
.TP
.B \-nodshow
disables usage of DirectShow video codecs
.TP
.B \-noxv
disable XVideo hardware acceleration (with SDL only!)
.TP
.B \-forcexv
force using XVideo (SDL!)
.TP
.B \-dumpaudio
writes audio stream of the file to ./stream.dump (mostly usable
with mpeg/ac3)
.TP
.B \-noframedrop
no frame dropping : every frame is played, audio and video may be out of
sync (default)
.TP
.B \-framedrop
frame dropping : decode all frames, video may skip
.TP
.B \-nodouble
disable doublebuffering (default). Currently this is only honoured by the Xv and the DGA driver.
With the DGA driver this also disables OSD support but yields some speed gain.
.TP
.B \-double
enable doublebuffering. Currently this is only honoured by the Xv and the DGA driver.
.TP
.B \-dvdkey key
key to decrypt stream encrypted with CSS. For example : -dvdkey F169072699
(this is NOT for DVD playing! For DVD use the -dvd option!)
.TP
.B \-stereo mode
select type of MPEG1 stereo output.

        Stereo         0
        Left channel   1
        Right channel  2

.TP
.B \-srate Hz
specifies Hz to playback audio on. Has effect on playback speed!
.TP
.B \-config configfile
specifies where to search for config file
.TP
.B \-display name
specify the hostname and display number of the X server you want
to display on. For example : -display xtest.localdomain:0
.TP
.B \-unicode
tells MPlayer to handle the subtitle file as UNICODE.
Contrary: -nounicode
.TP
.B \-utf8
tells MPlayer to handle the subtitle file as UTF8.
.TP
.B \-fsmode\ mode
This option workarounds some problems when using specific windowmanagers and
fullscreen mode. If you experience fullscreen problems, try changing this
value between 0 and 7.

        -fsmode 0      new method
        -fsmode 1      ICCCWM patch
                       (for KDE2/icewm)
        -fsmode 2      old method
        -fsmode 3      ICCCWM patch
                       plus Motif method
.TP
.B \-frames\ number
MPlayer plays <number> frames, then quits.
.TP
.B \-fb\ device
Specifies the framebuffer device to use. By default it uses /dev/fb0 .
Only valid for the fbdev driver.
.TP
.B \-fbmode\ modename
Change videomode to the one that is labelled as <modename> in /etc/fb.modes .
Only valid for the fbdev driver.
.TP
.I NOTE
VESA framebuffer doesn't support mode changing.
.TP
.B \-fbmodeconfig\ filename
Use this config file instead of the default /etc/fb.modes .
Only valid for the fbdev driver.
.TP
.B \-subcp\ codepage
If your system supports iconv(3), you can use this option to
specify codepage of the subtitle. Examples:

        -subcp latin2
        -subcp cp1250

.TP
.B \-dumpmpsub
Convert the given subtitle (specified with the -sub switch) to MPlayer's
subtitle format, MPsub. Dumps a dump.mpsub file to current directory.
.TP
.B \-screenw\ pixels
If you use an output driver which can't know the resolution of the screen
(mga/fbdev/x11 and/or TVout) this is where you can specify the horizontal
resolution.
.TP
.B \-screenh\ pixels
If you use an output driver which can't know the resolution of the screen
(mga/fbdev/x11 and/or TVout) this is where you can specify the vertical
resolution.
.TP
.B \-cache\ kbytes
See it below, in the ALPHA/BETA CODE section.
.IP
.SH "ALPHA/BETA CODE"
.TP
.I NOTE
These are included in this manpage just for completeness! These may or may NOT
work! If you don't know what are these, you DON'T need these! In either case,
double-check the documentation !
.TP
.B \-br\ rate
used with '-vo odivx' .
Specifies the bitrate to encode OpenDivx at
(in bits! e.g: 780000).
.TP
.I NOTE
You CAN'T encode sound, only video right now! Don't ask for it,
it's on the TODO list.
.TP
.B \-encode\ file
used with '-vo odivx' .
Specifies the output OpenDivX file. Won't overwrite.
.TP
.B \-dumpvideo
dump video stream to ./stream.dump (only with MPEG-PS) (not very usable)
.TP
.B \-sid
specify DVD subtitle (?) (IT _WILL NOT_ DISPLAY! RTFM!)
.TP
.B \-cache\ kbytes
_If you compiled with cache support_ , use this option to enable using it.
Also specify the amount of memory to use, in kbytes.
.IP
.SH KEYBOARD CONTROL
.TP
.I NOTE
These keys may/may not work, depending on your video output driver.
.TP
	  <-  or  ->      seek backward/forward  10 seconds

up or down      seek backward/forward   1 minute

pgup/pgdown     seek backward/forward  10 minutes

p or SPACE      pause movie (press any key)

q or ESC        stop playing and quit program

+ or -          adjust audio delay by +/- 0.1 second

/ or *          decrease/increase volume

o               toggle OSD: none / seek / seek+timer

m               toggle using master/pcm volume

z or x          adjust subtitle delay by +/- 0.1 second

(the following keys are valid only when using DirectShow DivX codec)

1 or 2          adjust contrast

3 or 4          adjust brightness

5 or 6          adjust hue

7 or 8          adjust saturation

.IP
.SH FILES AND DIRECTORIES
.TP
.I CONFIG FILES
Settings are stored system-wide in the /etc/mplayer.conf file,
and per-user in $HOME/.mplayer/config. The directory
$HOME/.mplayer and the 'config' are created if doesn't exist.
.TP
.I FONTS
Fonts are searched in $HOME/.mplayer/font. There must be a font.desc
file, and files with .RAW extension.
.TP
.I SUBTITLE FILES
MPlayer currently supports 9 subtitle formats : MicroDVD, SubRip, unnamed,
SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), AQT, and our own: MPsub.
Sub files are searched in this priority : (for example /mnt/cdrom/movie.avi)
    /mnt/cdrom/movie.sub
     (utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA)
    $HOME/.mplayer/sub/movie.sub
     (utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA)
    $HOME/.mplayer/default.sub
.IP
.SH "EXAMPLES"
.B Quickstart DVD playing
mplayer -dvd 1
.TP
.B Multiangle DVD playing
mplayer -dvd 1 -dvdangle 2
.TP
.B Playing from a different DVD device
mplayer -dvd 1 /dev/dvd2
.TP
.B Stream from HTTP
mplayer http://mplayer.hq/example.avi
.TP
.B Convert subtitle to MPsub (to ./dump.mpsub)
mplayer dummy.avi -sub source.sub -dumpmpsub
.LP
.SH BUGS
Probably. Check the documentation.

Bugreports should be addressed to the MPlayer-users mailing list
(mplayer-users@mplayerhq.hu) ! If you want to submit a bugreport
(which we love to receive!), please double-check the bugreports.html, and
tell us all that we need to know to identify your problem.

.LP
.SH AUTHORS
Check documentation !

MPlayer is (C) 2000-2001
.I Arpad Gereoffy <arpi@thot.banki.hu>

This manpage is written and maintained by
.I Gabucino .
.LP
.SH STANDARD DISCLAIMER
Use only at your own risk! There may be errors and inaccuracies that could 
be damaging to your system or your eye. Proceed with caution, and although
this is highly unlikely, the author doesn't take any responsibility for that!
.\" end of file