mpv/DOCS/man/en/ao.rst

161 lines
6.0 KiB
ReStructuredText
Raw Normal View History

AUDIO OUTPUT DRIVERS
====================
Audio output drivers are interfaces to different audio output facilities. The
syntax is:
2013-07-08 16:02:14 +00:00
``--ao=<driver1[:suboption1[=value]:...],driver2,...[,]>``
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
in the list. Suboptions are optional and can mostly be omitted.
2013-07-08 16:02:14 +00:00
.. note::
See ``--ao=help`` for a list of compiled-in audio output drivers.
2013-07-08 16:02:14 +00:00
.. admonition:: Examples
- ``--ao=alsa,oss,`` Try the ALSA driver, then the OSS driver, then others.
- ``--ao=alsa:noblock:device=hw=0.3`` Sets noblock-mode and the device-name
as first card, fourth device.
Available audio output drivers are:
2013-07-08 16:02:14 +00:00
``alsa`` (Linux only)
ALSA 0.9/1.x audio output driver
``no-block``
Sets noblock-mode.
2013-07-08 16:02:14 +00:00
``device=<device>``
Sets the device name. For ac3 output via S/PDIF, use an "iec958" or
"spdif" device, unless you really know how to set it correctly.
.. note::
MPlayer and mplayer2 required you to replace any ',' with '.' and
any ':' with '=' in the ALSA device name. mpv does not do this anymore.
Instead, quote the device name:
``--ao=alsa:device=[plug:surround50]``
2013-07-08 16:02:14 +00:00
``oss``
OSS audio output driver
2013-07-08 16:02:14 +00:00
``<dsp-device>``
Sets the audio output device (default: ``/dev/dsp``).
2013-07-08 16:02:14 +00:00
``<mixer-device>``
Sets the audio mixer device (default: ``/dev/mixer``).
2013-07-08 16:02:14 +00:00
``<mixer-channel>``
Sets the audio mixer channel (default: ``pcm``).
2013-07-08 16:02:14 +00:00
``jack``
JACK (Jack Audio Connection Kit) audio output driver
2013-07-08 16:02:14 +00:00
``port=<name>``
Connects to the ports with the given name (default: physical ports).
2013-07-08 16:02:14 +00:00
``name=<client>``
Client name that is passed to JACK (default: mpv [<PID>]). Useful
if you want to have certain connections established automatically.
2013-07-08 16:02:14 +00:00
``(no-)estimate``
Estimate the audio delay, supposed to make the video playback smoother
(default: enabled).
2013-07-08 16:02:14 +00:00
``(no-)autostart``
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.
``(no-)connect``
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.
2013-07-08 16:02:14 +00:00
``std-channel-layout=alsa|waveext|any``
Select the standard channel layout (default: alsa). JACK itself has no
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
layout. ``alsa`` uses the old MPlayer layout, which is inspired by
ALSA's standard layouts. In this mode, ao_jack will refuse to play 3
2013-07-08 16:02:14 +00:00
or 7 channels (because these do not really have a defined meaning in
MPlayer). ``waveext`` uses WAVE_FORMAT_EXTENSIBLE order, which, even
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
with fixed setups.
2013-07-08 16:02:14 +00:00
``coreaudio`` (Mac OS X only)
Native Mac OS X audio output driver
2013-07-08 16:02:14 +00:00
``device_id=<id>``
ID of output device to use (0 = default device)
2013-07-08 16:02:14 +00:00
``help``
List all available output devices with their IDs.
2013-07-08 16:02:14 +00:00
``openal``
Experimental OpenAL audio output driver
2013-07-08 16:02:14 +00:00
``pulse``
PulseAudio audio output driver
2013-07-08 16:02:14 +00:00
``[<host>][:<output sink>]``
Specify the host and optionally output sink to use. An empty <host>
string uses a local connection, "localhost" uses network transfer
(most likely not what you want).
2013-07-08 16:02:14 +00:00
``portaudio``
PortAudio audio output driver. This works on all platforms, and has
extensive MS Windows support.
2013-07-08 16:02:14 +00:00
``device``
Specify the subdevice to use. Giving ``help`` as device name lists all
devices found by PortAudio. Devices can be given as numeric values,
starting from ``1``.
2013-07-08 16:02:14 +00:00
``dsound`` (Windows only)
DirectX DirectSound audio output driver
2013-07-08 16:02:14 +00:00
``device=<devicenum>``
Sets the device number to use. Playing a file with ``-v`` will show a
list of available devices.
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
appropriately for your system.
2013-07-08 16:02:14 +00:00
``buflen=<length>``
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.
2013-07-08 16:02:14 +00:00
``bufcnt=<count>``
Sets the number of extra audio buffers in mpv. Usually needs not be
changed.
2013-07-08 16:02:14 +00:00
``null``
Produces no audio output but maintains video playback speed. Use
``--no-audio`` for benchmarking.
2013-07-08 16:02:14 +00:00
``pcm``
Raw PCM/WAVE file writer audio output
2013-07-08 16:02:14 +00:00
``(no-)waveheader``
Include or do not include the WAVE header (default: included). When
not included, raw PCM will be generated.
2013-07-08 16:02:14 +00:00
``file=<filename>``
Write the sound to ``<filename>`` instead of the default
``audiodump.wav``. If ``no-waveheader`` is specified, the default is
``audiodump.pcm``.
2013-07-08 16:02:14 +00:00
``rsound``
Audio output to an RSound daemon
2013-07-08 16:02:14 +00:00
``host=<name/path>``
Set the address of the server (default: localhost). Can be either a
network hostname for TCP connections or a Unix domain socket path
starting with '/'.
2013-07-08 16:02:14 +00:00
``port=<number>``
Set the TCP port used for connecting to the server (default: 12345).
Not used if connecting to a Unix domain socket.