Mercurial > mplayer.hg

comparison DOCS/README @ 540:4d0ad0f6b7dc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
some updates, not finished yet
author arpi_esp
date Fri, 20 Apr 2001 02:45:09 +0000
parents a8ab5e0f5560
children 4cc5bbc8f295
comparison
equal deleted inserted replaced
539:48f0c6f0519f 540:4d0ad0f6b7dc
1 MoviePlayer v0.12 "IdegCounter" (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team) 1 MPlayer v0.17-pre "IdegCounter" (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team)
2 =============================== * See the file AUTHORS for the complete list * 2 =============================== * See the file AUTHORS for the complete list *
3 http://mplayer.sourceforge.net
3 4
4 About: 5 About:
5 ~~~~~~ 6 ~~~~~~
7 MPlayer is a movie player for LINUX. It plays most mpeg, avi and asf files,
8 supported by many native and win32 DLL codecs. You can watch VCD, DVD and
9 even DivX movies too. The another big feature of mplayer is the wide range
10 of supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib,
11 fbdev, but you can use SDL (and this way all drivers of SDL) and some
12 lowlevel card-specific drivers (for Matrox/3dfx/SiS) too! Most of them
13 supports software or hardware scaling, so you can enjoy movies in fullscreen.
14 And what about the nice big antialiased shaded subtitles (.sub files) and OSD?
15
16 History:
17 ~~~~~~~~
6 Yes. Yet another movie player for linux. 18 Yes. Yet another movie player for linux.
7 What is the special with this? It works, at least for me :) 19 What is the special with this? It works, at least for me :)
8 I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN, 20 I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN,
9 xine,xanim,avifile,xmmp) but they all have some problem. Mostly with 21 xine,xanim,avifile,xmmp) but they all have some problem. Mostly with
10 special files or with audio/video sync. Most of them is unable to play 22 special files or with audio/video sync. Most of them is unable to play
11 both mpeg1, mpeg2 and avi (DivX) files. Many players have image quality 23 both mpeg1, mpeg2 and avi (DivX) files. Many players have image quality
12 or speed problems too. So I've decided to write/modify one... 24 or speed problems too. So I've decided to write/modify one...
13 25
14 Short history: 26 - mpg12play v0.1-v0.3:
15 - mpg12play v0.1 has born, using libmpeg3 from www.heroinewarrior.com 27 The first try, hacked together in a half hour!
16 - mpg12play 2nd generation (v0.5-), using dvdview by Dirk Farin 28 I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3,
17 - mpg12play 3nd generation (v0.9-), using libmpeg2 (mpeg2dec) by Aaron Holtzman 29 but there were image quality and speed problems with it.
18 - MPlayer has born, containing mpg12play 0.90pre5 and a new simple avi player 30 - mpg12play v0.5-v0.87:
19 - MPlayer 0.10, mpeg and avi player in a single binary 31 Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff,
20 - MPlayer 0.11: added .asf file support, and OpenDivX en/decoding 32 but it was slow and was written in C++ (I hate C++!!!)
21 - MPlayer 0.12 "IdegCounter" 33 - mpg12play v0.9-v0.95pre5:
22 The release version of the 0.11 development code. Far too many enhancements 34 Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse.
23 to fit here (A'rpi?). Try it, and be amazed. 35 It's great, optimized very fast C code with perfect image quality and
36 100% mpeg standard conformance.
37 - MPlayer v0.3-v0.9:
38 It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI
39 player 'avip' based on avifile's Win32 DLL loader.
40 - MPlayer v0.10:
41 The mpeg and avi player in a single binary!
42 - MPlayer v0.11:
43 Added .asf file support, and OpenDivX (see www.projectmayo.com) en/decoding.
44 - MPlayer v0.17 "The IdegCounter"
45 The release version of the 0.11pre after 4 months of heavy development!
46 Try it, and be amazed! Thousands of new features added... and of course
47 old code was improved too, bugs removed etc.
24 48
25 As you see, I didn't write any codecs, just some players. But I spent 49 As you see, I didn't write any codecs, just some players. But I spent
26 a lot of time finding the best way to parse bad damaged input files 50 a lot of time finding the best way to parse bad damaged input files
27 (both mpg and avi) and to do perfect A-V sync with seeking ability. 51 (both mpg and avi) and to do perfect A-V sync with seeking ability.
28 My player is rock solid playing damaged mpeg files (useful for some VCDs), 52 My player is rock solid playing damaged mpeg files (useful for some VCDs),
30 windows media player. Even AVI files without index chunk are playable! 54 windows media player. Even AVI files without index chunk are playable!
31 As you see, stability and quality are the most important things for me, 55 As you see, stability and quality are the most important things for me,
32 speed has lower priority, but is still very important. 56 speed has lower priority, but is still very important.
33 57
34 What about the GUI? 58 What about the GUI?
59 ~~~~~~~~~~~~~~~~~~~
35 I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console. 60 I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console.
36 So the player has only keyboard control from the controlling console/xterm now. 61 So the player has only keyboard control from the controlling console/xterm now.
37 But there is a GUI development for the player, coordinated by Pontscho/Fresh! 62 But there is a GUI development for the player, coordinated by Pontscho/Fresh!
38 It's still under development, but it will be merged and released soon. 63 It's still under development, but it will be merged and released soon.
39 BTW he needs some nice skins, if you are a good graphician, contact him!!! 64 BTW he needs some nice skins, if you are a good graphician, contact him!!!
40 65
41 Win32 codecs?
42 Yes, we are using Win32 (Video for Windows, DirectShow) codecs for AVI/ASF
43 decoding. They must be installed to the /usr/lib/win32/ directory, with all
44 lower case. You can grab the codecs package from our homepage, or can be found
45 in your C:\WINDOWS\SYSTEM\ dir, see codecs.conf for filenames.
46
47 Supported input formats: 66 Supported input formats:
48 ~~~~~~~~~~~~~~~~~~~~~~~~ 67 ~~~~~~~~~~~~~~~~~~~~~~~~
49 - VCD (Video CD) directly from CD-ROM or from CDRwin's .bin image file 68 - VCD (Video CD) directly from CD-ROM or from CDRwin's .bin image file
50 - MPEG 1/2 System Stream (PS/VOB) and Elementary Stream (ES) file formats 69 - DVD, directly from your DVD disk, using optional libcss for decryption
70 - MPEG 1/2 System Stream (PS/PES/VOB) and Elementary Stream (ES) file formats
51 - RIFF AVI file format 71 - RIFF AVI file format
52 - ASF 1.0 file format 72 - ASF 1.0 file format
53 - (De)crypted VOB files from DVD (experimental!)
54 73
55 Supported audio & video codecs: 74 Supported audio & video codecs:
56 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 75 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
57 See DOCS/CODECS for complete list. 76 *** See DOCS/CODECS for the complete list! ***
77
78 The most important video codecs:
79 - mpeg1 (VCD) and mpeg2 (DVD) video
80 - DivX, OpenDivX and other MPEG4 variants
81 - Windows Media Video 7 (WMV1) used in .wmv files
82 - Intel Indeo codecs (3.1,3.2,4.1,5.0)
83 - MJPEG, ASV2 and other hardware formats
84
85 The most important audio codecs:
86 - mpeg layer 2, and layer 3 (MP3) audio
87 - AC3 dolby audio
88 - alaw, msgsm, pcm and other simple old audio formats
58 89
59 Supported video output devices: 90 Supported video output devices:
60 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 91 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
92 General:
93 - x11: X11 with SHM extension
94 - xv: X11 using overlays with the Xvideo extension (hardware YUV & scaling)
95 - gl: OpenGL renderer, works only with Utah-GLX! (no DRI or nVidia drivers)
96 - dga: X11 DGA extension
97 - fsdga:X11 DGA extension with fullscreen scaling (only 24/32bpp and MPEG!)
98 - fbdev:Output to general framebuffers
99 - svga: Output to SVGAlib
100 - sdl: SDL >= v1.1.7 driver (supports software scaling, and versions >=1.1.8
101 even support Xvideo, thus hardware rendering)
102
103 Card specific:
61 - mga: Matrox G200/G400 hardware YUV overlay via the mga_vid device 104 - mga: Matrox G200/G400 hardware YUV overlay via the mga_vid device
62 - xmga: Matrox G200/G400 overlay (mga_vid) in X11 window 105 - xmga: Matrox G200/G400 overlay (mga_vid) in X11 window
63 (Xv emulation on X 3.3.x !) 106 (Xv emulation on X 3.3.x !)
64 - syncfb: Matrox G400 YUV support on framebuffer (not tested, maybe broken) 107 - syncfb: Matrox G400 YUV support on framebuffer (not tested, maybe broken)
65 - xv: X11 using overlays with the Xvideo extension (hardware YUV & scaling) 108 - 3dfx: Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)
66 - x11: X11 with SHM extension 109
67 - gl: OpenGL renderer, works only with Utah-GLX! (no DRI or nVidia drivers) 110 Special:
68 - dga: X11 DGA extension 111 - png: PNG files output (use -z switch to set compression)
69 - fsdga:X11 DGA extension with fullscreen scaling (only 24/32bpp and MPEG!) 112 - pgm: PGM files output (for testing purposes)
70 - sdl: SDL >= v1.1.7 driver (supports software scaling, and versions >=1.1.8 113 - md5: MD5sum output (for mpeg conformance tests)
71 even support Xvideo, thus hardware rendering) 114 - odivx:OpenDivX AVI File writer (use -br to set encoding bitrate)
72 (NOT supported by us! Don't submit SDL bugreports!)
73 - fbdev:Output to general framebuffers
74 - svga: Output to SVGAlib
75 - png: PNG file output (use -z switch to set compression)
76 - null: Null output (for speed tests/benchmarking) 115 - null: Null output (for speed tests/benchmarking)
77 - 3dfx: Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)
78 - odivx:OpenDivX AVI File writer
79 - pgm: PGM file output (for testing purposes)
80 - md5: MD5sum output (for mpeg conformance tests)
81 116
82 NOTE: check DOCS/VIDEOCARDS ! 117 NOTE: check DOCS/VIDEOCARDS !
83 118
84 Supported audio output devices: 119 Supported audio output devices:
85 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 120 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
86 - OSS driver 121 - OSS driver
87 - ALSA driver with OSS emulation (NOT recommended, causes annoying delays) 122 - ALSA driver with OSS emulation (NOT recommended, causes annoying delays)
88 - ESD with the esddsp utility (not tested, not recommended, see ALSA) 123 - ESD with the esddsp utility (not tested, not recommended, see ALSA)
89 124
90 NOTE: check DOCS/SOUNDCARDS ! 125 NOTE: check DOCS/SOUNDCARDS for details!
91 126
92 Speed: 127 Speed:
93 ~~~~~~ 128 ~~~~~~
94 Most of time-critical parts are optimized for MMX/SSE/3DNow!. 129 Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!.
95 You can improve rendering speed by setting up MTRR registers, see doc in MTRR. 130 You can improve rendering speed by setting up MTRR registers, see doc in MTRR.
96 Some benchmark results can be found in the doc file SPEED. 131 Some *old* benchmark results can be found in the doc file SPEED.
97 132
98 Usage: 133 Usage:
99 ~~~~~~ 134 ~~~~~~
100 mplayer [options] [-vo driver] [path/]filename 135 mplayer [options] [-vo driver] [path/]filename
101 136
102 Options: 137 Options:
103 see mplayer -h for options 138 see `mplayer -h' for options
104 see mplayer -vo help for available output drivers 139 see `mplayer -vo help' for list of available output drivers
105 140
106 Keys: 141 Keys:
107 <- or -> seek backward/forward 10 seconds 142 <- or -> seek backward/forward 10 seconds
108 up or down seek backward/forward 1 minute 143 up or down seek backward/forward 1 minute
109 p or SPACE pause movie (press any key to continue) 144 p or SPACE pause movie (press any key to continue)
126 and run 'depmod -a' . 161 and run 'depmod -a' .
127 162
128 License: 163 License:
129 ~~~~~~~~ 164 ~~~~~~~~
130 Since MPlayer incorporates a lot of code from other projects, this isn't 165 Since MPlayer incorporates a lot of code from other projects, this isn't
131 decided yet. 166 decided yet. We're going for GPL (will be pretty hard, though).
132 We're going for GPL (will be pretty hard, though).
133 167
134 TV output: 168 TV output:
135 ~~~~~~~~~~ 169 ~~~~~~~~~~
136 If you have a Matrox G400 Dual-Head card, you can watch movies on TV, 170 If you have a Matrox G400 Dual-Head card, you can watch movies on TV,
137 using TV-out feature of the second head. You must have matroxfb support 171 using TV-out feature of the second head. You must have matroxfb support
147 ~~~~~~~~~~~~~~~~~~~ 181 ~~~~~~~~~~~~~~~~~~~
148 First please read all the docs in this package, most of the problems are 182 First please read all the docs in this package, most of the problems are
149 described somewhere. At least read the Troubleshooting section! 183 described somewhere. At least read the Troubleshooting section!
150 We don't like answering questions which are already answered in this 184 We don't like answering questions which are already answered in this
151 readme or other docs. 185 readme or other docs.
152 You should try the latest test (pre) release version too, maybe your bug 186 You should try the latest development version (from CVS) too, maybe your bug
153 is already fixed, but the new version hasn't been released. 187 is already fixed, but the new version hasn't been released.
154 If you couldn't solve the problem, then send a quality bugreport 188 If you couldn't solve the problem, then send a quality bugreport
155 via E-Mail to the MPlayer-users list : mplayer-users@lists.sourceforge.net 189 via E-Mail to the MPlayer-users list : mplayer-users@lists.sourceforge.net
156 190
157 *NEVER* send attached AVIs, MPEGs, or any big files to this list!!! 191 *NEVER* send attached AVIs, MPEGs, or any big files to this list or private!!!
158 Upload them to ftp://thot.banki.hu/incoming , and inform the list about 192 Upload them to ftp://thot.banki.hu/incoming/MPlayer/ , and inform the list
159 your upload. 193 about your upload.
160 194
161 Please include these: 195 Please include these:
162 - your kernel version number ('uname -a') 196 - your kernel version number ('uname -a')
163 - linux distribution and glibc version (example: Slackware 7.1 + glibc 2.1.3) 197 - linux distribution and glibc version (example: Slackware 7.1 + glibc 2.1.3)
164 - gcc and binutils version ('gcc -v' and 'as --version') 198 - gcc and binutils version ('gcc -v' and 'as --version')
165 - your X11 version (example: X 4.0.2 + DRI snapshot2001jan12) 199 - your X11 version (example: X 4.0.2 + DRI snapshot2001jan12)
166 - video card vendor/model (example: Matrox G400 MAX AGP) 200 - video card vendor/model (example: Matrox G400 DH MAX AGP)
201 - sound card model+driver (example: Creative SBLive! with OSS (kernel) )
167 - CPU vendor and type (example: Intel Celeron2-566 at 850MHz) 202 - CPU vendor and type (example: Intel Celeron2-566 at 850MHz)
168 203
169 Also include the required logs (as attachment, may be compressed zip/gz/bz2) 204 Also include the required logs (as attachment, may be compressed zip/gz/bz2)
170 depending the problem type (see bellow at Troubleshooting section). 205 depending the problem type (see bellow at Troubleshooting section).
171 206 Do not send level-0 logs, always use the mplayer option '-v' when making log:
172 To log output to a file, use the &> shell operator. For example: 207
173 ./configure &>configure.log 208 ./configure &>configure.log
209 make &>make.log
174 mplayer -v test.avi &>play.log 210 mplayer -v test.avi &>play.log
175 211
176 If we ask you for the file, then you have two choices: 212 If we ask you for the file, then you have two choices:
177 - upload the file to ftp://thot.banki.hu/incoming (at least a few megabytes) 213 - upload the file to ftp://thot.banki.hu/incoming (at least a few megabytes)
178 - send the exact URL of the file, and we'll download it soon. 214 - send the exact URL of the file, and we'll download it soon.