Bluetooth: Difference between revisions
imported>ThibautMarty m mpris-proxy: mention the new home-manager service (eventually we should remove the snippet) |
|||
(10 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
==Enabling Bluetooth support== | ==Enabling Bluetooth support== | ||
To enable support for Bluetooth devices, | To enable support for Bluetooth devices, amend your system configuration as follows: | ||
{{file|/etc/nixos/configuration.nix|nix|<nowiki> | |||
{ | |||
... | ... | ||
hardware.bluetooth.enable = true; | hardware.bluetooth.enable = true; # enables support for Bluetooth | ||
hardware.bluetooth.powerOnBoot = true; # powers up the default Bluetooth controller on boot | |||
... | ... | ||
}</ | } | ||
</nowiki>}} | |||
{{evaluate}} | {{evaluate}} | ||
==Pairing Bluetooth devices== | ==Pairing Bluetooth devices== | ||
In order to use Bluetooth devices, they must be paired with your NixOS machine. Heavier desktop environments will usually provide a Bluetooth management GUI which you can use to pair devices. | In order to use Bluetooth devices, they must be paired with your NixOS machine. Heavier desktop environments will usually provide a Bluetooth management GUI which you can use to pair devices. | ||
Line 33: | Line 32: | ||
Bluetooth devices automatically connect with <tt>bluetoothctl</tt> as well: | Bluetooth devices automatically connect with <tt>bluetoothctl</tt> as well: | ||
<syntaxhighlight lang="console">$ bluetoothctl | <syntaxhighlight lang="console"> | ||
[bluetooth] # trust [hex-address]</syntaxhighlight> | $ bluetoothctl | ||
[bluetooth] # trust [hex-address] | |||
</syntaxhighlight> | |||
==Using Bluetooth headsets with PulseAudio== | ==Using Bluetooth headsets with PulseAudio== | ||
Line 41: | Line 42: | ||
<syntaxhighlight lang="nix">{ | <syntaxhighlight lang="nix">{ | ||
hardware.pulseaudio.enable = true; | hardware.pulseaudio.enable = true; | ||
hardware.bluetooth.enable = true; | hardware.bluetooth.enable = true; | ||
}</syntaxhighlight> | }</syntaxhighlight> | ||
Line 62: | Line 61: | ||
<syntaxHighlight lang="nix"> | <syntaxHighlight lang="nix"> | ||
systemd.user.services.mpris-proxy = { | systemd.user.services.mpris-proxy = { | ||
description = "Mpris proxy"; | |||
after = [ "network.target" "sound.target" ]; | |||
wantedBy = [ "default.target" ]; | |||
serviceConfig.ExecStart = "${pkgs.bluez}/bin/mpris-proxy"; | |||
}; | }; | ||
</syntaxHighlight> | </syntaxHighlight> | ||
Line 88: | Line 87: | ||
===Enabling extra codecs=== | ===Enabling extra codecs=== | ||
While pulseaudio itself only has support for the SBC bluetooth codec there is out-of-tree support for AAC, APTX, APTX-HD and LDAC. | While pulseaudio itself only has support for the SBC bluetooth codec there is out-of-tree support for AAC, APTX, APTX-HD and LDAC. | ||
Line 99: | Line 95: | ||
hardware.pulseaudio = { | hardware.pulseaudio = { | ||
enable = true; | enable = true; | ||
package = pkgs.pulseaudioFull; | package = pkgs.pulseaudioFull; | ||
}; | }; | ||
Line 109: | Line 104: | ||
Modern headsets will generally try to connect using the A2DP profile. To enable this for your bluetooth connection, add the following to <tt>/etc/nixos/configuration.nix</tt> | Modern headsets will generally try to connect using the A2DP profile. To enable this for your bluetooth connection, add the following to <tt>/etc/nixos/configuration.nix</tt> | ||
<syntaxhighlight lang="nix">{ | <syntaxhighlight lang="nix"> | ||
{ | |||
hardware.bluetooth. | hardware.bluetooth.settings = { | ||
General = { | |||
Enable = "Source,Sink,Media,Socket"; | |||
}; | |||
}; | }; | ||
} | } | ||
</syntaxhighlight> | |||
This configuration may be unnecessary and does not work with bluez5 (<tt>Unknown key Enable for group General</tt> ). | This configuration may be unnecessary and does not work with bluez5 (<tt>Unknown key Enable for group General</tt> ). | ||
Line 142: | Line 137: | ||
Note that you may need to clear the pulseaudio config located at ~/.config/pulse to get this to work. Also you may have to unset and then set the default audio device to the bluetooth device, see https://github.com/NixOS/nixpkgs/issues/86441 for more info | Note that you may need to clear the pulseaudio config located at ~/.config/pulse to get this to work. Also you may have to unset and then set the default audio device to the bluetooth device, see https://github.com/NixOS/nixpkgs/issues/86441 for more info | ||
==Showing battery charge of bluetooth devices== | |||
If you want to see what charge your bluetooth devices have you have to enable experimental features, which might lead to bugs (according to [https://wiki.archlinux.org/title/Bluetooth_headset#Battery_level_reporting Arch Wiki). You can add the following to your config to enable experimental feature for bluetooth: | |||
<syntaxhighlight lang="nix">{ | |||
... | |||
hardware.bluetooth.settings = { | |||
General = { | |||
Experimental = true; | |||
}; | |||
}; | |||
... | |||
}</syntaxhighlight> | |||
Afterwards rebuild your system and then restart your bluetooth service by executing <syntaxhighlight lang="console">$ systemctl restart bluetooth</syntaxhighlight>. | |||
==Troubleshooting== | ==Troubleshooting== | ||
Line 181: | Line 189: | ||
This possibly can be fixed by restarting the display-manager session. The session management may have had an issue with registering your current session and doesn't allow you to control bluetooth. | This possibly can be fixed by restarting the display-manager session. The session management may have had an issue with registering your current session and doesn't allow you to control bluetooth. | ||
<syntaxhighlight> | <syntaxhighlight lang="console"> | ||
sudo systemctl restart display-manager.service | $ sudo systemctl restart display-manager.service | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 194: | Line 202: | ||
==See also== | ==See also== | ||
* [http://anderspapitto.com/posts/2016-11-07-scripting_pulseaudio_bluetooth_jack.html Scripting PulseAudio, Bluetooth, JACK] | * [http://anderspapitto.com/posts/2016-11-07-scripting_pulseaudio_bluetooth_jack.html Scripting PulseAudio, Bluetooth, JACK] | ||
* [https://wiki.gentoo.org/wiki/Bluetooth Bluetooth (Gentoo Wiki)] | |||
* [https://wiki.archlinux.org/index.php/Bluetooth Bluetooth (Arch Linux Wiki)] | * [https://wiki.archlinux.org/index.php/Bluetooth Bluetooth (Arch Linux Wiki)] | ||
[[Category:Audio]][[Category:Configuration]][[Category:Hardware]] | [[Category:Audio]][[Category:Configuration]][[Category:Hardware]] |