Home

Welcome to the bluez-alsa project wiki!

Overview

BlueALSA consists of the daemon bluealsa, ALSA plugins, and a number of utilities including bluealsa-aplay.

The heart of this system is the daemon bluealsa which interfaces with the Bluez Bluetooth daemon bluetoothd and the local Bluetooth adapter. It handles the profile connection and configuration logic for A2DP, HFP and HSP and presents the resulting audio streams to applications via D-Bus.

The system includes ALSA plugins which hide all the D-Bus specifics and permit applications to use the ALSA PCM and CTL interfaces, so that applications can access Bluetooth audio devices in much the same way as they use sound card PCMs and CTLs.

There is also a number of utility applications. Of particular note are:

• bluealsa-aplay
  simplifies the task of building a Bluetooth speaker using BlueALSA.

• bluealsa-cli
  simplifies management of the BlueALSA system.

The basic context for these components is shown in the following diagram: images/components.png

Building and Installing BlueALSA

• Installation from source
• Yocto/OE recipe

System Integration

• Systemd integration
• JACK integration
• PulseAudio integration ( experimental )

Manual Pages

• bluealsa
• bluealsa-aplay
• bluealsa-cli
• bluealsa-rfcomm
• hcitop
• BlueALSA ALSA plugins

BlueALSA ALSA Plugins

• Using BlueALSA with other ALSA plugins
• Using BlueALSA as default ALSA PCM
• Using BlueALSA with HFP and HSP devices
• Using BlueALSA with dmix

bluealsa-aplay

• Using ALSA devices with bluealsa-aplay
• Using bluealsa-aplay with dsnoop

Specific Use Case Descriptions

• Setting up a USB audio device as a Bluetooth speaker under Ubuntu

Archived Pages

These pages apply to older releases of BlueALSA

• Using the BlueALSA ALSA pcm plugin (for release 3.1.0 and earlier)
• Systemd integration (outdated version)