comparison DOCS/README @ 907:b194061e3f03

pre-review

906:8eca9b7aafae

=============================== * See the file AUTHORS for the complete list *
http://mplayer.sourceforge.net

About:
~~~~~~
MPlayer 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/3dfx/SiS) too! Most of them supports software
or hardware scaling, so you can enjoy movies in fullscreen. And what about the

Yes. Yet another movie player for linux.
What is the special with this? It works, at least for me :)
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,

  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.
- MPlayer 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.
- MPlayer v0.10:
  The mpeg and avi player in a single binary!
- MPlayer v0.11:
  Added .asf file support, and OpenDivX (see www.projectmayo.com) en/decoding.
- MPlayer 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.

As you see, I didn't write any codecs, just some players. Instead I spent
a lot of time finding the best way to parse bad damaged input files
(both mpg 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,
speed has lower priority, but is still very important.

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.
But 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!!!

Supported input formats:
~~~~~~~~~~~~~~~~~~~~~~~~

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*** See http://mplayer.sourceforge.net/DOCS/codecs.html ***
***               for the complete list                 ***

The most important video codecs:
- mpeg1 (VCD) and mpeg2 (DVD) video
- DivX, OpenDivX and other MPEG4 variants
- Windows Media Video 7 (WMV1) 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
- AC3 dolby audio
- Voxware audio
- alaw, msgsm, pcm and other simple old audio formats

If you have a codec not listed here, and not supported yet, just

Supported video output devices:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
General:
- x11:	X11 with SHM extension
- xv:	X11 using overlays with the Xvideo extension (hardware YUV & scaling)
- gl:	OpenGL renderer, works only with Utah-GLX! (no DRI or nVidia drivers)
- dga:	X11 DGA extension
- fsdga:X11 DGA extension with fullscreen scaling (only 24/32bpp and MPEG!)
- fbdev:Output to general framebuffers
- svga: Output to SVGAlib
- sdl:	SDL >= v1.1.7 driver (supports software scaling, and versions >=1.1.8

Card specific:
- mga:	Matrox G200/G400 hardware YUV overlay via the mga_vid device
- xmga:	Matrox G200/G400 overlay (mga_vid) in X11 window
	(Xv emulation on X 3.3.x !)
- syncfb: Matrox G400 YUV support on framebuffer (obsoloted, use mga/xmga)
- 3dfx:	Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)

Special:
- png:  PNG files output (use -z switch to set compression)
- pgm:	PGM files output (for testing purposes or ffmpeg encoding)
- md5:	MD5sum output (for mpeg conformance tests)
- odivx:OpenDivX AVI File writer (use -br to set encoding bitrate)
- null:	Null output (for speed tests/benchmarking)

NOTE: check DOCS/VIDEOCARDS !

Speed:
~~~~~~
Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!/3DNow!Ex.
You can improve rendering speed by setting up MTRR registers, see doc in MTRR.
Some *old* benchmark results can be found in the doc file SPEED.

Usage:
~~~~~~
  mplayer [options] [-vo driver] [path/]filename

This feature combined with external wrappers extends possibilities.
For example, to play a movie just downloaded from your favourite divx
server:
	rar p ast-nssvcd.rar | mplayer -vo xmga -fs -

With an asf grabber or http dump program you can play from the net.
	wget ftp://micorsops.com/something.avi -O - | mplayer -

(however we planned to add direct asf/http/ftp inputs with seeking and other
stuff, but for now it's a good workaround)

TV output:
~~~~~~~~~~
If you have a Matrox G400 Dual-Head card, you can watch movies on TV, using

NOTE: language of above lists are ENGLISH, unless explicitly stated otherwise.
      Please do not send messages using other language!

License:
~~~~~~~~
Since MPlayer incorporates a lot of code from other projects, this isn't
decided yet. We're going for GPL (will be pretty hard, though).

Standard Disclaimer:
~~~~~~~~~~~~~~~~~~~~
Use only at your own risk! There may be errors and inaccuracies that could
damage your system or your eye. Proceed with caution, and although this is
highly unlikely, we don't take any responsibility for that!

907:b194061e3f03

=============================== * See the file AUTHORS for the complete list *
http://mplayer.sourceforge.net

About:
~~~~~~
MPlayer 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/3dfx/SiS) too! Most of them supports software
or hardware scaling, so you can enjoy movies in fullscreen. And what about the

Yes. Yet another movie player for linux.
What is the special with this? It works, at least for me :)
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,

  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.
