Mercurial > mplayer.hg
annotate DOCS/mplayer.1 @ 1036:537875fdcf16
*** empty log message ***
author | gabucino |
---|---|
date | Tue, 05 Jun 2001 16:15:39 +0000 |
parents | 197fd410d982 |
children | 2767682b85de |
rev | line source |
---|---|
1 | 1 .\" MPlayer (C) 2000-2001 Arpad Gereoffy <arpi@esp-team.scene.hu> |
2 .\" This manpage was/is done by Gabucino | |
3 .\" | |
733 | 4 .TH MPlayer-CVS |
1 | 5 .SH NAME |
6 mplayer \- Movie Player for Linux | |
7 .SH SYNOPSIS | |
8 .B mplayer | |
9 .RB [ \-vo\ output\ driver ] | |
986 | 10 .RB [ \-ao\ output\ driver ] |
1 | 11 .RB [ \-vcd\ track\ number ] |
12 .RB [ \-sb\ byte\ position ] | |
13 .RB [ \-nosound\ ] | |
14 .RB [ \-abs\ seconds ] | |
15 .RB [ \-delay\ secs ] | |
16 .RB [ \-bps\ value ] | |
17 .RB [ \-aid\ id ] | |
18 .RB [ \-vid\ id ] | |
19 .RB [ \-fps\ rate ] | |
20 .RB [ \-mc\ seconds/5f ] | |
21 .RB [ \-afm\ audio\ decoder ] | |
22 .RB [ \-fs\ ] | |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
23 .RB [ \-vm\ ] |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
24 .RB [ \-zoom\ ] |
1 | 25 .RB [ \-x\ x ] |
26 .RB [ \-y\ y ] | |
27 .RB [ \-xy\ factor ] | |
28 .RB [ \-dsp\ device ] | |
45 | 29 .RB [ \-pp\ quality ] |
164
2790235db59f
even more updates :) about time to crack a joke, eh? :))
gabucino
parents:
106
diff
changeset
|
30 .RB [ \-include\ configfile ] |
222 | 31 .RB [ \-ffactor\ number ] |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
32 .RB [ \-sub\ file ] |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
33 .RB [ \-subfps\ rate ] |
484 | 34 .RB [ \-subdelay\ sec ] |
1022 | 35 .RB [ \-dvdauth\ device ] |
532
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
36 .RB [ \-z\ <0-8> ] |
574 | 37 .RB [ \-idx ] |
38 .RB [ \-forceidx ] | |
646 | 39 .RB [ \-nodshow ] |
40 .RB [ \-sdl\ driver ] | |
986 | 41 .RB [ \-sdla\ driver ] |
646 | 42 .RB [ \-noxv ] |
43 .RB [ \-forcexv ] | |
656 | 44 .RB [ \-ss\ sec ] |
791 | 45 .RB [ \-dumpaudio ] |
793 | 46 .RB [ \-dumpvideo ] |
47 .RB [ \-dumpsub ] | |
801 | 48 .RB [ \-noframedrop ] |
49 .RB [ \-framedrop ] | |
50 .RB [ \-hardframedrop ] | |
822 | 51 .RB [ \-dvdkey\ key ] |
868 | 52 .RB [ \-stereo\ mode ] |
986 | 53 .RB [ \-srate\ Hz ] |
1035 | 54 .RB [ \-osdlevel\ level ] |
1036 | 55 .RB [ \-config\ file ] |
693 | 56 .I - or file |
1 | 57 .PP |
58 .SH DESCRIPTION | |
59 .I mplayer | |
60 Yes. Yet another movie player for linux. | |
61 What is the special with this? It works, at least for me :) | |
62 I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN, | |
63 xine,xanim,avifile,xmmp) but they all have some problem. Mostly with | |
64 special files or with audio/video sync. Most of them is unable to play | |
65 both mpeg1, mpeg2 and avi (DivX) files. Many players have image quality | |
66 or speed problems too. So I've decided to write/modify one... | |
67 .LP | |
68 .SH "GENERAL OPTIONS" | |
69 .TP | |
70 .I NOTE | |
71 MPlayer works out-of-the-box, so you generally don't have to mess with | |
72 any options. | |
73 .TP | |
790 | 74 .I NOTE |
75 Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs | |
76 .TP | |
986 | 77 .B \-vo\ video\ output\ driver |
78 select video output driver | |
1 | 79 |
80 you can get the list of available drivers executing | |
81 .I mplayer -vo help | |
82 | |
83 .TP | |
986 | 84 .B \-ao\ audio\ output\ driver |
85 select audio output driver | |
86 | |
87 you can get the list of available drivers executing | |
88 .I mplayer -ao help | |
89 | |
90 .TP | |
523 | 91 .B \-vcd\ track |
1 | 92 play video cd track from device instead of plain file |
93 .TP | |
1022 | 94 .B \-dvdauth\ device |
523 | 95 specify DVD-ROM drive to use for MPEG2 decoding. |
96 (use *_only_* when playing from DVD!) | |
97 .TP | |
98 .B \-nosound | |
1 | 99 don't play sound |
100 .TP | |
101 .B \-fs | |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
102 fullscreen playing (centers movie, and makes black |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
103 bands around it) |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
104 .TP |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
105 .B \-vm |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
106 use XF86VidMode extension for mode changing |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
107 .TP |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
108 .B \-zoom |
1035 | 109 use software scaling, where available (use with -nofs) |
1 | 110 .TP |
111 .B \-x\ x | |
112 scale image to x width [if driver suppports!] | |
113 .TP | |
114 .B \-y\ y | |
115 scale image to y height | |
116 .TP | |
117 .B \-xy\ factor | |
118 scale image by <factor> | |
119 .TP | |
120 .B \-dsp\ device | |
121 select another DSP output device | |
122 .TP | |
45 | 123 .B \-pp\ quality |
1 | 124 apply postprocess filter on decoded image. |
125 You need a STRONG CPU in order to use this! | |
126 The supported formats and settings are: | |
127 | |
181 | 128 MPEG 1/2 0 (none), 1, 3, 7, 15, 31, 63 |
129 OpenDivX 0 (none), 1, 3, 7, 15, 31, 63 | |
130 DivX 0 (none), 1, 2, 3, 4 | |
1 | 131 |
132 .I NOTE | |
52 | 133 Maybe less/more. |
134 | |
135 .I NOTE | |
1 | 136 You can use this with OpenDivX encoding too! See ALPHA/BETA CODE section. |
137 .TP | |
222 | 138 .B \-ffactor\ number |
139 resample alphamap of the font. Can be: | |
1 | 140 |
222 | 141 0 plain white fonts |
142 0.75 very narrow black outline [default] | |
143 1 narrow black outline | |
144 10 bold black outline | |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
145 .TP |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
146 .B \-sub\ file |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
147 use/display this subtitle file |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
148 .TP |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
149 .B \-subfps\ rate |
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
150 specify frame/sec rate of subtitle file |
521 | 151 (ONLY for frame-based SUB files, i.e. NOT MicroDVD format!) |
472
a25ba0fd865e
commiting yesterday's changes that accidently lost ;(((
gabucino
parents:
454
diff
changeset
|
152 (default: the same as the movie) |
484 | 153 .TP |
154 .B \-subdelay\ sec | |
155 delays subtitles by <sec> seconds. Can be negative. | |
1035 | 156 .TP |
157 .B \-osdlevel\ level | |
158 specifies which mode the OSD should start in (none,seek,seek+timer) | |
1 | 159 .IP |
160 .SH "ADVANCED OPTIONS" | |
161 .TP | |
162 .I NOTE | |
163 These options can help you solve your particular problem.. Also, see the DOCS! | |
164 .TP | |
165 .B \-afm <1-5> | |
166 force audio format 1:MPEG 2:PCM 3:AC3 4:Win32 5:aLaw | |
167 | |
168 .I NOTE | |
169 With DivX AVIs with MP3 audio, you can choose whether to use MP3LIB (option 1), | |
170 or Win32 DLL l3codeca.acm (option 4) (default). On CPUs with the 3DNow! | |
171 instruction set, the first gives more performance. Your mileage may vary. | |
172 .TP | |
523 | 173 .B \-sb\ position |
1 | 174 seek to byte position |
656 | 175 .B \-ss\ second |
176 seek to second position | |
1 | 177 .TP |
523 | 178 .B \-abs\ bytes |
1 | 179 audio buffer size (in bytes, default: measuring) |
180 .TP | |
181 .B \-delay\ secs | |
182 audio delay in seconds (may be +/- float value) | |
183 .TP | |
184 .B \-bps | |
185 use avg. byte/sec value for A-V sync (AVI) | |
186 .TP | |
187 .B \-aid\ id | |
188 select audio channel [MPG: 0-31 AVI: 1-99] | |
189 .TP | |
190 .B \-vid\ id | |
191 select video channel [MPG: 0-15 AVI: -- ] | |
192 .TP | |
193 .B \-fps\ value | |
194 force frame rate (if value is wrong in the header) | |
195 .TP | |
196 .B \-mc\ seconds/5frame | |
197 maximum sync correction per 5 frames (in seconds) | |
198 .TP | |
199 .B \-ni | |
200 force usage of non-interleaved AVI parser | |
164
2790235db59f
even more updates :) about time to crack a joke, eh? :))
gabucino
parents:
106
diff
changeset
|
201 .TP |
2790235db59f
even more updates :) about time to crack a joke, eh? :))
gabucino
parents:
106
diff
changeset
|
202 .B \-include |
2790235db59f
even more updates :) about time to crack a joke, eh? :))
gabucino
parents:
106
diff
changeset
|
203 specify config file to be parsed after the default |
532
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
204 .TP |
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
205 .B \-z\ <0-8> |
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
206 specifies compression level for PNG output |
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
207 0 : no compression |
a8ab5e0f5560
do you think the stars see how hard we're fighting for them?
gabucino
parents:
523
diff
changeset
|
208 8 : max compression |
574 | 209 .TP |
210 .B \-idx | |
211 rebuilds INDEX of the AVI. Useful with broken downloads, or badly | |
212 created AVIs. | |
213 .TP | |
214 .B \-forceidx | |
215 force rebuilding of INDEX. Useful for testing, or AVIs with bad | |
216 indexes. | |
629 | 217 .TP |
218 .B \-nodshow | |
630 | 219 disables usage of DirectShow video codecs |
646 | 220 .TP |
221 .B \-sdl\ driver | |
986 | 222 specify SDL video driver to use. For example: aalib, dga, fbdev, svga, x11, ggi |
223 .TP | |
224 .B \-sdla\ driver | |
225 specify SDL audio driver to use. For example: esd | |
646 | 226 .TP |
227 .B \-noxv | |
228 disable XVideo hardware acceleration (with SDL only!) | |
229 .TP | |
230 .B \-forcexv | |
231 force using XVideo (SDL!) | |
791 | 232 .TP |
233 .B \-dumpaudio | |
793 | 234 writes audio stream of the file to ./stream.dump (mostly usable |
235 with mpeg/ac3) | |
801 | 236 .TP |
237 .B \-noframedrop | |
238 no frame dropping : every frame is played, audio may skip (default) | |
239 .TP | |
240 .B \-framedrop | |
241 frame dropping : decode all frames, video may skip | |
242 .TP | |
243 .B \-hardframe | |
244 hard frame dropping : skip even decoding (when using with DivX also | |
802 | 245 specify -nodshow !!!) |
822 | 246 .TP |
247 .B \-dvdkey key | |
248 key to decrypt stream encrypted with CSS. For example : -dvdkey F169072699 | |
1022 | 249 (this is NOT for DVD playing! For DVD use the -dvdauth option!) |
868 | 250 .TP |
251 .B \-stereo mode | |
252 select type of MPEG1 stereo output. Mode may be 0:stereo 1:left 2:right | |
253 | |
254 Stereo 0 | |
255 Left channel 1 | |
256 Right channel 2 | |
257 | |
986 | 258 .TP |
259 .B \-srate Hz | |
260 specifies Hz to playback audio on. Has effect on playback speed! | |
1036 | 261 .TP |
262 .B \-config configfile | |
263 specifies where to search for config file | |
1 | 264 .IP |
265 .SH "ALPHA/BETA CODE" | |
266 .TP | |
267 .I NOTE | |
268 These are included in this manpage just for completeness! If you don't | |
269 know what are these, you DON'T need these! In either case, double-check DOCS! | |
270 .TP | |
271 .B \-br\ rate | |
272 used with '-vo odivx' . | |
273 Specifies the bitrate to encode OpenDivx at | |
274 (in bits! e.g: 780000). | |
275 .TP | |
276 .B \-encode\ file | |
277 used with '-vo odivx' . | |
278 Specifies the output OpenDivX file. Won't overwrite. | |
793 | 279 .TP |
280 .B \-dumpvideo | |
281 dump video stream to ./stream.dump (only with MPEG-PS) (not very usable) | |
282 .TP | |
283 .B \-dumpsub | |
801 | 284 dumps subtitles from VOB to file (not very usable) |
1 | 285 .IP |
222 | 286 .SH KEYBOARD CONTROL |
287 .TP | |
288 .I NOTE | |
289 These keys may/may not work, depending on your video output driver. | |
290 .TP | |
291 <- or -> seek backward/forward 10 seconds | |
292 | |
293 up or down seek backward/forward 1 minute | |
294 | |
295 p or SPACE pause movie (press any key) | |
296 | |
297 q or ESC stop playing and quit program | |
298 | |
962 | 299 + or - adjust audio delay by +/- 0.1 second |
389 | 300 |
454 | 301 / or * decrease/increase volume |
302 | |
523 | 303 o toggle OSD: none / seek / seek+timer |
474 | 304 |
484 | 305 m toggle using master/pcm volume |
801 | 306 |
802 | 307 d toggle frame dropping: no / on / hard |
948 | 308 |
309 z or x adjust subtitle delay by +/- 0.1 second | |
222 | 310 .IP |
311 .SH FILES AND DIRECTORIES | |
312 .TP | |
313 .I CONFIG FILES | |
314 Settings are stored system-wide in the /etc/mplayer.conf file, | |
315 and per-user in $HOME/.mplayer/config. The directory | |
316 $HOME/.mplayer and the 'config' are created if doesn't exist. | |
317 .TP | |
318 .I FONTS | |
319 Fonts are searched in $HOME/.mplayer/font. There must be a font.desc | |
320 file, and files with .RAW extension. | |
321 .TP | |
224 | 322 .I SUBTITLE FILES |
899 | 323 MPlayer currently supports 6 subtitle formats : MicroDVD, SubRip, unnamed, |
943 | 324 SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha). |
899 | 325 Sub files are searched in this priority : (for example /mnt/cdrom/movie.avi) |
326 /mnt/cdrom/movie.sub | |
327 (SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT) | |
328 $HOME/.mplayer/sub/movie.sub | |
329 (SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT) | |
330 $HOME/.mplayer/default.sub | |
222 | 331 .IP |
1 | 332 .SH "EXAMPLES" |
333 Just launch it! :) | |
334 .LP | |
335 .SH BUGS | |
96 | 336 Probably. Check DOCS. |
1 | 337 |
338 Bugreports should be addressed to the MPlayer-users mailing list | |
40 | 339 (mplayer-users@lists.sourceforge.net) ! If you want to submit a bugreport |
899 | 340 (which we love to receive!), please double-check the DOCS/BUGREPORTS, and |
1 | 341 tell us all that we need to know to identify your problem. |
342 | |
343 .LP | |
344 .SH AUTHORS | |
345 Check DOCS/AUTHORS ! | |
346 | |
347 MPlayer is (C) 2000-2001 | |
348 .I Arpad Gereoffy <arpi@thot.banki.hu> | |
349 | |
350 This manpage is maintained by | |
351 .I Gabucino. | |
352 .LP | |
353 .SH STANDARD DISCLAIMER | |
354 Use only at your own risk! There may be errors and inaccuracies that could | |
355 be damaging to your system or your eye. Proceed with caution, and although | |
356 this is highly unlikely, the author doesn't take any responsibility for that! | |
357 .\" end of file |