.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "BLUEALSA-APLAY" "1" "August 2020" "BlueALSA v3.0.0" "General Commands Manual"
.hy
.SH NAME
.PP
bluealsa-aplay - a simple bluealsa player
.SH SYNOPSIS
.PP
\f[B]bluealsa-aplay\f[R] [\f[I]OPTION\f[R]]\&...
[\f[I]BT-ADDR\f[R]]\&...
.SH DESCRIPTION
.PP
Capture audio streams from Bluetooth devices (via \f[B]bluealsa\f[R](8))
and play them to an ALSA playback device.
.PP
By default \f[B]bluealsa-aplay\f[R] captures audio from all connected
Bluetooth devices.
It is possible to select specific Bluetooth devices by providing a list
of \f[I]BT-ADDR\f[R] MAC addresses.
Using the special MAC address \f[B]00:00:00:00:00:00\f[R] will disable
device filtering - the same as the default behavior.
.SH OPTIONS
.TP
\f[B]-h\f[R], \f[B]--help\f[R]
Output a usage message and exit.
.TP
\f[B]-V\f[R], \f[B]--version\f[R]
Output the version number and exit.
.TP
\f[B]-v\f[R], \f[B]--verbose\f[R]
Make the output more verbose.
.TP
\f[B]-l\f[R], \f[B]--list-devices\f[R]
List connected Bluetooth audio devices.
.TP
\f[B]-L\f[R], \f[B]--list-pcms\f[R]
List available Bluetooth audio PCMs on connected devices.
.TP
\f[B]-B\f[R], \f[B]--dbus\f[R]=\f[I]NAME\f[R]
BlueALSA service name suffix.
For more information see \f[B]--dbus\f[R]=\f[I]NAME\f[R] option of
\f[B]bluealsa\f[R](8) service daemon.
.TP
\f[B]-D\f[R], \f[B]--pcm\f[R]=\f[I]NAME\f[R]
Select ALSA playback PCM device to use for audio output.
The default is \[lq]default\[rq].
.TP
\f[B]--pcm-buffer-time\f[R]=\f[I]INT\f[R]
Set the playback PCM buffer duration time to \f[I]INT\f[R] microseconds.
The default is 500000.
ALSA may choose the nearest available alternative if the requested value
is not supported.
.TP
\f[B]--pcm-period-time\f[R]=\f[I]INT\f[R]
Set the playback PCM period duration time to \f[I]INT\f[R] microseconds.
The default is 100000.
ALSA may choose the nearest available alternative if the requested value
is not supported.
.TP
\f[B]--profile-a2dp\f[R]
Use A2DP profile (default).
.TP
\f[B]--profile-sco\f[R]
Use SCO profile.
.TP
\f[B]--single-audio\f[R]
Allow only one Bluetooth device to play audio at a time.
Without this option, \f[B]bluealsa-aplay\f[R] plays audio from all
selected Bluetooth devices.
Please note that playing from all Bluetooth devices at a time requires
used PCM to be able to mix audio from multiple sources (i.e., it can be
opened more than once; for example the ALSA \f[B]dmix\f[R] plugin).
.SH SEE ALSO
.PP
\f[B]bluealsa\f[R](8), \f[B]bluealsa-rfcomm\f[R](1)
.PP
Project web site at https://github.com/Arkq/bluez-alsa
.SH COPYRIGHT
.PP
Copyright (c) 2016-2020 Arkadiusz Bokowy.
.PP
The bluez-alsa project is licensed under the terms of the MIT license.