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