annotate DOCS/README @ 540:4d0ad0f6b7dc

some updates, not finished yet
author arpi_esp
date Fri, 20 Apr 2001 02:45:09 +0000
parents a8ab5e0f5560
children 4cc5bbc8f295
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
1 MPlayer v0.17-pre "IdegCounter" (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team)
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
2 =============================== * See the file AUTHORS for the complete list *
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
3 http://mplayer.sourceforge.net
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
4
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
5 About:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
6 ~~~~~~
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
7 MPlayer is a movie player for LINUX. It plays most mpeg, avi and asf files,
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
8 supported by many native and win32 DLL codecs. You can watch VCD, DVD and
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
9 even DivX movies too. The another big feature of mplayer is the wide range
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
10 of supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib,
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
11 fbdev, but you can use SDL (and this way all drivers of SDL) and some
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
12 lowlevel card-specific drivers (for Matrox/3dfx/SiS) too! Most of them
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
13 supports software or hardware scaling, so you can enjoy movies in fullscreen.
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
14 And what about the nice big antialiased shaded subtitles (.sub files) and OSD?
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
15
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
16 History:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
17 ~~~~~~~~
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
18 Yes. Yet another movie player for linux.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
19 What is the special with this? It works, at least for me :)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
20 I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN,
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
21 xine,xanim,avifile,xmmp) but they all have some problem. Mostly with
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
22 special files or with audio/video sync. Most of them is unable to play
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
23 both mpeg1, mpeg2 and avi (DivX) files. Many players have image quality
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
24 or speed problems too. So I've decided to write/modify one...
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
25
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
26 - mpg12play v0.1-v0.3:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
27 The first try, hacked together in a half hour!
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
28 I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3,
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
29 but there were image quality and speed problems with it.
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
30 - mpg12play v0.5-v0.87:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
31 Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff,
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
32 but it was slow and was written in C++ (I hate C++!!!)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
33 - mpg12play v0.9-v0.95pre5:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
34 Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse.
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
35 It's great, optimized very fast C code with perfect image quality and
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
36 100% mpeg standard conformance.
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
37 - MPlayer v0.3-v0.9:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
38 It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
39 player 'avip' based on avifile's Win32 DLL loader.
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
40 - MPlayer v0.10:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
41 The mpeg and avi player in a single binary!
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
42 - MPlayer v0.11:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
43 Added .asf file support, and OpenDivX (see www.projectmayo.com) en/decoding.
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
44 - MPlayer v0.17 "The IdegCounter"
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
45 The release version of the 0.11pre after 4 months of heavy development!
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
46 Try it, and be amazed! Thousands of new features added... and of course
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
47 old code was improved too, bugs removed etc.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
48
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
49 As you see, I didn't write any codecs, just some players. But I spent
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
50 a lot of time finding the best way to parse bad damaged input files
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
51 (both mpg and avi) and to do perfect A-V sync with seeking ability.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
52 My player is rock solid playing damaged mpeg files (useful for some VCDs),
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
53 and it plays bad AVI files which are unplayable with the famous
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
54 windows media player. Even AVI files without index chunk are playable!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
55 As you see, stability and quality are the most important things for me,
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
56 speed has lower priority, but is still very important.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
57
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
58 What about the GUI?
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
59 ~~~~~~~~~~~~~~~~~~~
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
60 I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
61 So the player has only keyboard control from the controlling console/xterm now.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
62 But there is a GUI development for the player, coordinated by Pontscho/Fresh!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
63 It's still under development, but it will be merged and released soon.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
64 BTW he needs some nice skins, if you are a good graphician, contact him!!!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
65
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
66 Supported input formats:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
67 ~~~~~~~~~~~~~~~~~~~~~~~~
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
68 - VCD (Video CD) directly from CD-ROM or from CDRwin's .bin image file
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
69 - DVD, directly from your DVD disk, using optional libcss for decryption
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
70 - MPEG 1/2 System Stream (PS/PES/VOB) and Elementary Stream (ES) file formats
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
71 - RIFF AVI file format
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
72 - ASF 1.0 file format
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
73
352
94b8455bf69c Sok changes.
gabucino
parents: 281
diff changeset
74 Supported audio & video codecs:
94b8455bf69c Sok changes.
gabucino
parents: 281
diff changeset
75 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
76 *** See DOCS/CODECS for the complete list! ***
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
77
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
78 The most important video codecs:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
79 - mpeg1 (VCD) and mpeg2 (DVD) video
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
80 - DivX, OpenDivX and other MPEG4 variants
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
81 - Windows Media Video 7 (WMV1) used in .wmv files
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
82 - Intel Indeo codecs (3.1,3.2,4.1,5.0)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
83 - MJPEG, ASV2 and other hardware formats
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
84
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
85 The most important audio codecs:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
86 - mpeg layer 2, and layer 3 (MP3) audio
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
87 - AC3 dolby audio
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
88 - alaw, msgsm, pcm and other simple old audio formats
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
89
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
90 Supported video output devices:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
91 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
92 General:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
93 - x11: X11 with SHM extension
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
94 - xv: X11 using overlays with the Xvideo extension (hardware YUV & scaling)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
95 - gl: OpenGL renderer, works only with Utah-GLX! (no DRI or nVidia drivers)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
96 - dga: X11 DGA extension
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
97 - fsdga:X11 DGA extension with fullscreen scaling (only 24/32bpp and MPEG!)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
98 - fbdev:Output to general framebuffers
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
99 - svga: Output to SVGAlib
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
100 - sdl: SDL >= v1.1.7 driver (supports software scaling, and versions >=1.1.8
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
101 even support Xvideo, thus hardware rendering)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
102
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
103 Card specific:
96
2c04d6650bc9 very much changes
gabucino
parents: 70
diff changeset
104 - mga: Matrox G200/G400 hardware YUV overlay via the mga_vid device
2c04d6650bc9 very much changes
gabucino
parents: 70
diff changeset
105 - xmga: Matrox G200/G400 overlay (mga_vid) in X11 window
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
106 (Xv emulation on X 3.3.x !)
352
94b8455bf69c Sok changes.
gabucino
parents: 281
diff changeset
107 - syncfb: Matrox G400 YUV support on framebuffer (not tested, maybe broken)
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
108 - 3dfx: Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe broken)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
109
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
110 Special:
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
111 - png: PNG files output (use -z switch to set compression)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
112 - pgm: PGM files output (for testing purposes)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
113 - md5: MD5sum output (for mpeg conformance tests)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
114 - odivx:OpenDivX AVI File writer (use -br to set encoding bitrate)
352
94b8455bf69c Sok changes.
gabucino
parents: 281
diff changeset
115 - null: Null output (for speed tests/benchmarking)
96
2c04d6650bc9 very much changes
gabucino
parents: 70
diff changeset
116
281
6c3a2c2c966d big review
gabucino
parents: 228
diff changeset
117 NOTE: check DOCS/VIDEOCARDS !
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
118
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
119 Supported audio output devices:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
120 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
121 - OSS driver
281
6c3a2c2c966d big review
gabucino
parents: 228
diff changeset
122 - ALSA driver with OSS emulation (NOT recommended, causes annoying delays)
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
123 - ESD with the esddsp utility (not tested, not recommended, see ALSA)
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
124
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
125 NOTE: check DOCS/SOUNDCARDS for details!
96
2c04d6650bc9 very much changes
gabucino
parents: 70
diff changeset
126
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
127 Speed:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
128 ~~~~~~
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
129 Most of time-critical parts are optimized for MMX/MMXext/SSE/3DNow!.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
130 You can improve rendering speed by setting up MTRR registers, see doc in MTRR.
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
131 Some *old* benchmark results can be found in the doc file SPEED.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
132
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
133 Usage:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
134 ~~~~~~
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
135 mplayer [options] [-vo driver] [path/]filename
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
136
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
137 Options:
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
138 see `mplayer -h' for options
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
139 see `mplayer -vo help' for list of available output drivers
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
140
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
141 Keys:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
142 <- or -> seek backward/forward 10 seconds
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
143 up or down seek backward/forward 1 minute
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
144 p or SPACE pause movie (press any key to continue)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
145 q or ^C stop playing and quit program
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
146 o toggle OSD : none / seek / seek+timer
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
147 / and * decrease/increase volume
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
148 m toggle using master/pcm channel for volume setting
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
149
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
150 Examples:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
151 mplayer -vo x11 /mnt/Films/Contact/contact2.mpg
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
152 mplayer -afm 3 /mnt/DVDtrailers/alien4.vob
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
153 mplayer -vcd 2 /dev/cdrom
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
154 mplayer -dvd /dev/dvd /mnt/dvd/matrix.vob
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
155 mplayer -alsa -abs 65536 -delay -0.4 -nobps ~/movies/test.avi
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
156
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
157 Note: in order to use Matrox YUV driver (-vo mga or xmga), first you'll have
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
158 to load the driver: insmod drivers/mga_vid.o , or to make it automatic
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
159 insert the following line at the end of /etc/modules.conf:
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
160 alias char-major-178 mga_vid
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
161 and run 'depmod -a' .
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
162
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
163 License:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
164 ~~~~~~~~
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
165 Since MPlayer incorporates a lot of code from other projects, this isn't
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
166 decided yet. We're going for GPL (will be pretty hard, though).
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
167
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
168 TV output:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
169 ~~~~~~~~~~
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
170 If you have a Matrox G400 Dual-Head card, you can watch movies on TV,
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
171 using TV-out feature of the second head. You must have matroxfb support
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
172 enabled in your kernel (2.4.x kernels). You don't need X11 for this!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
173 Tested only with PAL TV!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
174
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
175 cd TVout
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
176 ./modules
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
177 ./cloning or ./independ
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
178 ./TV-704x528 (or another TV* script)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
179
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
180 Sending bugreports:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
181 ~~~~~~~~~~~~~~~~~~~
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
182 First please read all the docs in this package, most of the problems are
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
183 described somewhere. At least read the Troubleshooting section!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
184 We don't like answering questions which are already answered in this
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
185 readme or other docs.
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
186 You should try the latest development version (from CVS) too, maybe your bug
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
187 is already fixed, but the new version hasn't been released.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
188 If you couldn't solve the problem, then send a quality bugreport
40
2fed43f60181 New data on mailing lists
gabucino
parents: 20
diff changeset
189 via E-Mail to the MPlayer-users list : mplayer-users@lists.sourceforge.net
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
190
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
191 *NEVER* send attached AVIs, MPEGs, or any big files to this list or private!!!
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
192 Upload them to ftp://thot.banki.hu/incoming/MPlayer/ , and inform the list
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
193 about your upload.
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
194
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
195 Please include these:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
196 - your kernel version number ('uname -a')
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
197 - linux distribution and glibc version (example: Slackware 7.1 + glibc 2.1.3)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
198 - gcc and binutils version ('gcc -v' and 'as --version')
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
199 - your X11 version (example: X 4.0.2 + DRI snapshot2001jan12)
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
200 - video card vendor/model (example: Matrox G400 DH MAX AGP)
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
201 - sound card model+driver (example: Creative SBLive! with OSS (kernel) )
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
202 - CPU vendor and type (example: Intel Celeron2-566 at 850MHz)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
203
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
204 Also include the required logs (as attachment, may be compressed zip/gz/bz2)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
205 depending the problem type (see bellow at Troubleshooting section).
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
206 Do not send level-0 logs, always use the mplayer option '-v' when making log:
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
207
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
208 ./configure &>configure.log
540
4d0ad0f6b7dc some updates, not finished yet
arpi_esp
parents: 532
diff changeset
209 make &>make.log
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
210 mplayer -v test.avi &>play.log
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
211
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
212 If we ask you for the file, then you have two choices:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
213 - upload the file to ftp://thot.banki.hu/incoming (at least a few megabytes)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
214 - send the exact URL of the file, and we'll download it soon.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
215
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
216 Please do not ask for features already listed in the TODO!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
217
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
218 Troubleshooting:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
219 ~~~~~~~~~~~~~~~~
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
220 1. Please read the docs first...
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
221
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
222 2. If you have compiling problems:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
223 - if you are an experienced programmer, please try to fix it, and send
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
224 us the patch
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
225 - if gcc reports problems around inttypes.h, try to copy DOCS/inttypes.h
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
226 to the directory where the error occured. (or upgrade glibc to 2.1/newer)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
227 - if gcc reports problems around video_out_gl.c, try disabling OpenGL
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
228 support: ./configure --disable-gl (you have broken OpenGL headers/libs)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
229 - if you are a user, send us a bugreport (see above), including these:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
230 - output of ./configure
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
231 - output of make
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
232 - config.h and all of config.mak files
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
233 Note: many users reported that SSE was not detected while running on P3.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
234 Current stable 2.2.x kernels does NOT support SSE, so you can't use it
6
7465ff4ad354 *** empty log message ***
gabucino
parents: 1
diff changeset
235 without patches or using the 2.4.x series. (or try latest 2.2.19 or newer)
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
236
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
237 3. If you have a problem with the player, please run it with -v option, and
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
238 send the output of it, with a detailed description of the problem.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
239 - can't play AVI files: check that codec .DLL and .ACM files are installed to
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
240 /usr/lib/win32/ and are all lowercase (divxc32.dll instead of DivXc32.DLL)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
241
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
242 4. If you have a file-specific problem (can't play a special file,
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
243 crashes with it or similar) then please run with -v -v -v (debug level 3).
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
244 Send us the output and the problem description via email bugreport.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
245 We may ask you to upload the file.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
246 - if it segfaults with an AVI file with MP3 audio, try with -afm 1 or -afm 4
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
247 - if it's still bad, try with -nosound
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
248
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
249 5. If you have problem with display driver, please first check the list above,
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
250 many of them isn't yet capable to AVI playing, and some of them are
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
251 untested and/or unfinished.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
252
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
253 6. If you have speed problems (too slow playing), then please first check that:
281
6c3a2c2c966d big review
gabucino
parents: 228
diff changeset
254 - you don't use OpenGL driver while have software-only opengl (Utah-GLX
6c3a2c2c966d big review
gabucino
parents: 228
diff changeset
255 disabled, or not yet installed, conflicting libs installed, or your
6c3a2c2c966d big review
gabucino
parents: 228
diff changeset
256 hardware not supported etc...)
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
257 - you have set up MTRR registers properly (many new cards are really
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
258 slow without setting up MTRR registers. it's NOT done by X 3.3.x! Also,
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
259 there are older K6-2's, which lack MTRR support /stepping=0/).
281
6c3a2c2c966d big review
gabucino
parents: 228
diff changeset
260 Check DOCS/MTRR !
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
261 - you have a fast machine (don't report that your 386 can't play DivX)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
262 - try with Null output (-vo null) and check CPU usage (first % value)
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
263
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
264 7. sound-related problems:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
265 - maybe your card doesn't support 48kHz playback and the movie requires it.
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
266 - try MPlayer with the -noalsa option
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
267 - compile MPlayer with --disable-select
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
268 - delayed audio with some AVI files: try with -bps or -nobps option!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
269 - if you experienced delayed audio, try to compensate with -delay or -abs.
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
270 you can specify audio card's buffer size in bytes with -abs option, or
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
271 specify audio delay in seconds (positive/negative float) with -delay
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
272 for example: mplayer -alsa -delay -0.75 test.avi
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
273 mplayer -abs 65536 -delay 0.3 test.mpg
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
274 - to play AVI files with VBR MP3 audio use the -mc 0 option!
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
275 - no sound at all: check that you have working OSS driver (/dev/dsp),
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
276 and it isn't used by another program (for example esd, xmms etc.)
281
6c3a2c2c966d big review
gabucino
parents: 228
diff changeset
277 - use OSS. If the problem persists, use ALSA ;)
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
278
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
279 8. unsupported codecs (AVI files):
281
6c3a2c2c966d big review
gabucino
parents: 228
diff changeset
280 Check DOCS/CODECS
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
281
6
7465ff4ad354 *** empty log message ***
gabucino
parents: 1
diff changeset
282 Contact information:
7465ff4ad354 *** empty log message ***
gabucino
parents: 1
diff changeset
283 ~~~~~~~~~~~~~~~~~~~~
10
ab921a7ef863 Updated links
gabucino
parents: 9
diff changeset
284 Homepage: http://mplayer.sourceforge.net
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
285
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
286 Mailing lists:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
287 ~~~~~~~~~~~~~~
107
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
288 There are some public mailing lists on MPlayer. Subscribing can be achieved on
40
2fed43f60181 New data on mailing lists
gabucino
parents: 20
diff changeset
289 the following addresses:
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
290
107
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
291 - MPlayer users list: (send your ideas, bugreports, feature requests here)
60
434a367c673d MPlayer-Matrox list added
gabucino
parents: 40
diff changeset
292 http://lists.sourceforge.net/lists/listinfo/mplayer-users
107
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
293
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
294 - MPlayer announce: (information about new releases or big changes in CVS)
60
434a367c673d MPlayer-Matrox list added
gabucino
parents: 40
diff changeset
295 http://lists.sourceforge.net/lists/listinfo/mplayer-announce
107
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
296
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
297 - MPlayer & Matrox G200/G400/G450 users: (about TV-out, mga_vid, syncfb, Xv)
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
298 http://lists.sourceforge.net/lists/listinfo/mplayer-matrox
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
299
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
300 - MPlayer CVS-log: (announce about _every_ CVS commit)
107
845cef1a5ba0 mailing lists updated
arpi_esp
parents: 96
diff changeset
301 http://lists.sourceforge.net/lists/listinfo/mplayer-cvslog
1
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
302
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
303 Standard Disclaimer:
3b5f5d1c5041 Initial revision
arpi_esp
parents:
diff changeset
304 ~~~~~~~~~~~~~~~~~~~~
522
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
305 Use only at your own risk! There may be errors and inaccuracies that could
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
306 damage your system or your eye. Proceed with caution, and although this is
b63c485a530d reviewed for release
gabucino
parents: 389
diff changeset
307 highly unlikely, we don't take any responsibility for that!