MPlayer - The Movie Player


MPlayer is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

MPlayer is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with MPlayer; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

How to read this documentation
1. Introduction
2. Installation
2.1. Software requirements
2.2. Features
2.3. What about the GUI?
2.4. Fonts and OSD
2.4.1. TrueType fonts
2.4.2. bitmap fonts
2.4.3. OSD menu
2.5. RTC
3. Usage
3.1. Command line
3.2. Subtitles and OSD
3.3. Control
3.3.1. Controls configuration
3.3.2. Control from LIRC
3.3.3. Slave mode
3.4. Streaming from network or pipes
3.4.1. Saving streamed content
3.5. Edit Decision Lists (EDL)
3.5.1. Using an EDL file
3.5.2. Making an EDL file
3.6. Advanced audio
3.6.1. Surround/Multichannel playback DVDs Playing stereo files to four speakers AC-3/DTS Passthrough MPEG audio Passthrough Matrix-encoded audio Surround emulation in headphones Troubleshooting
3.6.2. Channel manipulation General information Playing mono with two speakers Channel copying/moving Channel mixing
3.6.3. Software Volume adjustment
4. CD/DVD usage
4.1. CD/DVD drives
4.1.1. Linux
4.1.2. FreeBSD
4.2. DVD playback
4.2.1. region code
4.3. VCD playback
5. Frequently Asked Questions
6. Containers
6.1. Video formats
6.1.1. MPEG files
6.1.2. AVI files
6.1.3. ASF/WMV files
6.1.4. QuickTime/MOV files
6.1.5. VIVO files
6.1.6. FLI files
6.1.7. RealMedia (RM) files
6.1.8. NuppelVideo files
6.1.9. yuv4mpeg files
6.1.10. FILM files
6.1.11. RoQ files
6.1.12. OGG/OGM files
6.1.13. SDP files
6.1.14. PVA files
6.1.15. NSV files
6.1.16. Matroska files
6.1.17. NUT files
6.1.18. GIF files
6.2. Audio formats
6.2.1. MP3 files
6.2.2. OGG/OGM files (Vorbis)
6.2.3. CD audio
6.2.4. XMMS
7. Codecs
7.1. Video codecs
7.1.1. FFmpeg/libavcodec
7.1.2. Xvid
7.1.3. x264 What is x264? What is H.264? How can I play H.264 videos with MPlayer? How can I encode videos using MEncoder and x264?
7.2. Audio codecs
7.2.1. Software AC-3 decoding
7.2.2. Hardware AC-3 decoding
7.2.3. libmad support
7.2.4. Hardware MPEG audio codec
7.2.5. AAC codec
7.2.6. AMR codecs
7.3. Win32 codecs importing HOWTO
7.3.1. VFW codecs
7.3.2. DirectShow codecs
8. Video output devices
8.1. Setting up MTRR
8.2. Xv
8.2.1. 3dfx cards
8.2.2. S3 cards
8.2.3. nVidia cards
8.2.4. ATI cards
8.2.5. NeoMagic cards
8.2.6. Trident cards
8.2.7. Kyro/PowerVR cards
8.2.8. Intel cards
8.3. DGA
8.4. SDL
8.5. SVGAlib
8.6. Framebuffer output (FBdev)
8.7. Matrox framebuffer (mga_vid)
8.8. 3Dfx YUV support
8.9. tdfx_vid
8.10. OpenGL output
8.11. AAlib – text mode displaying
8.12. libcaca – Color ASCII Art library
8.13. VESA - output to VESA BIOS
8.14. X11
8.15. VIDIX
8.15.1. ATI cards
8.15.2. Matrox cards
8.15.3. Trident cards
8.15.4. 3DLabs cards
8.15.5. nVidia cards
8.15.6. SiS cards
8.16. DirectFB
8.17. DirectFB/Matrox (dfbmga)
8.18. MPEG decoders
8.18.1. DVB output and input
8.18.2. DXR2
8.18.3. DXR3/Hollywood+
8.19. Other visualization hardware
8.19.1. Zr
8.19.2. Blinkenlights
8.20. TV-out support
8.20.1. Matrox G400 cards
8.20.2. Matrox G450/G550 cards
8.20.3. ATI cards
8.20.4. nVidia
8.20.5. NeoMagic
9. Audio output devices
9.1. Audio/Video synchronization
9.2. Troubleshooting
10. TV
10.1. TV input
10.1.1. Compilation
10.1.2. Usage tips
10.1.3. Examples
10.2. Teletext
10.2.1. Implementation notes
10.2.2. Using teletext
10.2.3. Teletext hot keys
11. Radio
11.1. Radio input
11.1.1. Compilation
11.1.2. Usage tips
11.1.3. Examples
12. Ports
12.1. Linux
12.1.1. Debian packaging
12.1.2. RPM packaging
12.1.3. ARM
12.2. *BSD
12.2.1. FreeBSD
12.2.2. OpenBSD
12.2.3. Darwin
12.3. Commercial Unix
12.3.1. Solaris
12.3.2. IRIX
12.3.3. HP-UX
12.3.4. AIX
12.4. Windows
12.4.1. Cygwin
12.4.2. MinGW
12.5. Mac OS
12.5.1. MPlayer OS X GUI
12.6. Exotic Platforms
12.6.1. QNX
12.6.2. Amiga/MorphOS (GeekGadgets)
13. Basic usage of MEncoder
13.1. Selecting codecs and container formats
13.2. Selecting input file or device
13.3. Encoding two pass MPEG-4 ("DivX")
13.4. Encoding to Sony PSP video format
13.5. Encoding to MPEG format
13.6. Rescaling movies
13.7. Stream copying
13.8. Encoding from multiple input image files (JPEG, PNG, TGA, etc.)
13.9. Extracting DVD subtitles to VOBsub file
13.10. Preserving aspect ratio
14. Encoding with MEncoder
14.1. Making a high quality MPEG-4 ("DivX") rip of a DVD movie
14.1.1. Preparing to encode: Identifying source material and framerate Identifying source framerate Identifying source material
14.1.2. Constant quantizer vs. multipass
14.1.3. Constraints for efficient encoding
14.1.4. Cropping and Scaling
14.1.5. Choosing resolution and bitrate Computing the resolution
14.1.6. Filtering
14.1.7. Interlacing and Telecine
14.1.8. Encoding interlaced video
14.1.9. Notes on Audio/Video synchronization
14.1.10. Choosing the video codec
14.1.11. Audio
14.1.12. Muxing Improving muxing and A/V sync reliability Limitations of the AVI container Muxing into the Matroska container
14.2. How to deal with telecine and interlacing within NTSC DVDs
14.2.1. Introduction
14.2.2. How to tell what type of video you have Progressive Telecined Interlaced Mixed progressive and telecine Mixed progressive and interlaced
14.2.3. How to encode each category Progressive Telecined Interlaced Mixed progressive and telecine Mixed progressive and interlaced
14.2.4. Footnotes
14.3. Encoding with the libavcodec codec family
14.3.1. libavcodec's video codecs
14.3.2. libavcodec's audio codecs PCM/ADPCM format supplementary table
14.3.3. Encoding options of libavcodec
14.3.4. Encoding setting examples
14.3.5. Custom inter/intra matrices
14.3.6. Example
14.4. Encoding with the Xvid codec
14.4.1. What options should I use to get the best results?
14.4.2. Encoding options of Xvid
14.4.3. Encoding profiles
14.4.4. Encoding setting examples
14.5. Encoding with the x264 codec
14.5.1. Encoding options of x264 Introduction Options which primarily affect speed and quality Options pertaining to miscellaneous preferences
14.5.2. Encoding setting examples
14.6. Encoding with the Video For Windows codec family
14.6.1. Video for Windows supported codecs
14.6.2. Using vfw2menc to create a codec settings file.
14.7. Using MEncoder to create QuickTime-compatible files
14.7.1. Why would one want to produce QuickTime-compatible Files?
14.7.2. QuickTime 7 limitations
14.7.3. Cropping
14.7.4. Scaling
14.7.5. A/V sync
14.7.6. Bitrate
14.7.7. Encoding example
14.7.8. Remuxing as MP4
14.7.9. Adding metadata tags
14.8. Using MEncoder to create VCD/SVCD/DVD-compliant files
14.8.1. Format Constraints Format Constraints GOP Size Constraints Bitrate Constraints
14.8.2. Output Options Aspect Ratio Maintaining A/V sync Sample Rate Conversion
14.8.3. Using libavcodec for VCD/SVCD/DVD Encoding Introduction lavcopts Examples Advanced Options
14.8.4. Encoding Audio toolame twolame libavcodec
14.8.5. Putting it all Together PAL DVD NTSC DVD PAL AVI Containing AC-3 Audio to DVD NTSC AVI Containing AC-3 Audio to DVD PAL SVCD NTSC SVCD PAL VCD NTSC VCD
A. How to report bugs
A.1. Report security releated bugs
A.2. How to fix bugs
A.3. How to do regression testing using Subversion
A.4. How to report bugs
A.5. Where to report bugs
A.6. What to report
A.6.1. System Information
A.6.2. Hardware and drivers
A.6.3. Configure problems
A.6.4. Compilation problems
A.6.5. Playback problems
A.6.6. Crashes
A.6.6.1. How to conserve information about a reproducible crash
A.6.6.2. How to extract meaningful information from a core dump
A.7. I know what I am doing...
B. Known bugs
B.1. Special system/CPU-specific bugs/problems
B.2. Various A-V sync and other audio problems
B.2.1. General audio delay or jerky sound (exists with all or many files)
B.2.2. Audio delay/de-sync specific to one or a few files
B.2.3. No sound at all
B.2.4. No picture at all (just plain grey/green window)
B.2.5. Video-out problems
C. MPlayer skin format
C.1. Overview
C.1.1. Directories
C.1.2. Image formats
C.1.3. Skin components
C.1.4. Files
C.2. The skin file
C.2.1. Main window and playbar
C.2.2. Subwindow
C.2.3. Skin menu
C.3. Fonts
C.3.1. Symbols
C.4. GUI messages
C.5. Creating quality skins
D. History