-h, --help

Output a usage message and exit.

-V, --version

Output the version number and exit.

-B NAME, --dbus=NAME

BlueALSA D-Bus service name suffix. Without this option, bluealsa registers itself as an "org.bluealsa" D-Bus service. For more information see the EXAMPLE below.

-S, --syslog

Send output to system logger (syslogd(8)). By default, log output is sent to stderr.

-i hciX, --device=hciX

HCI device to use. Can be specified multiple times to select more than one HCI. Because HCI numbering can change after a system reboot, this option also accepts HCI MAC address for the hciX value, e.g.: --device=00:11:22:33:44:55

Without this option, the default is to use all available HCI devices.

-p NAME, --profile=NAME

Enable NAME Bluetooth profile. May be given multiple number of times to enable multiple profiles.

It is mandatory to enable at least one Bluetooth profile. For the list of supported profiles see the PROFILES section below.

-c NAME, --codec=NAME

Enable or disable NAME Bluetooth audio codec. May be given multiple number of times to enable (or disable) multiple codecs.

In order to disable given audio codec (remove it from the list of audio codecs enabled by default), the NAME has to be prefixed with - (minus) character. It is not possible to disable SBC and CVSD codecs which are mandatory for A2DP and HFP/HSP respectively.

By default BlueALSA enables SBC, AAC (if AAC support is compiled-in), CVSD and mSBC. For the list of supported audio codecs see the "Available BT audio codecs" section of the bluealsa command-line help message.

--initial-volume=NUM

Set the initial volume to NUM % when the device is connected. NUM must be an integer in the range from 0 to 100. The default value is 100 (full volume).

Having headphones volume reset to max whenever they connect can lead to an unpleasant experience. This option allows the user to choose an alternative initial volume level. Only one value can be specified and each device on connect will have the volume level of all its PCMs set to this value (%). However, a device with native volume control may then immediately override this level.

--keep-alive=SEC

Keep Bluetooth transport alive for SEC number of seconds after streaming was closed.

This option is required when using bluealsa with applications that close and then immediately re-open the same PCM as part of their initialization; for example applications built with the portaudio portability library and many other "portable" applications.

It can also be useful when playing short audio files in quick succession. It will reduce the gap between playbacks caused by Bluetooth audio transport acquisition.

--a2dp-force-mono

Force monophonic sound for A2DP profile.

--a2dp-force-audio-cd

Force 44.1 kHz sampling frequency for A2DP profile. Some Bluetooth devices can handle streams sampled at either 48kHz or 44.1kHz, in which case they normally default to using 48kHz. With this option, bluealsa will request such a device uses only 44.1 kHz sample rate.

--a2dp-volume

Enable native A2DP volume control. By default bluealsa will use its own internal scaling algorithm to attenuate the volume. This option disables that internal scaling and instead passes the volume change request to the A2DP device. This feature can also be controlled during runtime via BlueALSA D-Bus API. Note that this feature might not work with all Bluetooth headsets.

--sbc-quality=MODE

Set SBC encoder quality, where MODE can be one of:

--mp3-algorithm=TYPE

Select LAME encoder internal algorithm, where TYPE can be one of:

If CPU power consumption is not an issue, one might safely select best as the algorithm type. Also, please note that the true quality is determined by the selected bit rate or used VBR quality option (--mp3-vbr-quality).

--mp3-vbr-quality=MODE

Set variable bit rate (VBR) quality, where MODE can be one of:

--aac-afterburner

Enables Fraunhofer AAC afterburner feature, which is a type of analysis by synthesis algorithm. This feature increases the audio quality at the cost of increased processing power and overall memory consumption.

--aac-bitrate=BPS

Set the target bit rate for constant bit rate (CBR) mode or the maximum peak bit rate for variable bit rate (VBR) mode. Default value is 220000 bits per second.

--aac-latm-version=NUM

Select LATM syntax version used for AAC audio transport. Default value is 1.

The NUM can be one of:

--aac-true-bps

Enable true "bit per second" bit rate.

A2DP AAC specification requires that for the constant bit rate (CBR) mode every RTP frame has the same bit rate and for the variable bit rate (VBR) mode the maximum peak bit rate limit is also per RTP frame. However, a single RTP frame does not contain a single full second of audio. This option enables true bit rate calculation (per second), which means that per RTP frame bit rate may vary even for CBR mode. This feature is not enabled by default, because it violates A2DP AAC specification. Enabling it should result in an enhanced audio quality, but will for sure produce fragmented RTP frames. If RTP fragmentation is not supported by used A2DP sink device (e.g. headphones) one might hear clearly audible clicks in the playback audio. In such case, please do not enable this option.

--aac-vbr

Prefer variable bit rate mode over constant bit rate mode.

Please note, that this option does not necessarily mean that the variable bit rate (VBR) mode will be used. Used AAC configuration depends on a remote Bluetooth device capabilities.

--lc3plus-bitrate=BPS

Set LC3plus encoder bit rate for constant bit rate mode (CBR) as BPS. Default value is 396800 bits per second.

--ldac-abr

Enables LDAC adaptive bit rate, which will dynamically adjust encoder quality based on the connection stability.

--ldac-quality=MODE

Specifies LDAC encoder quality, where MODE can be one of:

--xapl-resp-name=NAME

Set the product name send in the XAPL response message. By default, the name is set as "BlueALSA". However, some devices (reported with e.g.: Sony WM-1000XM4) will not provide battery level notification unless the product name is set as "iPhone".

• a2dp-source - Advanced Audio Source (streaming audio to connected device)
• a2dp-sink - Advanced Audio Sink (receiving audio from connected device)
• hfp-ofono - Hands-Free AG/HF handled by oFono
• hfp-ag - Hands-Free Audio Gateway
• hfp-hf - Hands-Free
• hsp-ag Headset Audio Gateway
• hsp-hs - Headset

/etc/dbus-1/system.d/bluealsa.conf

BlueALSA service D-Bus policy file. D-Bus will deny all access to the org.bluealsa service (even to root) unless permission is granted by a policy file. The default file permits only root to own this service, and only members of the audio group to exchange messages with it.

Project web site

https://github.com/Arkq/bluez-alsa