manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
AUDIO OUTPUT DRIVERS
|
|
|
|
|
====================
|
|
|
|
|
|
|
|
|
|
Audio output drivers are interfaces to different audio output facilities. The
|
|
|
|
|
syntax is:
|
|
|
|
|
|
2016-09-07 10:55:21 +00:00
|
|
|
``--ao=<driver1,driver2,...[,]>``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Specify a priority list of audio output drivers to be used.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
If the list has a trailing ',', mpv will fall back on drivers not contained
|
2016-09-07 10:55:21 +00:00
|
|
|
in the list.
|
2013-11-30 23:12:10 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
.. note::
|
|
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
See ``--ao=help`` for a list of compiled-in audio output drivers. The
|
|
|
|
|
driver ``--ao=alsa`` is preferred. ``--ao=pulse`` is preferred on systems
|
2016-01-06 12:48:43 +00:00
|
|
|
where PulseAudio is used. On BSD systems, ``--ao=oss`` or ``--ao=sndio``
|
|
|
|
|
may work (the latter being experimental).
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
|
|
|
|
Available audio output drivers are:
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``alsa`` (Linux only)
|
ao_alsa: disable ALSA resampling by default again
This partially reverts commit 7d152965. It turns out that at least some
ALSA drivers (at least snd-hda-intel) report incorrect audio delay with
non-native sample rates, even if the sample rate is only very slightly
different from the native one.
For example, 48000Hz is fine on my hda-intel system, while both 8000Hz
and 47999Hz lead to a delay off by 40ms (according to mpv's A/V
difference display), which suggests that something in ALSA is
calculating the delay using the wrong sample rate.
As an additional problem, with ALSA resampling enabled, using
48001Hz/float/2ch fails, while 49000Hz/float/2ch or 48001Hz/s16/2ch
work. With resampling disabled, all these cases work obviously, because
our own resampler doesn't just refuse any of these formats.
Since some people want to use the ALSA resampler (because it's highly
configurable, supports multiple backends, etc.), we still allow enabling
ALSA resampling with an ao_alsa suboption.
2013-11-29 14:43:39 +00:00
|
|
|
ALSA audio output driver
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
See `ALSA audio output options`_ for options specific to this AO.
|
|
|
|
|
|
2014-12-15 16:14:23 +00:00
|
|
|
.. warning::
|
|
|
|
|
|
2016-09-02 18:07:25 +00:00
|
|
|
To get multichannel/surround audio, use ``--audio-channels=auto``. The
|
2017-12-27 17:58:14 +00:00
|
|
|
default for this option is ``auto-safe``, which makes this audio output
|
2016-09-02 18:07:25 +00:00
|
|
|
explicitly reject multichannel output, as there is no way to detect
|
|
|
|
|
whether a certain channel layout is actually supported.
|
2014-12-15 16:14:23 +00:00
|
|
|
|
2015-04-24 01:27:50 +00:00
|
|
|
You can also try `using the upmix plugin <http://git.io/vfuAy>`_.
|
|
|
|
|
This setup enables multichannel audio on the ``default`` device
|
|
|
|
|
with automatic upmixing with shared access, so playing stereo
|
|
|
|
|
and multichannel audio at the same time will work as expected.
|
2014-12-16 04:11:14 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``oss``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
OSS audio output driver
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this audio output:
|
|
|
|
|
|
|
|
|
|
``--oss-mixer-device``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Sets the audio mixer device (default: ``/dev/mixer``).
|
2016-09-05 19:07:03 +00:00
|
|
|
``--oss-mixer-channel``
|
2013-07-21 21:27:09 +00:00
|
|
|
Sets the audio mixer channel (default: ``pcm``). Other valid values
|
|
|
|
|
include **vol, pcm, line**. For a complete list of options look for
|
|
|
|
|
``SOUND_DEVICE_NAMES`` in ``/usr/include/linux/soundcard.h``.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``jack``
|
2016-09-05 19:04:41 +00:00
|
|
|
JACK (Jack Audio Connection Kit) audio output driver.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2016-09-05 19:04:41 +00:00
|
|
|
The following global options are supported by this audio output:
|
|
|
|
|
|
|
|
|
|
``--jack-port=<name>``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Connects to the ports with the given name (default: physical ports).
|
2016-09-05 19:04:41 +00:00
|
|
|
``--jack-name=<client>``
|
2013-07-21 22:03:57 +00:00
|
|
|
Client name that is passed to JACK (default: ``mpv``). Useful
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
if you want to have certain connections established automatically.
|
2016-09-05 19:04:41 +00:00
|
|
|
``--jack-autostart=<yes|no>``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
Automatically start jackd if necessary (default: disabled). Note that
|
2013-07-08 16:02:14 +00:00
|
|
|
this tends to be unreliable and will flood stdout with server messages.
|
2016-09-05 19:04:41 +00:00
|
|
|
``--jack-connect=<yes|no>``
|
2013-06-03 17:38:04 +00:00
|
|
|
Automatically create connections to output ports (default: enabled).
|
|
|
|
|
When enabled, the maximum number of output channels will be limited to
|
|
|
|
|
the number of available output ports.
|
2016-09-05 19:04:41 +00:00
|
|
|
``--jack-std-channel-layout=<waveext|any>``
|
2015-11-07 14:20:34 +00:00
|
|
|
Select the standard channel layout (default: waveext). JACK itself has no
|
2013-07-07 16:37:55 +00:00
|
|
|
notion of channel layouts (i.e. assigning which speaker a given
|
|
|
|
|
channel is supposed to map to) - it just takes whatever the application
|
|
|
|
|
outputs, and reroutes it to whatever the user defines. This means the
|
2013-07-08 16:02:14 +00:00
|
|
|
user and the application are in charge of dealing with the channel
|
2015-11-07 14:20:34 +00:00
|
|
|
layout. ``waveext`` uses WAVE_FORMAT_EXTENSIBLE order, which, even
|
2013-07-07 16:37:55 +00:00
|
|
|
though it was defined by Microsoft, is the standard on many systems.
|
|
|
|
|
The value ``any`` makes JACK accept whatever comes from the audio
|
|
|
|
|
filter chain, regardless of channel layout and without reordering. This
|
2013-07-08 16:02:14 +00:00
|
|
|
mode is probably not very useful, other than for debugging or when used
|
2013-07-07 16:37:55 +00:00
|
|
|
with fixed setups.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``coreaudio`` (Mac OS X only)
|
2014-10-23 07:50:54 +00:00
|
|
|
Native Mac OS X audio output driver using AudioUnits and the CoreAudio
|
2014-07-02 21:17:07 +00:00
|
|
|
sound server.
|
|
|
|
|
|
2014-10-23 07:50:54 +00:00
|
|
|
Automatically redirects to ``coreaudio_exclusive`` when playing compressed
|
|
|
|
|
formats.
|
2014-07-02 21:17:07 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this audio output:
|
|
|
|
|
|
|
|
|
|
``--coreaudio-change-physical-format=<yes|no>``
|
2015-05-04 23:07:57 +00:00
|
|
|
Change the physical format to one similar to the requested audio format
|
|
|
|
|
(default: no). This has the advantage that multichannel audio output
|
|
|
|
|
will actually work. The disadvantage is that it will change the
|
2015-05-05 12:40:26 +00:00
|
|
|
system-wide audio settings. This is equivalent to changing the ``Format``
|
2015-05-04 23:07:57 +00:00
|
|
|
setting in the ``Audio Devices`` dialog in the ``Audio MIDI Setup``
|
2015-12-19 08:26:27 +00:00
|
|
|
utility. Note that this does not affect the selected speaker setup.
|
2015-05-04 23:07:57 +00:00
|
|
|
|
2017-06-29 10:35:58 +00:00
|
|
|
``--coreaudio-spdif-hack=<yes|no>``
|
|
|
|
|
Try to pass through AC3/DTS data as PCM. This is useful for drivers
|
|
|
|
|
which do not report AC3 support. It converts the AC3 data to float,
|
|
|
|
|
and assumes the driver will do the inverse conversion, which means
|
|
|
|
|
a typical A/V receiver will pick it up as compressed IEC framed AC3
|
|
|
|
|
stream, ignoring that it's marked as PCM. This disables normal AC3
|
|
|
|
|
passthrough (even if the device reports it as supported). Use with
|
|
|
|
|
extreme care.
|
|
|
|
|
|
2016-09-05 19:07:34 +00:00
|
|
|
|
2014-10-23 07:50:54 +00:00
|
|
|
``coreaudio_exclusive`` (Mac OS X only)
|
2014-07-02 21:17:07 +00:00
|
|
|
Native Mac OS X audio output driver using direct device access and
|
|
|
|
|
exclusive mode (bypasses the sound server).
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``openal``
|
2018-04-12 11:57:49 +00:00
|
|
|
OpenAL audio output driver
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2018-04-01 13:26:45 +00:00
|
|
|
``--openal-num-buffers=<2-128>``
|
|
|
|
|
Specify the number of audio buffers to use. Lower values are better for
|
|
|
|
|
lower CPU usage. Default: 4.
|
|
|
|
|
|
|
|
|
|
``--openal-num-samples=<256-32768>``
|
|
|
|
|
Specify the number of complete samples to use for each buffer. Higher
|
|
|
|
|
values are better for lower CPU usage. Default: 8192.
|
|
|
|
|
|
2018-03-28 13:33:38 +00:00
|
|
|
``--openal-direct-channels=<yes|no>``
|
|
|
|
|
Enable OpenAL Soft's direct channel extension when available to avoid
|
|
|
|
|
tinting the sound with ambisonics or HRTF.
|
|
|
|
|
Channels are dropped when when they are not available as downmixing
|
|
|
|
|
will be disabled. Default: no.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``pulse``
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
PulseAudio audio output driver
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this audio output:
|
|
|
|
|
|
2017-04-23 15:51:55 +00:00
|
|
|
``--pulse-host=<host>``
|
|
|
|
|
Specify the host to use. An empty <host> string uses a local connection,
|
|
|
|
|
"localhost" uses network transfer (most likely not what you want).
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--pulse-buffer=<1-2000|native>``
|
2014-01-07 22:50:22 +00:00
|
|
|
Set the audio buffer size in milliseconds. A higher value buffers
|
|
|
|
|
more data, and has a lower probability of buffer underruns. A smaller
|
|
|
|
|
value makes the audio stream react faster, e.g. to playback speed
|
2018-04-05 14:35:53 +00:00
|
|
|
changes.
|
2014-01-07 22:50:22 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--pulse-latency-hacks=<yes|no>``
|
2015-01-07 21:23:38 +00:00
|
|
|
Enable hacks to workaround PulseAudio timing bugs (default: no). If
|
2014-07-26 21:19:14 +00:00
|
|
|
enabled, mpv will do elaborate latency calculations on its own. If
|
|
|
|
|
disabled, it will use PulseAudio automatically updated timing
|
2015-01-07 21:23:38 +00:00
|
|
|
information. Disabling this might help with e.g. networked audio or
|
|
|
|
|
some plugins, while enabling it might help in some unknown situations
|
|
|
|
|
(it used to be required to get good behavior on old PulseAudio versions).
|
|
|
|
|
|
|
|
|
|
If you have stuttering video when using pulse, try to enable this
|
2015-12-19 08:26:27 +00:00
|
|
|
option. (Or try to update PulseAudio.)
|
2014-07-26 21:19:14 +00:00
|
|
|
|
2019-05-05 04:53:41 +00:00
|
|
|
``--pulse-allow-suspended=<yes|no>``
|
|
|
|
|
Allow mpv to use PulseAudio even if the sink is suspended (default: no).
|
|
|
|
|
Can be useful if PulseAudio is running as a bridge to jack and mpv has its sink-input set to the one jack is using.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``sdl``
|
|
|
|
|
SDL 1.2+ audio output driver. Should work on any platform supported by SDL
|
|
|
|
|
1.2, but may require the ``SDL_AUDIODRIVER`` environment variable to be set
|
2012-12-28 07:07:14 +00:00
|
|
|
appropriately for your system.
|
|
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
.. note:: This driver is for compatibility with extremely foreign
|
|
|
|
|
environments, such as systems where none of the other drivers
|
|
|
|
|
are available.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this audio output:
|
|
|
|
|
|
|
|
|
|
``--sdl-buflen=<length>``
|
2013-07-08 16:02:14 +00:00
|
|
|
Sets the audio buffer length in seconds. Is used only as a hint by the
|
|
|
|
|
sound system. Playing a file with ``-v`` will show the requested and
|
|
|
|
|
obtained exact buffer size. A value of 0 selects the sound system
|
|
|
|
|
default.
|
2012-12-28 07:07:14 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--sdl-bufcnt=<count>``
|
2012-12-28 07:07:14 +00:00
|
|
|
Sets the number of extra audio buffers in mpv. Usually needs not be
|
|
|
|
|
changed.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``null``
|
2016-09-07 10:55:21 +00:00
|
|
|
Produces no audio output but maintains video playback speed. You can use
|
|
|
|
|
``--ao=null --ao-null-untimed`` for benchmarking.
|
2013-11-13 18:47:41 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this audio output:
|
|
|
|
|
|
|
|
|
|
``--ao-null-untimed``
|
2013-11-13 18:47:41 +00:00
|
|
|
Do not simulate timing of a perfect audio device. This means audio
|
|
|
|
|
decoding will go as fast as possible, instead of timing it to the
|
|
|
|
|
system clock.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-null-buffer``
|
2013-11-17 15:08:39 +00:00
|
|
|
Simulated buffer length in seconds.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-null-outburst``
|
2013-11-17 15:08:39 +00:00
|
|
|
Simulated chunk size in samples.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-null-speed``
|
2014-03-07 14:24:49 +00:00
|
|
|
Simulated audio playback speed as a multiplier. Usually, a real audio
|
|
|
|
|
device will not go exactly as fast as the system clock. It will deviate
|
2015-12-19 08:26:27 +00:00
|
|
|
just a little, and this option helps to simulate this.
|
2014-03-07 14:24:49 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-null-latency``
|
2014-04-17 20:35:05 +00:00
|
|
|
Simulated device latency. This is additional to EOF.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-null-broken-eof``
|
2014-04-17 20:35:05 +00:00
|
|
|
Simulate broken audio drivers, which always add the fixed device
|
|
|
|
|
latency to the reported audio playback position.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-null-broken-delay``
|
2015-01-30 20:30:54 +00:00
|
|
|
Simulate broken audio drivers, which don't report latency correctly.
|
|
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-null-channel-layouts``
|
2015-04-27 21:18:54 +00:00
|
|
|
If not empty, this is a ``,`` separated list of channel layouts the
|
|
|
|
|
AO allows. This can be used to test channel layout selection.
|
|
|
|
|
|
2018-01-29 05:08:52 +00:00
|
|
|
``--ao-null-format``
|
|
|
|
|
Force the audio output format the AO will accept. If unset accepts any.
|
|
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``pcm``
|
|
|
|
|
Raw PCM/WAVE file writer audio output
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2016-09-05 19:07:03 +00:00
|
|
|
The following global options are supported by this audio output:
|
|
|
|
|
|
|
|
|
|
``--ao-pcm-waveheader=<yes|no>``
|
2013-07-08 16:02:14 +00:00
|
|
|
Include or do not include the WAVE header (default: included). When
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
not included, raw PCM will be generated.
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-pcm-file=<filename>``
|
2013-07-08 16:02:14 +00:00
|
|
|
Write the sound to ``<filename>`` instead of the default
|
|
|
|
|
``audiodump.wav``. If ``no-waveheader`` is specified, the default is
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
``audiodump.pcm``.
|
2016-09-05 19:07:03 +00:00
|
|
|
``--ao-pcm-append=<yes|no>``
|
2015-01-14 21:14:56 +00:00
|
|
|
Append to the file, instead of overwriting it. Always use this with the
|
|
|
|
|
``no-waveheader`` option - with ``waveheader`` it's broken, because
|
|
|
|
|
it will write a WAVE header every time the file is opened.
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2013-07-08 16:02:14 +00:00
|
|
|
``rsound``
|
2017-08-21 13:46:00 +00:00
|
|
|
Audio output to an RSound daemon. Use ``--audio-device=rsound/<hostname>``
|
|
|
|
|
to set the host name (with ``<hostname>`` replaced, without the ``< >``).
|
manpage: merge new manpage
About a year ago, ubitux converted most of the old manpage from the
hard to maintain nroff format to reStructuredText. This was not merged
back into the master repository immediately. The argument was that the
new manpage still required work to be done. However, progress was very
slow. Even worse: the old manpage wasn't updated, because it was
scheduled for deletion, and updating it would have meant useless work.
Now the situation is that the new manpage still isn't finished, and the
old manpage is grossly out of sync with the player. This is not helpful
for users. Additionally, keeping the new manpage in a separate branch,
while the normal development repository for code had the old manpage,
was very inconvenient, because you couldn't just update the
documentation in the same commit as the code.
Even though the new manpage isn't finished yet, merging it now seems to
be the best course of action. Squash-merge the manpage development
branch [1], revision e89f5dd3f2, which branches from the mplayer2
master branch after revision 159102e0cb.
Committers:
* Clément Bœsch <ubitux@gmail.com> (Initial conversion to RST.)
* Uoti Urpala <uau@mplayer2.org> (Many updates.)
* Myself (Minor edits.)
Most text of the manpage has been directly taken from the old manpage,
because this is a conversion, not a complete rewrite.
[1] http://git.mplayer2.org/uau/mplayer2.git/log/?h=man
2012-08-02 19:37:33 +00:00
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
.. note:: Completely useless, unless you intend to run RSound. Not to be
|
|
|
|
|
confused with RoarAudio, which is something completely
|
2014-04-26 11:28:31 +00:00
|
|
|
different.
|
2014-04-19 13:29:05 +00:00
|
|
|
|
2013-10-05 20:40:38 +00:00
|
|
|
``sndio``
|
|
|
|
|
Audio output to the OpenBSD sndio sound system
|
|
|
|
|
|
2014-04-19 13:29:05 +00:00
|
|
|
.. note:: Experimental. There are known bugs and issues.
|
|
|
|
|
|
2013-10-05 20:40:38 +00:00
|
|
|
(Note: only supports mono, stereo, 4.0, 5.1 and 7.1 channel
|
|
|
|
|
layouts.)
|
|
|
|
|
|
2013-07-20 17:13:39 +00:00
|
|
|
``wasapi``
|
2013-07-20 02:38:36 +00:00
|
|
|
Audio output to the Windows Audio Session API.
|
