Mercurial > mplayer.hg
annotate DOCS/mplayer.1 @ 5683:588237bcd14c
applied goth (Jonas Jermann)'s patch
author | gabucino |
---|---|
date | Thu, 18 Apr 2002 16:45:25 +0000 |
parents | 501ebd981377 |
children | 8031d86f1839 |
rev | line source |
---|---|
5683 | 1 |
1 | 2 .\" This manpage was/is done by Gabucino |
5683 | 3 .\" |
4 .TH "MPlayer" "1" "2002-04-13" | |
5 | |
6 .SH "NAME" | |
1 | 7 mplayer \- Movie Player for Linux |
5683 | 8 |
9 .SH "SYNOPSIS" | |
10 .B mplayer | |
11 .RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \fIplaylist\fP\ |\ \-\ |\ ...] | |
12 .br | |
13 .B mplayer | |
14 .RB [global\ options]\ \fIfile1\fP\ [specific\ options]\ [file2]\ [specific\ options]\ ... | |
15 .br | |
16 .B mplayer | |
17 .RB [global\ options]\ {\fIgroup\ of\ files\ and\ options\fP}\ [group\ specific\ options]\ ... | |
18 .br | |
1 | 19 .B mplayer |
5683 | 20 .RB [dvd|vcd|tv]://[id|options] |
21 | |
22 .SH "DESCRIPTION" | |
23 .B mplayer | |
24 is a movie player for LINUX (runs on many other Unices, and non\-x86 | |
25 CPUs, see section 6). It plays most MPEG, VOB, AVI, VIVO, ASF/WMV, QT/MOV, FLI, | |
26 RM, NuppelVideo, yuv4mpeg, FILM, RoQ files, supported by many native, XAnim, and | |
27 Win32 DLL codecs. You can watch VideoCD, SVCD, DVD, 3ivx, and even DivX movies too | |
28 (and you don't need the avifile library at all!). | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
29 |
5683 | 30 Another big feature of mplayer is the wide range of supported output drivers. |
31 It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, DirectFB, but you can use | |
32 GGI and SDL (and this way all their drivers) and some lowlevel card-specific drivers | |
33 (for Matrox, 3Dfx and Radeon) too! | |
34 .br | |
35 Most of them supports software or hardware scaling, so you can enjoy movies in fullscreen. | |
36 MPlayer supports displaying through some hardware MPEG decoder boards, such as the DVB and | |
37 DXR3/Hollywood+! | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
38 |
5683 | 39 Nice big antialiased shaded subtitles with european/ISO 8859-1,2 (hungarian, english, czech, |
40 etc), cyrillic, korean fonts are supported (10 supported subtitle formats: MicroDVD, SubRip, | |
41 SubViewer, SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), AQT, VobSub, and our | |
42 own: MPsub). | |
43 | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
44 .SH "GUI OPTIONS" |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
45 .I NOTE: |
5683 | 46 The GUI code has to be compiled in *explicitly* (see documentation). |
47 .TP | |
2099 | 48 .B \-gui |
5683 | 49 Start MPlayer in GUI mode. |
50 .TP | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
51 .B \-skin <skin\ directory> |
5683 | 52 Load skin from this directory (WITHOUT path name!). For example '\-skin fittyfene' tries these: |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
53 |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
54 /usr/local/share/mplayer/Skin/fittyfene |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
55 ~/.mplayer/Skin/fittyfene |
5683 | 56 |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
57 .SH "DVD OPTIONS" |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
58 .I NOTE: |
5683 | 59 These options are valid only with DVD support compiled in (see documentation). |
60 .br | |
4531
1736cd920aa4
applied pl's patch (sorry, overlooked it previously.. and procmailrc
gabucino
parents:
4502
diff
changeset
|
61 .I NOTE: |
5683 | 62 DVD playback sometimes requires deinterlacing: see '\-pp 0x20000' or '\-npp lb' options. |
63 .TP | |
64 .B \-alang\ <audio\ stream\ language> | |
65 Used when playing DVD disks. Expects a two\-letter country code(s) as | |
66 parameter, and always tries to play back audio streams those language | |
67 matches the given code. For example: \-alang hu,en will always try to play | |
68 hungarian or if it's non\-existant then english audio streams if there are any. | |
69 .TP | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
70 .B \-chapter\ <chapter\ id> |
5683 | 71 Specify which chapter to start playing at. Optionally specify which chapter to |
4398 | 72 end playing at. Examples can be found below. |
5683 | 73 .TP |
74 .B \-csslib <filename> | |
75 (old-style DVD option) This option is used to override the default location of libcss.so | |
76 .TP | |
77 .B \-dvd\ <title\ id> | |
78 Tell MPlayer which movies (marked with titleid) to play. For example | |
79 sometimes '1' are trailers, and '2' is the real movie. | |
80 .TP | |
81 .B \-dvd\-device\ <path\ to\ device> | |
82 Override default DVD device name /dev/dvd | |
83 .TP | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
84 .B \-dvdangle\ <angle\ id> |
5683 | 85 Some DVD discs contain scenes that can be viewed from multiple angles. |
2099 | 86 Here you can tell MPlayer which angles to use. Examples can be found below. |
5683 | 87 .TP |
88 .B \-dvdauth <DVD\ device> | |
89 (old-style DVD option) Turns on DVD authentication using the given device. | |
90 .TP | |
91 .B \-dvdkey <CSS\ key> | |
92 (old-style DVD option) When decoding from non-DVD, this option gives the CSS key needed | |
93 to crack the DVD (the key is printed when authenticating with DVD). | |
94 .TP | |
95 .B \-dvdnav | |
96 Force usage of libdvdnav. | |
97 .TP | |
4069 | 98 .B \-sid\ <id> |
99 Turns on DVD subtitle displaying. Also, you MUST specify a number which | |
5683 | 100 corresponds to a DVD subtitle language (0\-31). For the list of available |
101 subtitles, use with the \-v switch and look at the output. | |
102 .br | |
103 .I NOTE: | |
104 Use \-slang to define the subtitle language by name. | |
105 .TP | |
106 .B \-skipopening | |
107 Skip dvd opening (dvdnav only). | |
108 .TP | |
109 .B \-slang\ <subtitle\ language> | |
110 See the \-sid option, but this one needs a two\-letter parameter, a country code. | |
111 Like: \-slang hu,en will always select hungarian or if it's non existant then | |
112 english subtitles, if there are any. For the list of available subtitles, use | |
113 with the \-v switch and look at the output. | |
114 | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
115 .SH "GENERAL OPTIONS" |
5683 | 116 .I NOTE: |
117 Every "flag" option has "noflag" pair, e.g. \-fs opposite is \-nofs | |
118 .TP | |
119 .B \-ao\ <driver>[:<device>] | |
120 Select audio output driver and optinaly device. "device" is valid with | |
121 SDL too, it means sub\-driver then (for example: \-vo sdl:esd). | |
122 If using OSS, you can specify which sound device to use like this: | |
1 | 123 |
5683 | 124 \-ao oss:/dev/dsp1 (replaces the old \-dsp option) |
1 | 125 |
5683 | 126 You can get the list of available drivers executing |
127 .I mplayer \-ao help | |
128 .TP | |
129 .B \-aspect <ratio> | |
130 Set aspect ratio of movies. It's autodetected on MPEG files, and can't be | |
131 autodetected on AVI files. Examples: | |
1208 | 132 |
5683 | 133 \-aspect 4:3 or \-aspect 1.3333 |
134 \-aspect 16:9 or \-aspect 1.7777 | |
135 .TP | |
136 .B \-audiofile\ <filename> | |
137 Play audio from an external file (MP3, AC3, Vorbis, etc) | |
138 .TP | |
139 .B \-autoq\ <quality> | |
140 Dynamically changes the level of postprocess, depending on spare CPU time | |
141 available. The number you specify will be the maximum level used. Usually you | |
142 can use some big number. You may not use together with \-pp but it's ok with | |
143 \-npp! | |
144 .TP | |
145 .B \-benchmark | |
146 Used in combination with \-nosound and \-vo null for benchmarking. | |
147 .TP | |
148 .B \-cdrom\-device\ <path\ to\ device> | |
149 Override default CDROM drive name /dev/cdrom | |
150 .TP | |
151 .B \-conf\ <path\ to\ input.conf\ file> | |
152 Get input bindings from an alternative input.conf file (default: | |
153 ~/.mplayer/input.conf). | |
154 .TP | |
155 .B \-dr | |
156 Turns on direct rendering (not supported by all codecs and video outputs) | |
157 (default is off). | |
158 .TP | |
159 .B \-ffactor\ <number> | |
160 Resample alphamap of the font. Can be: | |
986 | 161 |
5683 | 162 0 plain white fonts |
163 0.75 very narrow black outline [default] | |
164 1 narrow black outline | |
165 10 bold black outline | |
166 .TP | |
167 .B \-font\ <path\ to\ font.desc\ file> | |
168 Search for the OSD/SUB fonts in an alternative directory (default: | |
169 ~/.mplayer/font/font.desc). For example: | |
170 | |
171 \-font ~/.mplayer/arial\-14/font.desc | |
172 .TP | |
1 | 173 .B \-fs |
5683 | 174 Fullscreen playing (centers movie, and makes black |
5020 | 175 bands around it). Toggle it with the 'f' key (not all video |
176 outputs support it). | |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
177 .TP |
5683 | 178 .B \-h, --help |
179 Show short summary of options | |
180 .TP | |
181 .B \-ifo <vobsub\ ifo\ file> | |
182 Indicate the file that will be used to load palette and frame size for VOBSUB | |
183 subtitles. | |
184 .TP | |
185 .B \-lircconf\ <config\ file> | |
186 Specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc | |
187 .TP | |
188 .B \-loop\ <num> | |
189 Loops movie playback <num> times. 0 means forever. | |
1 | 190 .TP |
5683 | 191 .B \-mf\ <multifile\ options> |
192 Used when decoding from multiple JPEG files. The sub\-options are separated by ":" | |
193 (see documentation). They are: | |
194 | |
195 on turns on multifile support | |
196 w=<value> width of the output | |
197 h=<value> height of the output | |
198 fps=<value> fps of the output | |
199 type=<value> type of input files (available types : jpeg, png) | |
200 .TP | |
201 .B \-mixer\ <device> | |
202 This option will tell MPlayer to use a different device for mixing than | |
203 /dev/mixer. | |
204 .TP | |
205 .B \-monitoraspect <ratio> | |
206 Set aspect ratio of your screen. Examples: | |
207 | |
208 \-monitoraspect 4:3 or 1.3333 | |
209 \-monitoraspect 16:9 or 1.7777 | |
210 .TP | |
211 .B \-noautosub | |
212 Turns off automatic subtitles | |
213 .TP | |
214 .B \-nosound | |
215 Don't play sound | |
216 .TP | |
217 .B \-osdlevel\ <level> | |
218 Specifies which mode the OSD should start in (0: none, 1: seek, 2: seek+timer) | |
219 (default = 2) | |
220 .TP | |
221 .B \-playlist <file> | |
222 Play files according to this filelist (1 file/row or Winamp or ASX format). | |
223 .TP | |
224 .B \-quiet | |
225 Display less output, status messages. | |
226 .TP | |
227 .B \-rootwin | |
228 Play movie in the root window (desktop background) instead of opening | |
229 a new one. Works only with the xv and xmga drivers. | |
230 .TP | |
231 .B \-ss\ <time> (see \-sb option too!) | |
232 Seek to given time position. For example: | |
3721 | 233 |
5683 | 234 \-ss 56 seeks to 56 seconds |
235 \-ss 01:10:00 seeks to 1 hour 10 min | |
236 .TP | |
237 .B \-sub\ <subtitle\ file> | |
238 Use/display this subtitle file | |
239 .TP | |
240 .B \-subdelay\ <sec> | |
241 Delays subtitles by <sec> seconds. Can be negative. | |
242 .TP | |
243 .B \-subfps\ <rate> | |
244 Specify frame/sec rate of subtitle file (float number) | |
245 (ONLY for frame\-based SUB files, i.e. NOT MicroDVD format!) | |
246 (default: the same fps as the movie) | |
247 .TP | |
248 .B \-subpos <0 \- 100> | |
249 Specify the position of subtitles | |
250 .TP | |
251 .B \-sws\ <software\ scaler\ type> | |
252 This option sets the quality (and speed, respectively) of the software scaler, | |
253 with the \-zoom option. For example with x11 or other outputs which lack | |
254 hardware acceleration. Possible settings are: | |
1 | 255 |
5683 | 256 0 \- fast bilinear (default) |
257 1 \- bilinear | |
258 2 \- bicubic (best quality) | |
259 3 \- ? | |
260 4 \- nearest neighbor (bad quality) | |
261 5 \- area averageing scaling support | |
262 .TP | |
263 .B \-tv\ <sub\-options> | |
264 This option enables the TV grabbing feature of MPlayer. The sub\-options are separated | |
265 by ":" (see documentation). They are: | |
266 | |
267 on use TV input | |
268 noaudio no sound | |
269 driver=<value> available: dummy, v4l | |
270 device=<value> specify other device than the default /dev/video0 | |
271 input=<value> available: television, s-video, composite, etc | |
272 freq=<value> specify the frequency to set the tuner (e.g. 511.250) | |
273 outfmt=<value> output format of the tuner (rgb32, rgb24, yv12, uyvy, i420) | |
274 width=<value> the width of the output window | |
275 height=<value> the height of the output window | |
276 norm=<value> available: PAL, SECAM, NTSC | |
277 channel=<value> set the tuner to the given channel | |
278 chanlist=<value> available: us-bcast, us-cable, europe-west, europe-east, etc | |
279 .TP | |
280 .B \-v | |
281 Enable verbose output (more \-v means more verbosity) | |
282 .TP | |
283 .B \-vcd\ <track> | |
284 Play video cd track from device instead of plain file | |
285 .TP | |
286 .B \-vm | |
287 Try to change to a different video mode. dga2, x11 (XF86VidMode) and sdl | |
288 output drivers support it. | |
289 .TP | |
290 .B \-vo\ <driver>[:<device>] | |
291 Select video output driver and optinally device. "device" is valid with | |
292 SDL and GGI too, it means sub\-driver then (for example: \-vo sdl:aalib). | |
293 | |
294 You can get the list of available drivers executing | |
295 .I mplayer \-vo help | |
1035 | 296 .TP |
4086 | 297 .B \-vobsub\ <vobsub\ file\ without\ extention> |
5683 | 298 Specify the VobSub files that are to be used for subtitle. This is |
4086 | 299 the full pathname without extensions, i.e. without the ".idx", ".ifo" |
300 or ".sub". | |
5683 | 301 .TP |
4086 | 302 .B \-vobsubid\ <vobsub\ subtitle\ id> |
5683 | 303 Specify the VobSub subtitle id. Valid values range from 0 to 31. |
304 | |
305 .SH "ADVANCED OPTIONS" | |
306 .I NOTE: | |
307 These options can help you solve your particular problem (see documentation too!). | |
1208 | 308 .TP |
5683 | 309 .B \-aa* |
310 Used for \-vo aa. You can get a list and an explanation of available options executing | |
311 .I mplayer \-aahelp | |
312 .TP | |
313 .B \-abs\ <bytes> | |
314 Sound card audio buffer size (in bytes, default: measuring) | |
315 .TP | |
316 .B \-ac <name> | |
317 Force usage of a specific audio codec, according to its name in codecs.conf, | |
318 for example: | |
319 | |
320 \-ac mp3 use libmp3 MP3 codec | |
321 \-ac mp3acm use l3codeca.acm MP3 codec | |
322 \-ac ac3 use AC3 codec | |
323 \-ac hwac3 enable Hardware AC3 passthrough (see documentation) | |
324 \-ac vorbis use libvorbis | |
325 \-ac ffmp3 use ffmpeg's MP3 decoder (SLOW) | |
2084 | 326 |
5683 | 327 See '\-ac help' for FULL list! |
328 .TP | |
329 .B \-aid\ <id> | |
330 Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...] | |
331 .br | |
332 .I NOTE: | |
333 Use \-alang to define the language by name. | |
334 .TP | |
335 .B \-aofile <filename> | |
336 Filename for \-ao pcm. | |
2110 | 337 .TP |
5683 | 338 .B \-aop\ <sub\-options> |
339 Specify audio plugin(s) and their options (see documentation!!). | |
340 .TP | |
341 .B \-audio\-demuxer <number> | |
342 Force audio demuxer type for \-audiofile. Give the demuxer ID as defined in | |
343 demuxers.h. | |
2664 | 344 .TP |
5683 | 345 .B \-blue_intensity <\-1000\ \-\ 1000> |
346 Adjust intensity of blue component of video signal (default 0). | |
347 .TP | |
348 .B \-bpp\ <depth> | |
349 Use different color depth than autodetect. Not all \-vo drivers support | |
350 it (fbdev, dga2, svga, vesa). | |
3322
cdd3f5ac06b2
-slave patch by Kilian A. Foth <foth@informatik.uni-hamburg.de>
arpi
parents:
3239
diff
changeset
|
351 .TP |
5683 | 352 .B \-brightness <\-1000\ \-\ 1000> |
353 Adjust brightness of video output (default 0). It changes intensity of | |
354 RGB components of video signal from black to white screen. | |
355 .TP | |
356 .B \-cache\ <kbytes> | |
357 This option specifies how much memory to use when precaching a file/URL. | |
358 Especially useful on slow media (default is \-nocache). | |
359 .TP | |
360 .B \-channels <n> | |
361 Select number of audio output channels to be used | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
362 |
5683 | 363 Stereo 2 |
364 Surround 4 | |
365 Full 5.1 6 | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
366 |
5683 | 367 Currently this option is only honoured for AC3 audio. |
368 .TP | |
369 .B \-config <config\ file> | |
370 Specifies where to search for config file | |
3566 | 371 .TP |
5683 | 372 .B \-contrast <\-1000\ \-\ 1000> |
373 Adjust contrast of video output (default 0). Works in similar manner as brightness. | |
374 .TP | |
375 .B \-delay\ <secs> | |
376 Audio delay in seconds (may be +/\- float value) | |
377 .TP | |
378 .B \-demuxer <number> | |
379 Force demuxer type. Give the demuxer ID as defined in demuxers.h. | |
380 .TP | |
381 .B \-display <name> | |
382 Specify the hostname and display number of the X server you want | |
383 to display on. For example: \-display xtest.localdomain:0 | |
384 .TP | |
385 .B \-dumpaudio | |
386 Writes audio stream of the file to ./stream.dump (mostly usable | |
387 with mpeg/ac3) | |
3774 | 388 .TP |
5683 | 389 .B \-dumpfile <filename> |
390 Specify to which file MPlayer should dump to. Should be used together | |
391 with \-dumpaudio/\-dumpvideo. | |
392 .TP | |
393 .B \-dumpmpsub | |
394 Convert the given subtitle (specified with the \-sub switch) to MPlayer's | |
395 subtitle format, MPsub. Creates a dump.mpsub file in current directory. | |
396 .TP | |
397 .B \-dumpstream | |
398 Dumps the file to ./stream.dump . Useful for example | |
399 when ripping from DVD. | |
400 .TP | |
401 .B \-fb\ <device> (FBdev or DirectFB only) | |
402 Specifies the framebuffer device to use. By default it uses /dev/fb0. | |
403 .TP | |
404 .B \-fbmode\ <modename> (FBdev only) | |
405 Change videomode to the one that is labelled as <modename> in /etc/fb.modes. | |
406 .br | |
407 .I NOTE: | |
408 VESA framebuffer doesn't support mode changing. | |
409 .TP | |
410 .B \-fbmodeconfig\ <filename> (FBdev only) | |
411 Use this config file instead of the default /etc/fb.modes. | |
412 Only valid for the fbdev driver. | |
413 .TP | |
414 .B \-forceidx | |
415 Force rebuilding of INDEX. Useful for files with broken index (desyncs, etc). | |
416 Seeking will be possible. You can fix the index permanently with | |
417 MEncoder (see the documentation). | |
418 .TP | |
419 .B \-forcexv (SDL only) | |
420 Force using XVideo | |
421 .TP | |
422 .B \-fps\ <value> | |
423 Force frame rate (if value is wrong in the header) (float number) | |
424 .TP | |
425 .B \-framedrop (see \-hardframedrop option too!) | |
426 Frame dropping: decode all frames, video may skip | |
427 .TP | |
428 .B \-frames\ <number> | |
429 MPlayer plays <number> frames, then quits. | |
430 .TP | |
431 .B \-fsmode\ <mode> | |
432 This option workarounds some problems when using specific windowmanagers and | |
433 fullscreen mode. If you experience fullscreen problems, try changing this | |
434 value between 0 and 7. | |
1363 | 435 |
5683 | 436 \-fsmode 0 new method |
437 \-fsmode 1 ICCCWM patch | |
438 (for KDE2/icewm) | |
439 \-fsmode 2 old method | |
440 \-fsmode 3 ICCCWM patch | |
441 plus Motif method | |
442 .TP | |
443 .B \-green_intensity <\-1000\ \-\ 1000> | |
444 Adjust intensity of green component of video signal (default 0). | |
445 .TP | |
446 .B \-hardframedrop | |
447 More intense frame dropping (breaks decoding). Leads to image disortion! | |
448 .TP | |
449 .B \-hr\-mp3\-seek | |
450 Hi\-res mp3 seeking. Default is: enabled when playing from external MP3 file, as | |
451 we need to seek to the very exact position to keep A/V sync. It can be slow | |
452 especially when seeking backwards \- it has to rewind to the beginning to find | |
453 the exact frame. | |
1363 | 454 .TP |
5683 | 455 .B \-hue <\-1000\ \-\ 1000> |
456 Adjust hue of video signal (default 0). You can get colored negative | |
457 of image with this option. | |
458 .TP | |
459 .B \-idx (see \-forceidx option too!) | |
460 Rebuilds INDEX of the AVI, thus allowing seeking. Useful with broken/incomplete | |
461 downloads, or badly created AVIs. | |
462 .TP | |
463 .B \-include <configfile> | |
464 Specify config file to be parsed after the default | |
465 .TP | |
466 .B \-input <commands> | |
467 This option can be used to configure certain parts of the input system. | |
468 conf=<file> read alternative input.conf. | |
469 If given without pathname, | |
470 $HOME/.mplayer is assumed. | |
471 ar\-delay delay in msec before we start | |
472 to autorepeat a key | |
473 (0 to disable) | |
474 ar\-rate how many keypress/second when | |
475 we autorepeat | |
476 keylist prints all keys that can be | |
477 bound to | |
478 cmdlist prints all commands that can | |
479 be bound | |
1988 | 480 |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
481 .I NOTE: |
5683 | 482 Autorepeat is currently only supported by joysticks. |
483 .TP | |
484 .B \-mc\ <seconds/5frame> | |
485 Maximum sync correction per 5 frames (in seconds) | |
486 .TP | |
487 .B \-monitor_dotclock <dotclock\ (or\ pixelclock) range> (FBdev only) | |
488 Look into etc/example.conf for further information and in DOCS/video.html. | |
489 .TP | |
490 .B \-monitor_hfreq <horizontal frequency range> (FBdev only) | |
491 .TP | |
492 .B \-monitor_vfreq <vertical frequency range> (FBdev only) | |
493 .TP | |
494 .B \-ni | |
495 Force usage of non\-interleaved AVI parser (fixes playing | |
496 of some bad AVI files). | |
497 .TP | |
498 .B \-nobps | |
499 Don't use avg. byte/sec value for A\-V sync (AVI). | |
500 .TP | |
501 .B \-double | |
502 enables doublebuffering. Fixes flicker by storing two frames in memory, and | |
503 displaying one while decoding another. Can effect OSD. Needs twice the memory | |
504 than a single buffer, so it won't work on cards with very few video memory. | |
505 .TP | |
506 .B \-nodshow | |
507 Disables usage of DirectShow video codecs | |
508 .TP | |
509 .B \-noframedrop | |
510 No frame dropping: every frame is played, audio and video may be out of | |
511 sync (default) | |
512 .TP | |
513 .B \-noidx | |
514 Disregards INDEX of the AVI. Useful for files with broken index (desyncs, etc). | |
515 Seeking will NOT be possible. You can fix the index permanently | |
516 with MEncoder (see documentation). | |
517 .TP | |
518 .B \-nojoystick | |
519 Turns off joystick support. Default is on, if compiled in. | |
520 .TP | |
521 .B \-nolirc | |
522 Turns off lirc support. | |
1363 | 523 .TP |
5683 | 524 .B \-nortc |
525 Turns off rtc | |
526 .TP | |
527 .B \-noslices | |
528 Disable the use of draw_slice by codecs. | |
1 | 529 .TP |
5683 | 530 .B \-nowaveheader |
531 Don't include wave header. Used for RAW PCM. | |
532 .TP | |
533 .B \-noxv (SDL only) | |
534 Disable XVideo hardware acceleration | |
535 .TP | |
536 .B \-npp\ <options> | |
537 This option allows to give more litterate options for postprocessing, | |
538 and is another way of calling it (not with \-pp). | |
3809 | 539 |
4531
1736cd920aa4
applied pl's patch (sorry, overlooked it previously.. and procmailrc
gabucino
parents:
4502
diff
changeset
|
540 .I EXAMPLE: |
5683 | 541 '\-pp 0x2007f' <=> '\-npp hb,vb,dr,al,lb' |
542 '\-pp 0x7f' <=> '\-npp hb,vb,dr,al' | |
543 | |
544 The options for \-npp are a coma separated list you can get by executing | |
545 .I mplayer \-npp help | |
546 .br | |
547 These keywords accept a '\-' prefix to disable the option. | |
3809 | 548 |
549 .I EXAMPLE: | |
5683 | 550 '\-npp de,\-al' means 'default filters without brightness/contrast correction' |
3809 | 551 |
5683 | 552 A ':' followed by a letter may be appended to the option to indicate its |
4531
1736cd920aa4
applied pl's patch (sorry, overlooked it previously.. and procmailrc
gabucino
parents:
4502
diff
changeset
|
553 scope: |
3809 | 554 a : automatically switches the filter off if the cpu is too slow |
555 c : do chrominance filtering too | |
556 y : do not do chrominance filtering (that is only luminance filtering) | |
557 | |
558 Each filter defaults to 'c' (chrominance). | |
559 | |
560 .I EXAMPLE: | |
5683 | 561 '\-npp de,tn:1:2:3' means 'enable default filters & temporal denoiser' |
562 '\-npp hb:y,vb:a \-autoq 6' means 'deblock horizontal only luminance, and | |
3809 | 563 automatically switch vertical deblocking on/off depending on available |
564 cpu time' | |
5683 | 565 .TP |
566 .B \-pp\ <quality> (see \-npp option too!) | |
567 Apply postprocess filter on decoded image | |
568 | |
569 Postprocessing effect depends on the codec and works only for MPEG1/2, | |
570 libavcodec codecs (ff*). It doesn't work for Win32/XAnim codecs. | |
571 | |
572 This is the numerical mode to use postprocessing. The '\-npp' option described | |
573 below has the same effects but with letters. To have several filters at the | |
574 same time, simply add the hexadecimal values. | |
575 | |
576 .I EXAMPLE: | |
577 The following values are known to give good results: | |
578 \-pp 0x20000 <=> \-npp lb (deinterlacing \- for DVD/MPEG2 playback e.g.) | |
579 \-pp 0x7f <=> \-npp hb,vb,dr,al (smooth the images) | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
580 .TP |
5683 | 581 .B \-red_intensity <\-1000\ \-\ 1000> |
582 Adjust intensity of red component of video signal (default 0). | |
583 .TP | |
584 .B \-saturation <\-1000\ \-\ 1000> | |
585 Adjust saturation of video output (default 0). You can get grayscale output | |
586 with this option. | |
587 .TP | |
588 .B \-sb\ <byte\ position> (see \-ss option too!) | |
589 Seek to byte position | |
590 .TP | |
591 .B \-screenh\ <pixels> | |
592 If you use an output driver which can't know the resolution of the screen | |
593 (fbdev/x11 and/or TVout) this is where you can specify the vertical | |
594 resolution. | |
595 .TP | |
596 .B \-screenw\ <pixels> | |
597 If you use an output driver which can't know the resolution of the screen | |
598 (fbdev/x11 and/or TVout) this is where you can specify the horizontal | |
599 resolution. | |
600 .TP | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
601 .B \-slave |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
602 This option switches on slave mode. This is intended for use |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
603 of MPlayer as a backend to other programs. Instead of intercepting keyboard |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
604 events, MPlayer will read simplistic command lines from its stdin. |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
605 See section |
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
606 .B SLAVE MODE PROTOCOL |
5683 | 607 For the syntax. |
608 .TP | |
609 .B \-softsleep | |
610 Uses high quality software timers. Efficient as the RTC, doesn't need root, | |
611 but requires more CPU. | |
612 .TP | |
613 .B \-srate <Hz> | |
614 Specifies Hz to playback audio on. Has effect on playback speed! | |
615 .TP | |
616 .B \-stereo <mode> | |
617 Select type of MP2/MP3 stereo output. | |
868 | 618 |
619 Stereo 0 | |
620 Left channel 1 | |
621 Right channel 2 | |
5683 | 622 .TP |
2207 | 623 .B \-subcp\ codepage |
624 If your system supports iconv(3), you can use this option to | |
625 specify codepage of the subtitle. Examples: | |
626 | |
5683 | 627 \-subcp latin2 |
628 \-subcp cp1250 | |
629 .TP | |
630 .B \-unicode | |
631 Tells MPlayer to handle the subtitle file as UNICODE. | |
632 .TP | |
633 .B \-utf8 | |
634 Tells MPlayer to handle the subtitle file as UTF8. | |
635 .TP | |
636 .B \-vc <name> | |
637 Force usage of a specific video codec, according to its name in codecs.conf, | |
638 for example: | |
2207 | 639 |
5683 | 640 \-vc divx use VFW DivX codec |
641 \-vc divxds use DirectShow DivX codec | |
642 \-vc ffdivx use libavcodec's DivX codec | |
643 \-vc ffmpeg12 use libavcodec's MPEG1/2 codec | |
644 \-vc divx4 use ProjectMayo's DivX codec | |
645 | |
646 See '\-vc help' for FULL list! | |
647 .TP | |
648 .B \-vid\ <id> | |
649 Select video channel [MPG: 0\-15 AVI: \-\- ] | |
5231 | 650 .TP |
5683 | 651 .B \-vsync |
652 Enables VBI for vesa | |
653 .TP | |
654 .B \-wid\ <window\ id> | |
655 This tells MPlayer to use a X11 window, which is useful to embed MPlayer in a | |
656 browser (with the plugger extension for instance) | |
657 .TP | |
658 .B \-xineramascreen <screen\ number> | |
659 In Xinerama configurations (i.e. a single desktop that spans across multiple | |
660 displays) this option tells MPlayer which screen to display movie on. Range 0 \- ... | |
661 .TP | |
662 .B \-z\ <0\-9> | |
663 Specifies compression level for PNG output | |
664 0 : no compression | |
665 9 : max compression | |
5231 | 666 .TP |
5683 | 667 .B \-zr* |
668 Used for \-vo zr. You can get a list and an explanation of available options executing | |
669 .I mplayer \-zrhelp | |
670 | |
1 | 671 .SH "ALPHA/BETA CODE" |
5683 | 672 .I NOTE: |
2251 | 673 These are included in this manpage just for completeness! These may or may NOT |
674 work! If you don't know what are these, you DON'T need these! In either case, | |
5683 | 675 double\-check the documentation! |
676 .TP | |
677 .B \-dapsync | |
678 Use alternative A/V sync method. | |
679 .TP | |
793 | 680 .B \-dumpvideo |
5683 | 681 Dump video stream to ./stream.dump (only with MPEG\-PS) (not very usable) |
682 .TP | |
683 .B \-ssf <mode> | |
684 .TP | |
685 .B \-sub\-demuxer <number> | |
686 Force subtitle demuxer type for \-subfile. | |
687 .TP | |
5231 | 688 .B \-subfile <filename> |
5683 | 689 Currently unuseful. Same as \-audiofile, but for subtitle streams. (OggDS?) |
690 .TP | |
691 .B \-vivo <sub\-options> | |
692 .TP | |
693 .B \-vop <filter> | |
694 Activate video filters (see documentation!!). | |
695 | |
696 .SH "OBSOLETE OPTIONS" | |
697 .I NOTE: | |
698 These options are obsoleted and may be removed in future. | |
699 .TP | |
700 .B \-afm <1\-12> | |
701 Force usage of a specific audio format. For example: | |
702 | |
703 \-afm 1 use libmp3 (mp2/mp3, but not mp1) | |
704 \-afm 2 suppose raw PCM audio | |
705 \-afm 3 use libac3 | |
706 \-afm 4 use a matching Win32 codec | |
707 \-afm 5 use aLaw/uLaw driver | |
708 \-afm 10 use libvorbis | |
709 \-afm 11 use ffmpeg's MP3 decoder (even mp1) | |
222 | 710 |
5683 | 711 See \-ac help for FULL list! |
712 .TP | |
713 .B \-flip | |
714 Flip image (useful for example for old Indeo codecs). Supported only(?) | |
715 by the 'sdl' and 'x11' outputs. | |
716 .TP | |
717 .B \-master | |
718 Use Software audio mixer plugin instead (see documentation). | |
719 .TP | |
720 .B \-vfm <1\-12> | |
721 Force usage of a specific codec FAMILY, and FALLBACK to default if failed. | |
722 For example: | |
1578 | 723 |
5683 | 724 \-vfm 2 use VFW (Win32) codecs |
725 \-vfm 3 use OpenDivX/DivX4 codec (YV12) | |
726 (same as \-vc odivx but fallback) | |
727 \-vfm 4 use DirectShow (Win32) codecs | |
728 \-vfm 5 use libavcodec codecs | |
729 \-vfm 7 use DivX4 codec (YUY2) | |
730 (same as \-vc divx4 but fallback) | |
731 \-vfm 10 use XAnim codecs | |
732 | |
733 See \-vc help for FULL list! | |
222 | 734 |
5683 | 735 .I NOTE: |
736 If libdivxdecore support was compiled in, then type 3 and 7 now contains | |
737 just the same DivX4 codec, but different APIs to reach it. For difference | |
738 between them and when to use which, check the DivX4 section in the | |
739 documentation. | |
740 .TP | |
741 .B \-x\ <x> | |
742 Scale image to x width (if driver suppports) | |
743 .TP | |
744 .B \-xy\ <factor> | |
745 Scale image by <factor> | |
746 .TP | |
747 .B \-y\ <y> | |
748 Scale image to y height (if driver supports) | |
749 .TP | |
750 .B \-zoom | |
751 Use software scaling, where available (use with \-nofs). svga, x11, vesa | |
752 output drivers support it. | |
389 | 753 |
5683 | 754 .SH "KEYBOARD CONTROL" |
755 .I NOTE: | |
756 Use the new input system to change the default keys (edit input.conf). | |
757 There is support for Joystick and LIRC too (see documentation). | |
758 .br | |
759 .I NOTE: | |
760 These keys may/may not work, depending on your video output driver. | |
761 .TP | |
762 .B general control | |
763 <\- and \-> seek backward/forward 10 seconds | |
764 .br | |
765 up and down seek backward/forward 1 minute | |
766 .br | |
767 pgup and pgdown seek backward/forward 10 minutes | |
768 .br | |
769 < and > previous/next file | |
770 .br | |
771 p / SPACE pause movie (press any key) | |
772 .br | |
773 q / ESC stop playing and quit program | |
774 .br | |
775 + and \- adjust audio delay by +/\- 0.1 second | |
776 .br | |
777 / and * decrease/increase volume | |
778 .br | |
5020 | 779 f toggle fullscreen |
5683 | 780 .br |
523 | 781 o toggle OSD: none / seek / seek+timer |
5683 | 782 .br |
783 d toggle frame dropping | |
784 .br | |
785 z and x adjust subtitle delay by +/\- 0.1 second | |
786 .br | |
787 r and t adjust subtitle position | |
474 | 788 |
5683 | 789 (The following keys are valid only when using \-vo xv or \-vo [vesa|fbdev]:vidix |
790 or \-vo xvidix or \-vc divxds (slow).) | |
1556 | 791 |
5683 | 792 1 and 2 adjust contrast |
793 .br | |
794 3 and 4 adjust brightness | |
795 .br | |
796 5 and 6 adjust hue | |
797 .br | |
798 7 and 8 adjust saturation | |
799 .TP | |
800 .B GUI keyboard control | |
801 gray \- and + decrease/increase volume | |
802 .br | |
803 ENTER start playing | |
804 .br | |
805 s stop playing | |
806 .br | |
807 a about | |
808 .br | |
809 l load file | |
810 .br | |
811 b skin browser | |
812 .br | |
813 e toggle equalizer | |
814 .br | |
815 p toggle playlist | |
3322
cdd3f5ac06b2
-slave patch by Kilian A. Foth <foth@informatik.uni-hamburg.de>
arpi
parents:
3239
diff
changeset
|
816 .TP |
5683 | 817 .B TV input control |
818 h and l select previous/next channel | |
819 .br | |
820 n change norm | |
821 .br | |
822 b change channel list | |
823 .TP | |
824 .B DVDNAV input control | |
825 K,J,H,L browse up/down/left/right | |
826 .br | |
827 M jump to main menu | |
828 .br | |
829 S select | |
3322
cdd3f5ac06b2
-slave patch by Kilian A. Foth <foth@informatik.uni-hamburg.de>
arpi
parents:
3239
diff
changeset
|
830 |
5683 | 831 .SH "SLAVE MODE PROTOCOL" |
832 If the \-slave switch is given, playback is controlled by a | |
833 line\-based protocol with the following tokens: | |
834 .TP | |
835 stop pause playback | |
836 .br | |
837 play resume playback | |
838 .br | |
839 seek <num> continue at second NUM | |
840 .br | |
841 skip <num> skip NUM seconds (may be negative) | |
842 .br | |
3793
8db5331d97a4
applied many interesting things from pl's patch, by hand
gabucino
parents:
3774
diff
changeset
|
843 quit exit MPlayer |
3322
cdd3f5ac06b2
-slave patch by Kilian A. Foth <foth@informatik.uni-hamburg.de>
arpi
parents:
3239
diff
changeset
|
844 |
5683 | 845 .SH "FILES" |
846 .BR /etc/mplayer.conf\ \ \ \ \ | |
847 System\-wide settings | |
848 .br | |
849 .BR ~/.mplayer/config\ \ \ \ \ | |
850 User settings | |
851 .br | |
852 .BR ~/.mplayer/input.conf\ | |
853 Input bindings | |
854 .br | |
855 .BR ~/.mplayer/font/\ \ \ \ \ \ | |
856 Font directory. There must be a font.desc file and files with .RAW extension. | |
857 .br | |
858 | |
859 .I Subtitles | |
860 (utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA) | |
861 .br | |
862 Sub files are searched in this priority (for example /mnt/movie/movie.avi): | |
863 .br | |
899 | 864 /mnt/cdrom/movie.sub |
5683 | 865 .br |
866 ~/.mplayer/sub/movie.sub | |
867 .br | |
868 ~/.mplayer/default.sub | |
869 | |
1 | 870 .SH "EXAMPLES" |
1714 | 871 .B Quickstart DVD playing |
5683 | 872 mplayer \-dvd 1 |
873 .TP | |
4398 | 874 .B Play only chapters 5, 6, 7 |
5683 | 875 mplayer \-dvd 1 \-chapter 5\-7 |
876 .TP | |
1714 | 877 .B Multiangle DVD playing |
5683 | 878 mplayer \-dvd 1 \-dvdangle 2 |
879 .TP | |
1714 | 880 .B Playing from a different DVD device |
5683 | 881 mplayer \-dvd 1 \-dvd\-device /dev/dvd2 |
882 .TP | |
1714 | 883 .B Stream from HTTP |
884 mplayer http://mplayer.hq/example.avi | |
5683 | 885 .TP |
2207 | 886 .B Convert subtitle to MPsub (to ./dump.mpsub) |
5683 | 887 mplayer dummy.avi \-sub source.sub \-dumpmpsub |
888 .TP | |
889 .B Input from standard V4L | |
890 mplayer \-tv on:driver=v4l:width=640:height=480:outfmt=i420 \-vc rawi420 \-vo xv | |
1 | 891 |
5683 | 892 .SH "BUGS" |
893 Probably. PLEASE, double-check the documentation (especially bugreports.html), | |
894 the FAQ and the mail archive before ! | |
1 | 895 |
5683 | 896 Send your complete bugreports to the MPlayer-users mailing list at |
897 <mplayer-users@mplayerhq.hu>. We love complete bugreports :) | |
1 | 898 |
5683 | 899 .SH "AUTHORS" |
900 Check documentation! | |
901 | |
902 MPlayer is (C) 2000\-2002 | |
903 .I Arpad Gereoffy <sendmail@to.mplayer\-users> | |
1 | 904 |
2251 | 905 This manpage is written and maintained by |
5683 | 906 .I Gabucino <sendmail@to.mplayer\-users>. |
907 | |
908 .SH "STANDARD DISCLAIMER" | |
2848
33c32f3d9f1f
many small updates, fixes (some/more to be completed soon)
gabucino
parents:
2664
diff
changeset
|
909 Use only at your own risk! There may be errors and inaccuracies that could |
1 | 910 be damaging to your system or your eye. Proceed with caution, and although |
911 this is highly unlikely, the author doesn't take any responsibility for that! | |
912 .\" end of file |