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 version 2 as published by the Free Software Foundation.

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. Codec installation
2.5.1. Xvid
2.5.2. x264
2.5.3. AMR
2.5.4. XMMS
2.6. 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. DVD playback
3.5.1. region code
3.6. VCD playback
3.7. Edit Decision Lists (EDL)
3.7.1. Using an EDL file
3.7.2. Making an EDL file
3.8. Synchronized playback over a network
3.9. Surround/Multichannel playback
3.9.1. DVDs
3.9.2. Playing stereo files to four speakers
3.9.3. AC-3/DTS Passthrough
3.9.4. MPEG audio Passthrough
3.9.5. Matrix-encoded audio
3.9.6. Surround emulation in headphones
3.9.7. Troubleshooting
3.10. Channel manipulation
3.10.1. General information
3.10.2. Playing mono with two speakers
3.10.3. Channel copying/moving
3.10.4. Channel mixing
3.11. Software Volume adjustment
3.12. TV input
3.12.1. Usage tips
3.12.2. Examples
3.13. Teletext
3.13.1. Implementation notes
3.13.2. Using teletext
3.14. Radio
3.14.1. Usage tips
3.14.2. Examples
4. Video output devices
4.1. Xv
4.2. DGA
4.3. SVGAlib
4.4. Framebuffer output (FBdev)
4.5. Matrox framebuffer (mga_vid)
4.6. 3Dfx YUV support
4.7. tdfx_vid
4.8. OpenGL output
4.9. AAlib – text mode displaying
4.10. libcaca – Color ASCII Art library
4.11. VESA - output to VESA BIOS
4.12. X11
4.13. VIDIX
4.13.1. svgalib_helper
4.13.2. ATI cards
4.13.3. Matrox cards
4.13.4. Trident cards
4.13.5. 3DLabs cards
4.13.6. nVidia cards
4.13.7. SiS cards
4.14. DirectFB
4.15. DirectFB/Matrox (dfbmga)
4.16. MPEG decoders
4.16.1. DVB output and input
4.16.2. DXR2
4.16.3. DXR3/Hollywood+
4.17. Zr
4.18. Blinkenlights
4.19. TV-out support
4.19.1. Matrox G400 cards
4.19.2. Matrox G450/G550 cards
4.19.3. Building a Matrox TV-out cable
4.19.4. ATI cards
4.19.5. nVidia
4.19.6. NeoMagic
5. Ports
5.1. Linux
5.1.1. Debian packaging
5.1.2. RPM packaging
5.1.3. ARM Linux
5.2. *BSD
5.2.1. FreeBSD
5.2.2. OpenBSD
5.2.3. Darwin
5.3. Commercial Unix
5.3.1. Solaris
5.3.2. HP-UX
5.3.3. AIX
5.3.4. QNX
5.4. Windows
5.4.1. Cygwin
5.4.2. MinGW
5.5. Mac OS
5.5.1. MPlayer OS X GUI
6. Basic usage of MEncoder
6.1. Selecting codecs and container formats
6.2. Selecting input file or device
6.3. Encoding two pass MPEG-4 ("DivX")
6.4. Encoding to Sony PSP video format
6.5. Encoding to MPEG format
6.6. Rescaling movies
6.7. Stream copying
6.8. Encoding from multiple input image files (JPEG, PNG, TGA, etc.)
6.9. Extracting DVD subtitles to VOBsub file
6.10. Preserving aspect ratio
7. Encoding with MEncoder
7.1. Making a high quality MPEG-4 ("DivX") rip of a DVD movie
7.1.1. Preparing to encode: Identifying source material and framerate Identifying source framerate Identifying source material
7.1.2. Constant quantizer vs. multipass
7.1.3. Constraints for efficient encoding
7.1.4. Cropping and Scaling
7.1.5. Choosing resolution and bitrate Computing the resolution
7.1.6. Filtering
7.1.7. Interlacing and Telecine
7.1.8. Encoding interlaced video
7.1.9. Notes on Audio/Video synchronization
7.1.10. Choosing the video codec
7.1.11. Audio
7.1.12. Muxing Improving muxing and A/V sync reliability Limitations of the AVI container Muxing into the Matroska container
7.2. How to deal with telecine and interlacing within NTSC DVDs
7.2.1. Introduction
7.2.2. How to tell what type of video you have Progressive Telecined Interlaced Mixed progressive and telecine Mixed progressive and interlaced
7.2.3. How to encode each category Progressive Telecined Interlaced Mixed progressive and telecine Mixed progressive and interlaced
7.2.4. Footnotes
7.3. Encoding with the libavcodec codec family
7.3.1. libavcodec's video codecs
7.3.2. libavcodec's audio codecs PCM/ADPCM format supplementary table
7.3.3. Encoding options of libavcodec
7.3.4. Encoding setting examples
7.3.5. Custom inter/intra matrices
7.3.6. Example
7.4. Encoding with the Xvid codec
7.4.1. What options should I use to get the best results?
7.4.2. Encoding options of Xvid
7.4.3. Encoding profiles
7.4.4. Encoding setting examples
7.5. Encoding with the x264 codec
7.5.1. Encoding options of x264 Introduction Options which primarily affect speed and quality Options pertaining to miscellaneous preferences
7.5.2. Encoding setting examples
7.6. Encoding with the Video For Windows codec family
7.6.1. Video for Windows supported codecs
7.6.2. Using vfw2menc to create a codec settings file.
7.7. Using MEncoder to create QuickTime-compatible files
7.7.1. Why would one want to produce QuickTime-compatible Files?
7.7.2. QuickTime 7 limitations
7.7.3. Cropping
7.7.4. Scaling
7.7.5. A/V sync
7.7.6. Bitrate
7.7.7. Encoding example
7.7.8. Remuxing as MP4
7.7.9. Adding metadata tags
7.8. Using MEncoder to create VCD/SVCD/DVD-compliant files
7.8.1. Format Constraints Format Constraints GOP Size Constraints Bitrate Constraints
7.8.2. Output Options Aspect Ratio Maintaining A/V sync Sample Rate Conversion
7.8.3. Using libavcodec for VCD/SVCD/DVD Encoding Introduction lavcopts Examples Advanced Options
7.8.4. Encoding Audio toolame twolame libavcodec
7.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
8. Frequently Asked Questions
A. How to report bugs
A.1. Report security related 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. MPlayer skin format
B.1. Overview
B.1.1. Skin components
B.1.2. Image formats
B.1.3. Files
B.2. The skin file
B.2.1. Main window and playbar
B.2.2. Video window
B.2.3. Skin menu
B.3. Fonts
B.3.1. Symbols
B.4. GUI messages
B.5. Creating quality skins