Bluetooth

Enabling

Enabling bluetooth support is as simple as adding hardware.bluetooth.enable to configuration.nix

{
  hardware.bluetooth.enable = true;
}

Tip

In order to affect your NixOS system by your nix-language-specific changes you must first evaluate it:

$ nixos-rebuild switch --use-remote-sudo

Pairing

Bigger desktop environments will usually provide a bluetooth management system.

This article or section needs expansion.

Reason: This article is a stub. (Discuss in Talk:Bluetooth#)
Please consult the pedia article metapage for guidelines on contributing.

Alternatively, using pkgs.blueman, it is possible to get a tray icon blueman-applet or use the manager directly using blueman-manager.

Pairing without GUI tools

When not using a desktop-manager, configuring the device from the command line can be done following the ArchWiki instructions, as follows.

$ bluetoothctl
[bluetooth] # power on
[bluetooth] # agent on
[bluetooth] # default-agent
[bluetooth] # scan on
...put device in pairing mode and wait [hex-address] to appear here...
[bluetooth] # pair [hex-address]
[bluetooth] # connect [hex-address]

Bluetooth headsets with PulseAudio

The package used for PulseAudio has to be pkgs.pulseaudioFull, which includes bluetooth support.

{
  hardware.pulseaudio = {
    enable = true;
    package = pkgs.pulseaudioFull;
  };
  hardware.bluetooth.enable = true;
}

Tip

In order to affect your NixOS system by your nix-language-specific changes you must first evaluate it:

$ nixos-rebuild switch --use-remote-sudo

Either restart the system for PulseAudio to load the bluetooth module, or restart your local instance of PulseAudio by running pkill ^pulseaudio$.

Ensure PulseAudio has loaded bluetooth modules by using pactl list | grep -i Name.*module.*blue. Bluetooth modules should be present in the list.

Managing the audio interface

Using pavucontrol, the headset profile can be changed to "High Fidelity Playback (A2DP Sink)" in the Configuration tab.

The default sink can be changed in the Output Devices tab. clicking on the right most button, which it title Set as fallback.

Managing the audio interface using pacmd

Setting the card to A2DP

$ pacmd set-card-profile "$(pactl list cards short | egrep -o bluez_card[[:alnum:]._]+)" a2dp_sink

Setting the bluetooth sink as default

$ pacmd set-default-sink "$(pactl list sinks short | egrep -o bluez_sink[[:alnum:]._]+)"

Troubleshooting

USB device needs to be unplugged/re-plugged after suspend

Some USB devices/hosts combinations don't play well with the suspend/resume cycle, and needs to be unplugged and then re-plugged to work again.

It is possible to simulate a unplug/re-plug cycle using the /sys/ filesystem.

This gist provides a script and instructions to set-up a workaround for these devices.

External resources

• Scripting pulseaudio, bluetooth, jack