- MPlayer 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.
- MPlayer v0.10:
  The MPEG and AVI player in a single binary!
- MPlayer v0.11:
  Added .ASF file support, and OpenDivX (see www.projectmayo.com) en/decoding.
- MPlayer 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.

As you see, I didn't write any codecs, just some players. Instead 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.

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!!!

Supported input formats:
~~~~~~~~~~~~~~~~~~~~~~~~

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*** See http://mplayer.sourceforge.net/DOCS/codecs.html ***
***               for the complete list                 ***

The most important video codecs:
- MPEG1 (VCD) and MPEG2 (DVD) video
- DivX, OpenDivX and other MPEG4 variants
- Windows Media Video 7 (WMV1) 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
- AC3 dolby audio
- Voxware audio
- alaw, msgsm, pcm and other simple old audio formats

If you have a codec not listed here, and not supported yet, just

Supported video output devices:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
General:
- x11:	X11 with SHM extension
- xv:	X11 using overlays with the Xvideo extension (hardware YUV & scaling)
- gl:	OpenGL renderer, works only with Utah-GLX or Matrox with X >=4.0.3 !
        (no other DRI or nVidia drivers)
- dga:	X11 DGA extension
- fsdga:X11 DGA extension with fullscreen scaling (only 24/32bpp and MPEG!)
- fbdev:Output to general framebuffers
- svga: Output to SVGAlib
- sdl:	SDL >= v1.1.7 driver (supports software scaling, and versions >=1.1.8

Card specific:
- mga:	Matrox G200/G400 hardware YUV overlay via the mga_vid device
- xmga:	Matrox G200/G400 overlay (mga_vid) in X11 window
	(Xv emulation on X 3.3.x !)
- syncfb: Matrox G400 YUV support on framebuffer (obsoleted, use mga/xmga)
- 3dfx:	Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)

Special:
- png:  PNG files output (use -z switch to set compression)
- pgm:	PGM files output (for testing purposes or ffmpeg encoding)
- md5:	MD5sum output (for MPEG conformance tests)
- odivx:OpenDivX AVI File writer (use -br to set encoding bitrate)
- null:	Null output (for speed tests/benchmarking)

NOTE: check DOCS/VIDEOCARDS !

Speed:
~~~~~~
Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!/3DNow!Ex.
You can improve rendering speed by setting up MTRR registers, see doc in MTRR.
Some *old* benchmark results can be found in the file DOCS/SPEED.

Usage:
~~~~~~
  mplayer [options] [-vo driver] [path/]filename

This feature combined with external wrappers extends possibilities.
For example, to play a movie just downloaded from your favourite divx
server:
	rar p ast-nssvcd.rar | mplayer -vo xmga -fs -

With an ASF grabber or http dump program you can play from the net.
	wget ftp://micorsops.com/something.avi -O - | mplayer -

(however we planned to add direct ASF/http/ftp inputs with seeking and other
stuff, but for now it's a good workaround)

TV output:
~~~~~~~~~~
If you have a Matrox G400 Dual-Head card, you can watch movies on TV, using

NOTE: language of above lists are ENGLISH, unless explicitly stated otherwise.
      Please do not send messages using other language!

License:
~~~~~~~~
MPlayer incorporates a lot of code from other projects, but for now everything
except the OpenDivX stuff is under General Public License (GPL) version 2 or
later. See DOCS/COPYING

Standard Disclaimer:
~~~~~~~~~~~~~~~~~~~~
Use only at your own risk! There may be errors and inaccuracies that could
damage your system, your eye or ear. Proceed with caution, and although this is
highly unlikely, we don't take any responsibility for that!