diff options
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/bugreports.html | 141 | ||||
-rw-r--r-- | DOCS/codecs.html | 219 | ||||
-rw-r--r-- | DOCS/documentation.html | 731 | ||||
-rw-r--r-- | DOCS/dvd.html | 207 | ||||
-rw-r--r-- | DOCS/faq.html | 322 | ||||
-rw-r--r-- | DOCS/sound.html | 84 | ||||
-rw-r--r-- | DOCS/video.html | 677 |
7 files changed, 2381 insertions, 0 deletions
diff --git a/DOCS/bugreports.html b/DOCS/bugreports.html new file mode 100644 index 0000000000..5c4f47a387 --- /dev/null +++ b/DOCS/bugreports.html @@ -0,0 +1,141 @@ +<HTML> + +<BODY> + +<PRE> + + <A NAME=C>Appendix C - How to report bugs + +How to report bugs? +~~~~~~~~~~~~~~~~~~~ +First read DOCS/BUGS, and other docs. If your problem isn't +known or isn't solved by our instructions, then report the bug: + +Where? +====== +Subscribe to the mplayer-users mailing list: + http://lists.sourceforge.net/lists/listinfo/mplayer-users +and send your bugreport to: + mplayer-users@lists.sourceforge.net +We won't CC: so please subscribe!!! + +Don't send bugreports private, directly to author's address!!! +We are working together on code, so everyone is interested in it. +BTW many times other users know the solution (system config probs, +bad drivers etc), even when we think it's a bug in our code. +The language of this list is ENGLISH ! + +Please describe your problem in details, examples etc, and don't +forget to include these: + +What? +===== + +1. The system info what we always want: +- linux distribution + examples: + RedHat 7.1 + Slackware 7.0 + devel packs from 7.1 ... +- kernel version: + uname -a +- libc version: + ls -l /lib/libc[.-]* +- X version: + X -version +- gcc and ld version: + gcc -v + ld -v +- binutils version: + as --version + +2. Hardware & drivers: +- CPU info: + cat /proc/cpuinfo +- video card manufacturer and model + examples: + ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM + Matrox G400 DH 32MB SGRAM +- video driver type&version + examples: + X built-in driver + nvidia 0.9.623 + Utah-GLX CVS 2001-02-17 + DRI from X 4.0.3 +- sound card type & driver + examples: + Creative SBLive! Gold with OSS driver from oss.creative.com + Creative SB16 with OSS drivers of kernel + GUS PnP with ALSA OSS emulation +- if you are unsure, attach output of lspci -v + +For compiling problems/errors: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +3. output of configure/make: + make distclean + ./configure &>config.log + ./make &>make.log +4. these files: + config.h + config.mak + libvo/config.mak + +For playback problems: +~~~~~~~~~~~~~~~~~~~~~~ +3. Output of mplayer at verbose level 1 (-v) + mplayer -v [options] filename &> mplayer.log + +4. If the problem is specific to one or a few files, + then please upload that file to: + ftp://mplayerhq.hu/MPlayer/incoming/ + Usually first 1-5 MB of the file is enough to reproduce + the problem, but first you should try it: + dd if=yourfile of=smallfile bs=1k count=1024 + (it will cut first 1MB of 'yourfile' and save to 'smallfile') + Then try again on this small file, and if bug still exists + then it's enough to upload this small file. + NEVER send such files via mail! Upload it, and send only + the path/filename of the file on the FTP. + If the file is accessible on the net, then sending the + _exact_ URL is enough! + +5. For crashes (segfault, SIGILL, signal 4 etc): + +If you have coredump of the crash, see 5.a, else see 5.b: + +5.a: Please print us coredump (if it was created). +Howto: +please create following command file: + +disass $eip-32 $eip+32 +printf "eax=%08lX\n",$eax +printf "ebx=%08lX\n",$ebx +printf "ecx=%08lX\n",$ecx +printf "edx=%08lX\n",$edx +printf "esp=%08lX\n",$esp +printf "ebp=%08lX\n",$ebp +printf "edi=%08lX\n",$edi +printf "esi=%08lX\n",$esi + +Then simply execute following command line: +gdb mplayer --core=core -batch --command=command_file >mplayer.bug + +5.b.: run <B>MPlayer</B> in gdb: +[at root/user shell prompt:] + # gdb mplayer +[at gdb prompt:] + > run -v [options-to-mplayer] filename + ... (wait until it will crash) + > bt + > disass $eip-32 $eip+32 +Send us the full output of the above things! + +In general: +~~~~~~~~~~~ + If something is big (logs etc) then it's better to upload to the ftp + (gzipped), and include only path/filename in the bugreport! + +</PRE> + +</BODY> + +</HTML> diff --git a/DOCS/codecs.html b/DOCS/codecs.html new file mode 100644 index 0000000000..a72517f3cb --- /dev/null +++ b/DOCS/codecs.html @@ -0,0 +1,219 @@ +<HTML> + +<BODY> + +<PRE> + + <A NAME=2.1>2.1. Video Formats, Audio & Video Codecs + + + <A NAME=2.1.1>2.1.1. Supported input formats + + <B>MPlayer</B> can read/play from the following devices/formats: + - VCD (Video CD) directly from CD-ROM or from CDRwin's .bin image file + - DVD, directly from your DVD disk, using optional libcss for decryption + - MPEG 1/2 System Stream (PS/PES/VOB) and Elementary Stream (ES) file + formats + - RIFF AVI file format + - ASF 1.0 file format + - supports reading from file, stdin, DVD drive or network via HTTP + + Note: about quicktime (.mov/.qt) and realmedia (.ra/.rm) support read the FAQ! + + + <A NAME=2.1.2>2.1.2. Supported audio & video codecs + + See http://mplayer.sourceforge.net/DOCS/codecs.html for the complete, + daily updated list!!! + + The most important video codecs: + - MPEG1 (VCD) and MPEG2 (DVD) video + - DivX, FFmpeg, OpenDivX and other MPEG4 variants + - Windows Media Video 7 (WMV1) and Windows Media Video 8 used in .wmv files + - Intel Indeo codecs (3.1,3.2,4.1,5.0) + - MJPEG, ASV2 and other hardware formats + + The most important audio codecs: + - MPEG layer 2, and layer 3 (MP3) audio (native code, with 3dnow optimization) + - AC3 dolby audio (native code, with 3dnow optimization) + - Voxware audio + - alaw, msgsm, pcm and other simple old audio formats + + If you have a codec not listed here, and not supported yet, just + read http://mplayer.sourceforge.net/DOCS/codecs.html + to get info about its status and about how to help us adding support for it! + + + <A NAME=2.1.2.1>2.1.2.1. OpenDivX + + This section contains information about the DivX/OpenDivX codecs of + <A HREF="http://www.projectmayo.com">ProjectMayo</A>. Their first available alpha version was the OpenDivX 4.0 + alpha 47 and 48. Support for this was/is included in <B>MPlayer</B>, and built by + default. We even used its postprocessing code to optionally enhance visual + quality of MPEG1/2 movies. + + The new generation of this codec can even decode movies made with the + infamous DivX codec! And it's not everything, it's MUCH faster than the + traditional Win32 DivX DLL's. See below for configuration. The only + disadvantage of this codec is that it's currently closed-source. :( + + The codec can be downloaded from the following URL: + + + http://download2.projectmayo.com/dnload/divx4linux/divx4linux-20010718.zip + + + No automatic installing available at this time, so install it manually, + EXACTLY as described here. Unpack it, and copy files to their place: + + + cp libdivxdecore.so.0.0.0 /usr/local/lib/ + ln -s /usr/local/lib/libdivxdecore.so.0.0.0 /usr/local/lib/libdivxdecore.so.0 + ln -s /usr/local/lib/libdivxdecore.so.0 /usr/local/lib/libdivxdecore.so + ldconfig + cp decore.h /usr/local/include/ + + + <B>MPlayer</B> autodetects if OpenDivX is (properly) installed, just compile + as usual. If it doesn't detect it, you didn't install it exactly as above, + and/or has fucked up config (see last question of 6.1 section). + + Using it is a bit tricky. As it conflicts with the old OpenDivX (it's API is + very similar to OpenDivX's), OpenDivX code is disabled, and the OpenDivX + driver calls this library too. + + Generally we can pinpoint this issue to that you have two options to use + this codec: + + + -vc odivx : using divx4 codec as a new version of OpenDivX. + in this case it produces YV12 image in its own buffer, + and <B>MPlayer</B> (libvo) does colorspace conversion. + + -vc divx4 : using divx4 codec's colorspace conversion. + in this mode, you can use YUY2/UYVY too. + + The 'odivx' method is usually faster, due to the fact that it transfers + image data in YV12 (planar YUV 4:2:0) format, thus requiring much less + bandwidth on the bus. For packed YUV modes (YUY2, UYVY) use the 'divx4' + method. For RGB modes you can choose freely, their speed is same, maybe + differ according to the current bpp. + + Note: it supports postprocessing too, but range of values is strange: + + 0 no postproc + 10 .. 20 postprocessing, normal + (like level 2 with divxds) + 30 .. 60 hard postprocessing, eats many CPU. + (like level 4 with divxds) + + + <A NAME=2.1.2.2>2.1.2.2. ffmpeg's DivX/libavcodec + + Beginning with version 0.4.2 , <A HREF="http://ffmpeg.sourceforge.net">ffmpeg</A> contains an <B>opensource</B> DivX codec, + which is compatible with the traditional DivX. <B>MPlayer</B> contains this codec, + and this makes it possible to <B>watch DivX movies on non-x86 platforms!</B> + To get it compile, you'll need nasm, bison, and flex, above the other + devel tools. It was removed from <B>MPlayer</B>'s cvs tree, you have + to download it manually directly from <B>FFmpeg</B>'s tree : + + + cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg login + cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg co ffmpeg + + + Note: if you copy with CVS subdirs, next time it's enough to do + 'cvs update'. + + Now, move the newly downloaded ffmpeg source's <B>libavcodec</B> directory, + (with all it's subdirectories) to <B>MPlayer</B>'s tree, so it will look + like this : + + + main/libavcodec + + + Symlinking is NOT enough, you have to copy it. + + ./configure detects if it can be built. At the moment it doesn't support + postprocessing, and is under optimization (it's faster than the DS/VfW DivX + codec). + + In order to use it, refresh your codecs.conf file, and do as the manpage, + or the example.conf says (the -vfm option). + + Note: libavcodec contains other codecs as well, but at the moment we mostly + focus on ffdivx, and it's unlikely that this will change. + + <A NAME=2.1.4>2.1.4. Codec importing howto + + + <A NAME=2.1.4.1>2.1.4.1. VFW codecs + + VfW (Video for Windows) is the old Video API for Windows. Its codecs have + the .DLL or (rarely) .DRV extension. + If <B>MPlayer</B> fails with your AVI: + + + UNKNOWN video codec: HFYU (0x55594648) + + + It means your AVI is encoded with a codec which has the HFYU fourcc (HFYU = + HuffYUV codec, DIV3 = DivX Low Motion, etc...). Now that we know this, we'll + have to find out which DLL Windows loads in order to play this file. In our + case, the system.ini contains this (with many others): + + + VIDC.HFYU=huffyuv.dll + + + So we'll need the huffyuv.dll file. Note that the audio codecs are specified + with the MSACM prefix : + + + msacm.l3acm=L3codeca.acm + + + This is the MP3 codec. + So, now we have all the info needed (fourcc, codec file, sample AVI), submit + your codec support request in mail, and upload these files to the FTP: + ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/ + + + <A NAME=2.1.4.2>2.1.4.2. DirectShow codecs + + DirectShow is the newer Video API, which is even worse than its predecessor. + Things are harder with DirectShow, since + - system.ini doesn't contain the needed information, instead it's stored in + the registry :( + - we'll need the GUID of the codec. + + So let's search that goddamn registry.. + - Start 'regedit' + - press ctrl-f, disable the first two checkbox, and enable the third. Type + the fourcc of the codec. (for ex.: TM20) + - you should see a field which contains the path and filename + (for ex. : C:\WINDOWS\SYSTEM\TM20DEC.AX) + - now that we have the file, we'll need the GUID. Try searching again, but + now we'll search for the codec's name, not the fourcc. Its name can be acquired + when Media Player is playing that file, by checking File/Properties/Advanced. + If not, bad luck ;) Try guessing. + (for ex. search for : TrueMotion) + - if found (in registry), there should be a FriendlyName field, and a CLSID + field. Write down that 16 byte of CLSID, this is the GUID required by us. + + + NOTE : if searching fails, try to enable all the checkboxes.. you may have + false hits, but maybe you'll have the right, too... + NOTE : dump that M$ shit. + + + So, now we have all the info needed (fourcc, GUID, codec file, sample AVI), + submit your codec support request in mail, and upload these files to the FTP: + ftp://mplayerhq.hu/MPlayer/incoming/[codecname]/ + +</PRE> + +</BODY> + +</HTML> diff --git a/DOCS/documentation.html b/DOCS/documentation.html new file mode 100644 index 0000000000..98d3ccd9b7 --- /dev/null +++ b/DOCS/documentation.html @@ -0,0 +1,731 @@ +<HTML> + +<BODY> + +<P> +<CENTER>MPlayer - Movie Player for LINUX (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team)<BR> +<BR> +<A HREF="http://www.mplayerhq.hu">http://www.mplayerhq.hu</A></CENTER><BR> +</P> + +<P><HR></P> + +<P> +Table of Contents +</P> + +<P><HR></P> + +<PRE> +<P> + <A HREF="#1">1. Introduction</A> +</P> +<P> + <A HREF="#1.1">1.1 Overview</A> + <A HREF="#1.2">1.2 History</A> + <A HREF="#1.3">1.3 Installation</A> + <A HREF="#1.4">1.4 What about the GUI?</A> +</P> +<P> + <A HREF="#2">2. Features</A> +</P> +<P> + <A HREF="codecs.html">2.1 Video Formats, Audio & Video Codecs</A> + <A HREF="codecs.html#2.1.1">2.1.1 Supported input formats</A> + <A HREF="codecs.html#2.1.2">2.1.2 Supported audio & video codecs</A> + <A HREF="codecs.html#2.1.2.1">2.1.2.1 OpenDivX</A> + <A HREF="codecs.html#2.1.2.2">2.1.2.2 ffmpeg's DivX/libavcodec</A> + <A HREF="codecs.html#2.1.4">2.1.4 Codec importing howto</A> + <A HREF="codecs.html#2.1.4.1">2.1.4.1 VFW codecs</A> + <A HREF="codecs.html#2.1.4.2">2.1.4.2 DirectShow codecs</A> +</P> +<P> + <A HREF="video.html">2.2 Video & Audio output devices</A> + <A HREF="video.html#2.2.1">2.2.1 Video output devices</A> + <A HREF="video.html#2.2.1.1">2.2.1.1 MTRR</A> + <A HREF="video.html#2.2.1.2">2.2.1.2 Xv</A> + <A HREF="video.html#2.2.1.2.1">2.2.1.2.1 3dfx cards</A> + <A HREF="video.html#2.2.1.2.2">2.2.1.2.2 S3 cards</A> + <A HREF="video.html#2.2.1.2.3">2.2.1.2.3 nVidia cards</A> + <A HREF="video.html#2.2.1.2.4">2.2.1.2.4 ATI cards</A> + <A HREF="video.html#2.2.1.3">2.2.3.2 DGA</A> + <A HREF="video.html#2.2.1.3.1">2.2.1.3.1 Summary</A> + <A HREF="video.html#2.2.1.3.2">2.2.1.3.2 What is DGA</A> + <A HREF="video.html#2.2.1.3.3">2.2.1.3.3 Installing DGA support for MPlayer</A> + <A HREF="video.html#2.2.1.3.4">2.2.1.3.4 Resolution switching</A> + <A HREF="video.html#2.2.1.3.5">2.2.1.3.5 DGA & MPlayer</A> + <A HREF="video.html#2.2.1.3.6">2.2.1.3.6 Features of the DGA driver</A> + <A HREF="video.html#2.2.1.3.7">2.2.1.3.7 Speed issues</A> + <A HREF="video.html#2.2.1.3.8">2.2.1.3.8 Known bugs</A> + <A HREF="video.html#2.2.1.3.9">2.2.1.3.9 Future work</A> + <A HREF="video.html#2.2.1.3.A">2.2.1.3.A Some modelines</A> + <A HREF="video.html#2.2.1.3.B">2.2.1.3.B Bug Reports</A> + <A HREF="video.html#2.2.1.4">2.2.1.4 SDL</A> + <A HREF="video.html#2.2.1.5">2.2.1.5 SVGAlib</A> + <A HREF="video.html#2.2.1.6">2.2.1.6 Framebuffer output (FBdev)</A> + <A HREF="video.html#2.2.1.7">2.2.1.7 Matrox framebuffer (mga_vid)</A> + <A HREF="video.html#2.2.1.8">2.2.1.8 SiS 6326 framebuffer (sis_vid)</A> + <A HREF="video.html#2.2.1.9">2.2.1.9 3dfx YUV support</A> + <A HREF="video.html#2.2.1.10">2.2.1.10 OpenGL output</A> + <A HREF="video.html#2.2.1.11">2.2.1.11 AAlib - text mode displaying</A> + <A HREF="video.html#2.2.1.A">2.2.1.A TVout</A> + <A HREF="video.html#2.2.1.A.1">2.2.1.A.1 Matrox cards</A> + <A HREF="sound.html#2.2.2">2.2.2 Audio output devices</A> + <A HREF="sound.html#2.2.2.1">2.2.2.1 Soundcard experiences, recommendations</A> +</P> +<P> + <A HREF="#3">3. Usage</A> +</P> +<P> + <A HREF="#3.1">3.1 Control from keyboard</A> + <A HREF="#3.2">3.2 Control from LIRC (Linux Infrared Remote Control)</A> + <A HREF="#3.3">3.3 Streaming from network or pipes</A> +</P> +<P> + <A HREF="dvd.html#4">4. CD/DVD section</A> +</P> +<P> + <A HREF="dvd.html#4.1">4.1 CD drives</A> + <A HREF="dvd.html#4.2">4.2 DVD drives</A> + <A HREF="dvd.html#4.3">4.3 DVD FAQ</A> +</P> +<P> + <A HREF="faq.html">5. FAQ section</A> +</P> +<P> + <A HREF="faq.html#5.1">5.1 Compilation</A> + <A HREF="faq.html#5.2">5.2 General questions</A> + <A HREF="faq.html#5.3">5.3 File playing problems</A> + <A HREF="faq.html#5.4">5.4 Video/audio driver problems</A> + <A HREF="faq.html#5.5">5.5 Feature requests</A> +</P> +<P> + <A HREF="#6">6. Misc OS'es</A> +</P> +<P> + <A HREF="#6.1">6.1 Debian packaging</A> + <A HREF="#6.2">6.2 FreeBSD</A> + <A HREF="#6.3">6.3 Solaris 8</A> + <A HREF="#6.4">6.4 StrongARM</A> +</P> +<P> + <A HREF="#A">A. Authors</A> +</P> +<P> + <A HREF="#B">B. Mailing lists</A> +</P> +<P> + <A HREF="bugreports.html">C. How to report bugs</A> +</P> +</PRE> +<P><HR></P> + +<P><PRE> + <A NAME=1>1. Introduction + + + <A NAME=1.1>1.1. Overview + + <B>MPlayer</B> is a movie player for LINUX. It plays most MPEG, AVI and ASF files, + supported by many native and Win32 DLL codecs. You can watch VCD, DVD and + even DivX movies too. The another big feature of mplayer is the wide range of + supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, + AAlib, but you can use SDL (and this way all drivers of SDL) and some + lowlevel card-specific drivers (for Matrox) too! Most of them supports + software or hardware scaling, so you can enjoy movies in fullscreen. And what + about the nice big antialiased shaded subtitles (7 supported types!!!) with + hungarian, english, cyrillic, czech, korean fonts, and OSD? + + I didn't write any codecs, just some players. I spent + a lot of time finding the best way to parse bad damaged input files + (both MPEG and AVI) and to do perfect A-V sync with seeking ability. + My player is rock solid playing damaged MPEG files (useful for some VCDs), + and it plays bad AVI files which are unplayable with the famous + windows media player. Even AVI files without index chunk are playable, and + you can rebuild their indexes with the -idx option, thus enabling seeking! + As you see, stability and quality are the most important things for me, + but the speed is also amazing. + + + <A NAME=1.2>1.2. History + + This began a year ago... + I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN, + xine,xanim,avifile,xmmp) but they all have some problem. Mostly with special + files or with audio/video sync. Most of them is unable to play both MPEG1, + MPEG2 and AVI (DivX) files. Many players have image quality or speed problems + too. So I've decided to write/modify one... + + - mpg12play v0.1-v0.3: + The first try, hacked together in a half hour! + I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3, + but there were image quality and speed problems with it. + - mpg12play v0.5-v0.87: + Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff, + but it was slow and was written in C++ (I hate C++!!!) + - mpg12play v0.9-v0.95pre5: + Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse. + It's great, optimized very fast C code with perfect image quality and + 100% MPEG standard conformance. + - <B>MPlayer</B> v0.3-v0.9: + It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI + player 'avip' based on avifile's Win32 DLL loader. + - <B>MPlayer</B> v0.10: + The MPEG and AVI player in a single binary! + - <B>MPlayer</B> v0.11: + Some new developers joined and from 0.11 the mplayer project is a team-work! + Added .ASF file support, and OpenDivX (see www.projectmayo.com) en/decoding. + - <B>MPlayer</B> v0.17 "The IdegCounter" + The release version of the 0.11pre after 4 months of heavy development! + Try it, and be amazed! Thousands of new features added... and of course + old code was improved too, bugs removed etc. + - <B>MPlayer</B> 0.18 "The BugCounter" + 2 months since 0.17 and here's a new release.. Completed ASF support, + more subtitle formats, introduced libao (similar to libvo but to audio), + even more stable than ever, and so on. It's a MUST ! + + + <A NAME=1.3>1.3. Installation + + If you plan to use <B>MPlayer</B> on x86 architecture, you possibly want to use + Win32 codecs. Download and unzip w32codecs.zip to /usr/lib/win32 . + Note: the avifile project has similar codecs package, but it differs + from our, so if you want to use all supported codecs, then use + our package! However, you can use our codecs package with avifile. + + If you own a Matrox G200/G400/G450 card, then please see the <A HREF="video.html#2.2.1.7">2.2.1.7</A> + section in order to gain big speedup. It is important to do these steps + _before_ compiling <B>MPlayer</B>, otherwise no Matrox-specific support will be + built. + + If you plan to use the ProjectMayo's <B>OpenDivX</B> codec, check the + <A HREF="codecs.html#2.1.2.1">2.1.2.1</A> section before compiling. + + Then build <B>MPlayer</B>: + + + ./configure + make + make install + + + It is recommended to browse the output of ./configure , it contains info + about what will be built, and what won't. You may also want to view + config.h and config.mak files. + + Though not mandatory, the fonts should be installed in order to gain + OSD, and subtitle functionality. Download mp_font3.zip (and optional + language updates) and optional (if exists) language updates. + + + mkdir ~/.mplayer/font + cd ~/.mplayer/font + unzip mp_font3.zip + unzip mp_font3_hu.zip + + + <A NAME=1.4>1.4. What about the GUI ? + + I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console. + So the player has only keyboard control from the controlling console/xterm now. + There is a GUI development for the player, coordinated by Pontscho/Fresh! + It's still under development, but it will be merged and released real soon. + BTW he needs some nice skins, if you are a good graphician, contact him!!! + + + <A NAME=2>2. Features + + + <A NAME=2.1>2.1. <A HREF="codecs.html">Video Formats, Audio & Video Codecs</A> + + + <A NAME=2.2>2.2. <A HREF="video.html">Video</A> & <A HREF="sound.html">Audio</A> output devices + + + <A NAME=3>3. Usage + + file: mplayer [options] [path/]filename + VCD: mplayer [options] -vcd trackno /dev/cdrom + DVD: mplayer [options] -dvdauth /dev/dvd filename.VOB + net: mplayer [options] http://site.com/file.[mpg|avi] + + mplayer -vo x11 /mnt/Films/Contact/contact2.mpg + mplayer -vcd 2 /dev/cdrom + mplayer -afm 3 /mnt/DVDtrailers/alien4.vob + mplayer -dvd /dev/dvd /mnt/dvd/matrix.vob + mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi + + + <A NAME=3.1>3.1. Control from keyboard + + + l/r arrows seek backward/forward 10 seconds + up or down seek backward/forward 1 minute + p or SPACE pause movie (press any key to continue) + q or ^C stop playing and quit program + o toggle OSD : none / seek / seek+timer + / and * decrease/increase volume + m toggle using master/pcm channel for volume setting + f toggle fullscreen (only with -vo sdl) + + + <A NAME=3.2>3.2. Control from LIRC + + Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver, + an (almost) arbitrary remote control and control your linux box with it! + More about it at www.lirc.org. + + If you have installed the lirc-package, you can compile <B>MPlayer</B> with LIRC + support using ./configure --enable-lirc + + If everything went fine, <B>MPlayer</B> will print a message like + LIRC init was successful. + on startup. If an error occurs it will tell you. If it doens't tell you + anything about LIRC there's no support compiled in. That's it :-) + + The application name for <B>MPlayer</B> is - oh wonder - mplayer_lirc. + It understands the following commands: + + PAUSE - pause playing. Any other keystroke will continue replay. + QUIT - exit mplayer + RWND - 10 secs back + FRWND - 60 secs back + FWD - skip 10 secs + FFWD - skip 60 secs + INCVOL - increase volume one percent + DECVOL - decrease volmue one percent + MASTER - use master mixer channel + PCM - use pcm mixer channel + + Don't forget to enable the repeat flag for RWND/FWD in .lircrc. Here's an + excerpt from my .lircrc: + + begin + remote = CU-SX070 + prog = mplayer_lirc + button = Tape_Play + repeat = 1 + config = FFWD + end + + begin + remote = CU-SX070 + prog = mplayer_lirc + button = Tape_Stop + config = QUIT + end + + If you don't like the standard location for the lirc-config file (~/.lircrc) + use the -lircconf [filename] switch to specify another file. + + + <A NAME=3.3>3.3. Streaming from network or pipes + + <B>MPlayer</B> can play media from network, by using the HTTP protocol, and even + beta ASF streaming (FROM network) is available. + Configuring it is simple, just recompile <B>MPlayer</B> with + + + ./configure --enable-streaming + + + <B>MPlayer</B> can read from stdin (NOT named pipes). This can be for example + used to play from FTP : + + + wget ftp://micorsops.com/something.avi -O - | mplayer - + + + <A NAME=4>4. <A HREF="faq.html">FAQ section</A> + + + <A NAME=5>5. <A HREF="dvd.html">CD/DVD section</A> + + + <A NAME=6>6. Misc OS'es + + + <A NAME=6.1>6.1. Debian packaging + + To build the package, get the cvs version, or .tgz and uncompress it, + and cd into programs directory: + + + cd main + fakeroot debian/rules binary + + + (... mplayer detects hardware/software, builds itself and.. ) + dpkg-deb: building package `mplayer' in `../mplayer_0.18-1_i386.deb'. + + And now just become root, and : + + + dpkg -i ../mplayer_0.18-1_i386.deb as root. + + + Here's how it looks like: + + eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb + Password: + (Reading database ... 26946 files and directories currently installed.) + Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb) + Unpacking replacement mplayer ... + Setting up mplayer (0.18-1) ... + + + <A NAME=6.2>6.2. FreeBSD + + To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), + native BSD make will not work. + + To run <B>MPlayer</B> you will need to re-compile the kernel with + "options USER_LDT" (unless you are running -CURRENT, where this is default). + If you have a CPU with SSE also use "options CPU_ENABLE_SSE" to use it + (FreeBSD-STABLE required, or use kernel patches). + + If <B>MPlayer</B> complains about "CD-ROM Device '/dev/cdrom' not found!" make a + symbolic link : ln -s /dev/(your_cdrom_device) /dev/cdrom + + There's no DVD support for FreeBSD yet. + Feel free to add it :-) + + + <A NAME=6.3>6.3. Solaris 8 + + AVI file playback works best on Solaris x86, because you have the + option to use the win32 codecs on the x86 platform. On Solaris SPARC, + you'll find quite a few AVI files with non working video and/or + audio playback, because the video/audio codecs using the win32 DLLs + are not available. However, <B>DivX/OpenDivX</B> movies should work, + when using libavcodec. + + To build the package you will need GNU make (gmake, /opt/sfw/gmake), native + Solaris make will not work. Typical error you get when building with solaris' + make instead of GNU make: + + + % /usr/ccs/bin/make + make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen + + + On Solaris SPARC, you need the GNU C/C++ Compiler; it does not matter + if GNU C/C++ compiler is configured with or without the GNU assembler. + + On Solaris x86, you need the GNU assembler and the GNU C/C++ + compiler, configured to use the GNU assembler! The mplayer code on + the x86 platform makes heavy use of MMX, SSE and 3DNOW! + instructions that cannot be compiled using Sun's assembler + /usr/ccs/bin/as. + + The configure script tries to find out, which assembler program is + used by your "gcc" command (in case the autodetection fails, use + the "--as=/whereever/you/have/installed/gnu-as" option to tell the + configure script where it can find GNU "as" on your system). + + Error message from configure on a Solaris x86 system using GCC + without GNU assembler: + + % configure + ... + Checking assembler (/usr/ccs/bin/as) ... , failed + Please upgrade(downgrade) binutils to 2.10.1... + + (Solution: Install and use a gcc configured with "--with-as=gas") + + Typical error you get when building with a GNU C compiler that does + not use GNU as: + + % gmake + ... + gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math + -fomit-frame-pointer -I/usr/local/include -o mplayer.o mplayer.c + Assembler: mplayer.c + "(stdin)", line 3567 : Illegal mnemonic + "(stdin)", line 3567 : Syntax error + ... more "Illegal mnemonic" and "Syntax error" errors ... + + + For DVD support you must have the patched libcss installed. Patch: + http://www.tools.de/solaris/mplayer/ + + + Due to two bugs in solaris 8 x86, you cannot reliably play DVDs using a + capacity >4GB: + + - The sd(7D) driver on solaris 8 x86 driver has bug when accessing a + disk block >4GB on a device using a logical blocksize != DEV_BSIZE + (i.e. CDROM and DVD media). Due to a 32bit int overflow, a disk + address modulo 4GB is accessed. + (http://groups.yahoo.com/group/solarisonintel/message/22516) + + - The similar bug is present in the hsfs(7FS) filesystem code (aka + ISO9660), hsfs currently does not support partitions/disks >4GB, + all data is accessed modulo 4GB + (http://groups.yahoo.com/group/solarisonintel/message/22592) + + + <A NAME=6.4>6.4. StrongARM + + MPlayer is reported to compile on StrongARM. Use the following command line: + + + ./configure --target=arm-linux --disable-css --with-x11libdir=/usr/arm/lib + --with-x11incdir=/usr/arm/lib --disable-gcc-checking + + + <A NAME=A>Appendix A - Authors + +NOTE: Do *NOT* send bugreports, help & feature requests directly to the authors! +===== Read Appendix <A HREF="#C">C</A> and subscribe to mplayer-users mailing lists. + +========================== The <B>MPlayer</B> project: =============================== + +Árpád Gereöffy (A'rpi/ESP-team): <arpi@thot.banki.hu> +- player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...) +- mp3lib, based on mpglib sources [MP3 audio decoder] +- getch2 [keyboard handler] +- some changes in libmpeg2 code (progressive frames, bitrate & fps support) +- libvo improvements: adding OpenGL support, bugfix in mga driver... +- triple buffering & YUY2 support (for DivX/MPEG4) into mga_vid driver +- scripts in the TVout directory (TVout on Matrox G400DH, read documentation) +- hacking DivX/Mpeg4 VfW codecs to get YUV output +- opendivx decoder speed optimizations (see opendivx/ChangeLog) +- OSD & SUB display code +- ffmpeg/libavcodec integration +- DivX4Linux (ProjectMayo) support (see documentation) + +Zoltán Ponekker (Pontscho/Fresh!): <pontscho@makacs.poliod.hu> +- configure script and Makefiles for easy compile +- GUI system (near complete!?) +- 3DNow! support into mp3lib +- 3DNow! support into fastmemcpy.h +- various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc) +- libvo: adding xmga driver, and fullscreen support to xv +- audio mixer (volume) support + +Gábor Lénárt (LGB): <lgb@lgb.hu> +- ./configure script improvements +- Makefile improvements +- prelimenary DVD support +- another GUI code (is that so..?) +- various X11 cleanups and fixes + +Gábor Bérczi (Gabucino): <gabucino@k2.jozsef.kando.hu> +- documentation maintainer +- hungarian translation of documentation +- second webpage design&gfx +- webpage maintainer +- testing, codecs quality & speed comparsions +- IRC channel #<B>MPlayer</B> operator + (devel channel, users earn kickban) +- experimental MINIX port + +Szabolcs Berecz (Szabi): <szabi@inf.elte.hu> +- codecs.conf file parser +- config file and command line parser +- mga_vid fixes, module option etc. +- fbdev support in libvo +- type #7 subtitle support + +László Megyer (Lez, Laaz): <lez@sch.bme.hu> +- SUB reader +- screensaver+DPMS disable for libvo + +Gyula László (Chass, Tégla): <chass-@freemail.hu> +- first fonts (mp_font1.zip) +- third (current) homepage design&gfx + +Zoltán Márk Vicián (Se7en): <se7en@sch.bme.hu> +- SVGAlib support in libvo + +Alex Beregszaszi (Al3x): <alex@naxine.org> +- ALSA output driver in libao2 +- vo_ggi output driver in libvo (www.ggi-project.org) + +Andreas Ackermann (Acki): <asackerm@stud.informatik.uni-erlangen.de> +- LIRC support (see documentation) +- DGA support in libvo + +Felix Bünemann (Atmos): <atmosfear@users.sourceforge.net> +- SDL driver maintainer +- Additional YUV formats fixes +- New font (mp_font2.zip) +- PNG file output support in libvo +- flipping support (for Indeo 3/4, etc) +- SDL audio driver in libao2 +- RAW PCM/WAVE file writer for libao2 + +TeLeNiEkO: <telenieko@telenieko.com> +- spanish translation of documentation + +Michael Graffam: <mgraffam@idsi.net> +- XF86VidMode support to vo_x11 and vo_dga +- Video mode switching code to vo_dga + |