summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorgabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2>2001-08-21 21:01:54 +0000
committergabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2>2001-08-21 21:01:54 +0000
commitc10396e50ff2aafa4bcc480f8391927425f3bb2d (patch)
tree0498a88de8e547e6b17b13c4b1c5305b54fdc451 /DOCS
parent1af8d58c0bf4a4cbac5fa9e5cfb8bc382c047b8c (diff)
downloadmpv-c10396e50ff2aafa4bcc480f8391927425f3bb2d.tar.bz2
mpv-c10396e50ff2aafa4bcc480f8391927425f3bb2d.tar.xz
new, splitted, etc dox
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@1613 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/bugreports.html141
-rw-r--r--DOCS/codecs.html219
-rw-r--r--DOCS/documentation.html731
-rw-r--r--DOCS/dvd.html207
-rw-r--r--DOCS/faq.html322
-rw-r--r--DOCS/sound.html84
-rw-r--r--DOCS/video.html677
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