mirror of
https://github.com/mpv-player/mpv
synced 2025-03-20 02:09:52 +00:00
685bbb5734
The XML documentation was badly outdated, with various obsolete, useless and and sometimes actively harmful advice. Delete a lot of the obsolete stuff, without spending much effort to replace it for now. In the FAQ section I removed some questions completely; in other cases I only removed the answer if I thought the entry might be worth keeping but the answer would need to be updated.
627 lines
18 KiB
XML
627 lines
18 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<chapter id="faq" xreflabel="FAQ">
|
|
<title>Frequently Asked Questions</title>
|
|
|
|
<qandaset defaultlabel="qanda">
|
|
|
|
<qandadiv id="faq-development">
|
|
<title>Development</title>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How do I create a proper patch for <application>MPlayer</application>?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How do I translate <application>MPlayer</application> to a new language?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I support <application>MPlayer</application> development?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I become an <application>MPlayer</application> developer?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
Why don't you use autoconf/automake?
|
|
</para></question>
|
|
<answer><para>
|
|
We have a modular, handwritten build system. It does a reasonably good
|
|
job, so why change? Besides, we dislike the auto* tools, just like
|
|
<ulink url="http://freshmeat.net/articles/view/889/">other people</ulink>.
|
|
</para></answer>
|
|
</qandaentry>
|
|
</qandadiv>
|
|
|
|
<!-- ********** -->
|
|
|
|
<qandadiv id="faq-compilation-installation">
|
|
<title>Compilation and installation</title>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
Compilation fails with an error and <application>gcc</application> bails out
|
|
with some cryptic message containing the phrase
|
|
<systemitem>internal compiler error</systemitem> or
|
|
<systemitem>unable to find a register to spill</systemitem> or
|
|
<systemitem>can't find a register in class `GENERAL_REGS'
|
|
while reloading `asm'</systemitem>.
|
|
</para></question>
|
|
<answer><para>
|
|
You have stumbled over a bug in <application>gcc</application>. Please
|
|
<ulink url="http://gcc.gnu.org/bugs.html">report it to the gcc team</ulink>
|
|
but not to us. For some reason <application>MPlayer</application> seems to
|
|
trigger compiler bugs frequently. Nevertheless we cannot fix them and do not
|
|
add workarounds for compiler bugs to our sources. To avoid this problem,
|
|
either stick with a compiler version that is known to be reliable and
|
|
stable, or upgrade frequently.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
Are there binary (RPM/Debian) packages of <application>MPlayer</application>?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I build a 32 bit <application>MPlayer</application> on a 64 bit Athlon?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
During 'make', <application>MPlayer</application> complains about
|
|
missing X11 libraries. I don't understand, I <emphasis>do</emphasis>
|
|
have X11 installed!?
|
|
</para></question>
|
|
<answer><para>
|
|
... but you don't have the X11 development package installed. Or not correctly.
|
|
It's called <filename>XFree86-devel*</filename> under Red Hat,
|
|
<filename>xlibs-dev</filename> under Debian Woody and
|
|
<filename>libx11-dev</filename> under Debian Sarge. Also check if the
|
|
<filename class="directory">/usr/X11</filename> and
|
|
<filename class="directory">/usr/include/X11</filename> symlinks exist.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
</qandadiv>
|
|
|
|
<!-- ********** -->
|
|
|
|
<qandadiv id="faq-general">
|
|
<title>General questions</title>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
Are there any mailing lists on <application>MPlayer</application>?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I've found a nasty bug when I tried to play my favorite video!
|
|
Who should I inform?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I make a screenshot?
|
|
</para></question>
|
|
<answer><para>
|
|
You have to use a video output driver that does not employ an overlay to be
|
|
able to take a screenshot. Under X11, <option>-vo x11</option> will do, under
|
|
Windows <option>-vo directx:noaccel</option> works.
|
|
</para>
|
|
<para>
|
|
Alternatively you can run <application>MPlayer</application> with the
|
|
<systemitem>screenshot</systemitem> video filter
|
|
(<option>-vf screenshot</option>), and press the <keycap>s</keycap>
|
|
key to grab a screenshot.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
What is the meaning of the numbers on the status line?
|
|
</para></question>
|
|
<answer><para>
|
|
Example:
|
|
<screen>
|
|
A: 2.1 V: 2.2 A-V: -0.167 ct: 0.042 57/57 41% 0% 2.6% 0 4 49% 1.00x
|
|
</screen>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><systemitem>A: 2.1</systemitem></term>
|
|
<listitem><para>audio position in seconds</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>V: 2.2</systemitem></term>
|
|
<listitem><para>video position in seconds</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>A-V: -0.167</systemitem></term>
|
|
<listitem><para>audio-video difference in seconds (delay)</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>ct: 0.042</systemitem></term>
|
|
<listitem><para>total A-V sync correction done</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>57/57</systemitem></term>
|
|
<listitem><para>
|
|
frames played/decoded (counting from last seek)
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>41%</systemitem></term>
|
|
<listitem><para>
|
|
video codec CPU usage in percent
|
|
(for slice rendering and direct rendering this includes video_out)
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>0%</systemitem></term>
|
|
<listitem><para>video_out CPU usage</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>2.6%</systemitem></term>
|
|
<listitem><para>audio codec CPU usage in percent</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>0</systemitem></term>
|
|
<listitem><para>frames dropped to maintain A-V sync</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>4</systemitem></term>
|
|
<listitem><para>
|
|
current level of image postprocessing (when using <option>-autoq</option>)
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>49%</systemitem></term>
|
|
<listitem><para>
|
|
current cache size used (around 50% is normal)
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><systemitem>1.00x</systemitem></term>
|
|
<listitem><para>playback speed as a factor of original speed</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
Most of them are for debug purposes, use the <option>-quiet</option>
|
|
option to make them disappear.
|
|
You might notice that video_out CPU usage is zero (0%) for some files.
|
|
This is because it is called directly from the codec and thus cannot
|
|
be measured separately. If you wish to know the video_out speed, compare
|
|
the difference when playing the file with <option>-vo null</option> and
|
|
your usual video output driver.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
There are error messages about file not found
|
|
<filename>/usr/local/lib/codecs/</filename> ...
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I make <application>MPlayer</application> remember the options I
|
|
use for a particular file, e.g. <filename>movie.avi</filename>?
|
|
</para></question>
|
|
<answer><para>
|
|
Create a file named <filename>movie.avi.conf</filename> with the file-specific
|
|
options in it and put it in <filename class="directory">~/.mplayer</filename>.
|
|
Also see the manpage about <option>-use-filedir-conf</option>.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I run <application>MPlayer</application> in the background?
|
|
</para></question>
|
|
<answer><para>
|
|
Use:
|
|
<screen>
|
|
OUTDATED CONTENT REMOVED
|
|
</screen>
|
|
</para></answer>
|
|
</qandaentry>
|
|
</qandadiv>
|
|
|
|
<!-- ********** -->
|
|
|
|
<qandadiv id="faq-playback">
|
|
<title>Playback problems</title>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I cannot pinpoint the cause of some strange playback problem.
|
|
</para></question>
|
|
<answer><para>
|
|
Do you have a stray <filename>codecs.conf</filename> file in
|
|
<filename>~/.mplayer/</filename>, <filename>/etc/</filename>,
|
|
<filename>/usr/local/etc/</filename> or a similar location? Remove it,
|
|
an outdated <filename>codecs.conf</filename> file can cause obscure
|
|
problems and is intended for use only by developers working on codec
|
|
support. It overrides <application>MPlayer</application>'s internal
|
|
codec settings, which will wreak havoc if incompatible changes are
|
|
made in newer program versions. Unless used by experts it is a recipe
|
|
for disaster in the form of seemingly random and very hard to localize
|
|
crashes and playback problems. If you still have it somewhere on your
|
|
system, you should remove it now.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I get subtitles to appear on the black margins around a movie?
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I select audio/subtitle tracks from a DVD, OGM, Matroska or NUT file?
|
|
</para></question>
|
|
<answer><para>
|
|
You have to use <option>-aid</option> (audio ID) or <option>-alang</option>
|
|
(audio language), <option>-sid</option>(subtitle ID) or <option>-slang</option>
|
|
(subtitle language), for example:
|
|
<screen>
|
|
mplayer -alang eng -slang eng <replaceable>example.mkv</replaceable>
|
|
mplayer -aid 1 -sid 1 <replaceable>example.mkv</replaceable>
|
|
</screen>
|
|
To see which ones are available:
|
|
<screen>
|
|
mplayer -vo null -ao null -frames 0 -v <replaceable>filename</replaceable> | grep sid
|
|
mplayer -vo null -ao null -frames 0 -v <replaceable>filename</replaceable> | grep aid
|
|
</screen>
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I downloaded a movie off a P2P network and it doesn't work!
|
|
</para></question>
|
|
<answer><para>
|
|
Your file is most probably broken or a fake file. If you got it from
|
|
a friend, and he says it works, try comparing
|
|
<application>md5sum</application> hashes.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I'm having trouble getting my subtitles to display, help!!
|
|
</para></question>
|
|
<answer><para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
<application>MPlayer</application> dies with
|
|
<screen>MPlayer interrupted by signal 4 in module: decode_video</screen>
|
|
</para></question>
|
|
<answer><para>
|
|
Don't use <application>MPlayer</application> on a CPU different from the one
|
|
it was compiled on or recompile with runtime CPU detection
|
|
OUTDATED CONTENT REMOVED
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
When I try to grab from my tuner, it works, but colors are strange.
|
|
It's OK with other applications.
|
|
</para></question>
|
|
<answer><para>
|
|
Your card probably reports some colorspaces as supported when in fact
|
|
it does not support them. Try with YUY2 instead of the
|
|
default YV12 (see the <link linkend="tv-input">TV</link> section).
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
While playing a movie it suddenly gets jerky and I get the following message:
|
|
<screen>Badly interleaved AVI file detected - switching to -ni mode...</screen>
|
|
</para></question>
|
|
<answer><para>
|
|
Badly interleaved files and <option>-cache</option> don't work well together.
|
|
Try <option>-nocache</option>.
|
|
</para></answer>
|
|
</qandaentry>
|
|
</qandadiv>
|
|
|
|
<!-- ********** -->
|
|
|
|
<qandadiv id="faq-driver">
|
|
<title>Video/audio driver problems (vo/ao)</title>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
When I go into fullscreen mode I just get black borders around the image
|
|
and no real scaling to fullscreen mode.
|
|
</para></question>
|
|
<answer><para>
|
|
Your video output driver does not support scaling in hardware and since
|
|
scaling in software can be incredibly slow <application>MPlayer</application>
|
|
does not automatically enable it. Most likely you are using the
|
|
<systemitem>x11</systemitem> instead of the <systemitem>xv</systemitem>
|
|
video output driver. Try adding <option>-vo xv</option> to the command
|
|
line or read the <link linkend="video">video section</link> to find out
|
|
about alternative video output drivers. The <option>-zoom</option>
|
|
option explicitly enables software scaling.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I've just installed <application>MPlayer</application>. When I want to
|
|
open a video file it causes a fatal error:
|
|
<screen>Error opening/initializing the selected video_out (-vo) device.</screen>
|
|
How can I solve my problem?
|
|
</para></question>
|
|
<answer><para>
|
|
Just change your video output device. Issue the following command to get
|
|
a list of available video output drivers:
|
|
<screen>mplayer -vo help</screen>
|
|
After you've chosen the correct video output driver, add it to
|
|
your configuration file. Add
|
|
<programlisting>
|
|
vo = <replaceable>selected_vo</replaceable>
|
|
</programlisting>
|
|
to <filename>~/.mplayer/config</filename>
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I have problems with <replaceable>[your window manager]</replaceable>
|
|
and fullscreen xv/xmga/sdl/x11 modes ...
|
|
</para></question>
|
|
<answer><para>
|
|
Read the <link linkend="bugreports">bug reporting guidelines</link> and send us
|
|
a proper bug report.
|
|
Also try experimenting with the <option>-fstype</option> option.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I use <application>dmix</application> with
|
|
<application>MPlayer</application>?
|
|
</para></question>
|
|
<answer><para>
|
|
After setting up your
|
|
<ulink url="http://alsa.opensrc.org/index.php?page=DmixPlugin">asoundrc</ulink>
|
|
you have to use <option>-ao alsa:device=dmix</option>.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I have no sound when playing a video and get error messages similar to this one:
|
|
<screen>
|
|
AO: [oss] 44100Hz 2ch Signed 16-bit (Little-Endian)
|
|
[AO OSS] audio_setup: Can't open audio device /dev/dsp: Device or resource busy
|
|
Could not open/initialize audio device -> no sound.
|
|
Audio: no sound
|
|
Starting playback...
|
|
</screen>
|
|
</para></question>
|
|
<answer><para>
|
|
Are you running KDE or GNOME with the aRts or ESD sound daemon? Try disabling
|
|
the sound daemon or use the <option>-ao arts</option> or
|
|
<option>-ao esd</option> option to make <application>MPlayer</application> use
|
|
aRts or ESD.
|
|
You might also be running ALSA without OSS emulation, try loading the ALSA OSS
|
|
kernel modules or add <option>-ao alsa</option> to your command line to
|
|
directly use the ALSA audio output driver.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
When starting <application>MPlayer</application> under KDE I just get a black
|
|
screen and nothing happens. After about one minute the video starts playing.
|
|
</para></question>
|
|
<answer><para>
|
|
The KDE aRts sound daemon is blocking the sound device. Either wait until the
|
|
video starts or disable the aRts daemon in control center. If you want to use
|
|
aRts sound, specify audio output via our native aRts audio driver
|
|
(<option>-ao arts</option>). If it fails or isn't compiled in, try SDL
|
|
(<option>-ao sdl</option>) and make sure your SDL can handle aRts sound. Yet
|
|
another option is to start <application>MPlayer</application> with artsdsp.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I have A/V sync problems.
|
|
Some of my AVIs play fine, but some play with double speed!
|
|
</para></question>
|
|
<answer><para>
|
|
You have a buggy sound card/driver. Most likely it's fixed at 44100Hz, and you
|
|
try to play a file which has 22050Hz audio. Try the
|
|
<systemitem>resample</systemitem> audio filter.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I get rid of A/V desynchronization
|
|
while seeking through RealMedia streams?
|
|
</para></question>
|
|
<answer><para>
|
|
<option>-mc 0.1</option> can help.
|
|
</para></answer>
|
|
</qandaentry>
|
|
</qandadiv>
|
|
|
|
<!-- ********** -->
|
|
|
|
<qandadiv id="faq-dvd">
|
|
<title>DVD playback</title>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
What about DVD navigation/menus?
|
|
</para></question>
|
|
<answer><para>
|
|
<application>MPlayer</application> should support DVD menus nowadays.
|
|
Your mileage may vary.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
What about subtitles? Can <application>MPlayer</application> display them?
|
|
</para></question>
|
|
<answer><para>
|
|
Yes. See the <link linkend="dvd">DVD chapter</link>.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
How can I set the region code of my DVD-drive? I don't have Windows!
|
|
</para></question>
|
|
<answer><para>
|
|
Use the
|
|
<ulink url="http://linvdr.org/projects/regionset/">regionset tool</ulink>.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I can't play a DVD, MPlayer hangs or outputs "Encrypted VOB file!" errors.
|
|
</para></question>
|
|
<answer><para>
|
|
CSS decryption code does not work with some DVD drives unless you set
|
|
the region code appropriately. See the answer to the previous question.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
Do I need to be (setuid) root to be able to play a DVD?
|
|
</para></question>
|
|
<answer><para>
|
|
No. However you must have the proper rights
|
|
on the DVD device entry (in <filename class="directory">/dev/</filename>).
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
Is it possible to play/encode only selected chapters?
|
|
</para></question>
|
|
<answer><para>
|
|
Yes, try the <option>-chapter</option> option.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
My DVD playback is sluggish!
|
|
</para></question>
|
|
<answer><para>
|
|
Use the <option>-cache</option> option (described in the man page) and try
|
|
enabling DMA for the DVD drive with the <command>hdparm</command> tool.
|
|
</para></answer>
|
|
</qandaentry>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I copied a DVD using vobcopy. How do I play/encode it from my hard disk?
|
|
</para></question>
|
|
<answer><para>
|
|
Use the <option>-dvd-device</option> option to refer to the directory
|
|
that contains the files:
|
|
<screen>
|
|
mplayer dvd://1 -dvd-device <replaceable>/path/to/directory</replaceable>
|
|
</screen>
|
|
</para></answer>
|
|
</qandaentry>
|
|
</qandadiv>
|
|
|
|
|
|
<qandadiv id="faq-features">
|
|
<title>Feature requests</title>
|
|
|
|
<qandaentry>
|
|
<question><para>
|
|
I'd like to seek +/- 1 frame instead of 10 seconds.
|
|
</para></question>
|
|
<answer><para>
|
|
You can step forward one frame by pressing <keycap>.</keycap>.
|
|
If the movie was not paused it will be paused afterwards
|
|
(see the man page for details).
|
|
Stepping backwards is not currently implemented, but note that you can make
|
|
small seeks using the <option>-hr-seek</option> functionality.
|
|
</para></answer>
|
|
</qandaentry>
|
|
</qandadiv>
|
|
|
|
<!-- ********** -->
|
|
|
|
<qandadiv id="faq-encoding">
|
|
<title>Encoding</title>
|
|
|
|
<para>
|
|
OUTDATED CONTENT REMOVED
|
|
</para>
|
|
</qandadiv>
|
|
|
|
</qandaset>
|
|
|
|
</chapter>
|