Skip to content

Instantly share code, notes, and snippets.

@egelev
Last active March 13, 2026 13:29
Show Gist options
  • Select an option

  • Save egelev/2e6b57d5a8ba62cf6df6fff2878c3fd4 to your computer and use it in GitHub Desktop.

Select an option

Save egelev/2e6b57d5a8ba62cf6df6fff2878c3fd4 to your computer and use it in GitHub Desktop.
Connect bluetooth headphones on Ubuntu 18.04
#!/usr/bin/env bash
function get_headphones_index() {
echo $(pacmd list-cards | grep bluez_card -B1 | grep index | awk '{print $2}')
}
function get_headphones_mac_address() {
local temp=$(pacmd list-cards | grep bluez_card -C20 | grep 'device.string' | cut -d' ' -f 3)
temp="${temp%\"}"
temp="${temp#\"}"
echo "${temp}"
}
function _control_bluethoot_headphones() {
local op=${1}
local hp_mac=${2}
echo -e "${op} ${hp_mac}\n quit" | bluetoothctl
}
function disconnect_bluetooth_headphones() {
local hp_mac=${1}
_control_bluethoot_headphones "disconnect" ${hp_mac}
}
function connect_bluetooth_headphones() {
local hp_mac=${1}
_control_bluethoot_headphones "connect" ${hp_mac}
}
function _set_headphones_profile() {
local profile=${1}
pacmd set-card-profile $(get_headphones_index) ${profile}
}
function set_headphones_profile_a2dp_sink() {
_set_headphones_profile "a2dp_sink"
echo "Bluethoot headphones a2dp_sink"
}
function set_headphones_profile_off() {
_set_headphones_profile "off"
echo "Bluethoot headphones profile off"
}
function main() {
local hp_mac=$(get_headphones_mac_address)
set_headphones_profile_off
sleep 2s
disconnect_bluetooth_headphones ${hp_mac}
sleep 6s
connect_bluetooth_headphones ${hp_mac}
sleep 3s
set_headphones_profile_a2dp_sink
}
main
@egelev

egelev commented Mar 6, 2020

Copy link
Copy Markdown
Author

It is unbelievable that such basic functionality like bluetooth audio connection still does not work properly in Ubuntu 18.04.
Works this way with my WH-1000XM3 headphone but still annoying. Sometimes also audio gets out of sync and I have to switch to None and then A2DP again. Please leave a comment if there is a proper solution.
Edit: Compiling and installing bluez-5.52 does fix the issue for me: https://askubuntu.com/questions/1139404/sony-noise-cancelling-headphones-wh-1000xm2-3-and-bluetooth-initial-autoconnec

Hi @fospald.

I was pretty annoyed too. It really wonders me how some people are able to communicate with a rover on 225 million kilometers (the average distance to Mars) and the most popular open-source OS can not handle 10m Bluetooth audio connection :D.
However, I have to admit that the guys from Canonical are doing a good job. I recently installed Ubuntu 18.04.4 which was released on 12 Feb 2020 and my headphones work properly now. According to the release notes they have provided a fix for this particular issue.

I regularly use Sony WH-1000XM2 and Boltune ANC 2019 and they both work properly. I haven't experienced the sync audio problems you mentioned so I'm not able to share any experience here. However, setting the profile to 'None' and then back to 'A2DP' can be done with the helper functions of this script.

All the best :).

@vegrex

vegrex commented May 25, 2020

Copy link
Copy Markdown

Thanks! Using ATH-M50xBT headphones I had to extend that last sleep with one second because it could not get the index in 3s.

@jonpolak

Copy link
Copy Markdown

I have the opposite problem, I have a mono headset, which connects as A2DP by default... would love if the default was HSP.

@heyakyra

heyakyra commented Jun 24, 2020

Copy link
Copy Markdown

Seems many have had this issue: https://github.com/valderman/bt-reload-headphones

I have the opposite problem, I have a mono headset, which connects as A2DP by default... would love if the default was HSP.

This is the problem I'm also having in Fedora 32. I'm assuming that's because the underlying issue has not been addressed, merely the default connection has changed to anger the other half of users which depend on using their microphones.

I wasn't able to find a discussion about this on the bluez (linux-bluetooth) developers mailing list, but maybe someone else will have better luck: https://marc.info/?l=linux-bluetooth

Or wants to subscribe and raise the issue:
http://vger.kernel.org/vger-lists.html#linux-bluetooth

@jangroth

Copy link
Copy Markdown

Thanks for this script!

For my Bose QuietComfort 35 Wireless & on Ubuntu 20.04, I had to bump the sleep time between connect and set_profile to 6s. Works great then!

@mikeyjk

mikeyjk commented Sep 3, 2020

Copy link
Copy Markdown

This is amazing, thank you
Maybe pop up a way to donate you a coffee!

@egelev

egelev commented Sep 27, 2020 via email

Copy link
Copy Markdown
Author

@ryandward

ryandward commented Sep 27, 2020

Copy link
Copy Markdown

Hey Egelev,

I wanted to congratulate you on your awesome code. I looked through it a bit after I made this comment, and decided my comment was silly. Your fix worked until I rebooted my Gnome on Arch box. I eventually just gave up and switched to xfce and it just works now.

This whole thing has kind of showed me the holes there are in the current Gnome environment.

@Miuler

Miuler commented Sep 28, 2020

Copy link
Copy Markdown

Gracias, con este script porfin logre hacer funcionar mi WH-1000XM4!

@drakakisgeo

Copy link
Copy Markdown

Strangely I get this in Xubuntu 18

"connect_bluetooth_headphones.sh: 3: connect_bluetooth_headphones.sh: Syntax error: "(" unexpected"

Any idea why?

@egelev

egelev commented Oct 23, 2020

Copy link
Copy Markdown
Author

Strangely I get this in Xubuntu 18

"connect_bluetooth_headphones.sh: 3: connect_bluetooth_headphones.sh: Syntax error: "(" unexpected"

Any idea why?

Hi @drakakisgeo.
This is unexpected behavior. Is your default interpreter bash?
Can you please share the output from
$ bash --version

I use GNU bash, version 4.4.20(1)-release (x86_64-pc-linux-gnu).

@drakakisgeo

drakakisgeo commented Oct 24, 2020

Copy link
Copy Markdown

GNU bash, version 4.4.20(1)-release (x86_64-pc-linux-gnu) is what I get.

But also SHELL=/usr/bin/zsh so I ran it with bash. Thanks! Let's hope that will fix my issue :-)

@nikogamulin

Copy link
Copy Markdown

I tried to run the script in order to fix the configuration for Bose QC35 headphones. The script resets the Bluetooth module but nevertheless I can't get stereo quality. By default, the option Headset Head Unit (HSP/HFP) is selected. If I select High Fidelity Playback (A2DP Sink), nothing happens. I would appreciate if anyone suggested a way to fix the issue.

@fervic

fervic commented Dec 10, 2020

Copy link
Copy Markdown

Gracias, con este script porfin logre hacer funcionar mi WH-1000XM4!

@Miuler te funcionan como HSP/HFP? Es decir el micrófono también? Tengo el mismo headset y sólo me lo reconoce como A2DP.

Does it work with the HSP/HFP profile? Is it recognized as an input device? I have the exact same model of headset and it is only recognized as A2DP in my case.

@egelev

egelev commented Dec 10, 2020

Copy link
Copy Markdown
Author

Gracias, con este script porfin logre hacer funcionar mi WH-1000XM4!

@Miuler te funcionan como HSP/HFP? Es decir el micrófono también? Tengo el mismo headset y sólo me lo reconoce como A2DP.

Does it work with the HSP/HFP profile? Is it recognized as an input device? I have the exact same model of headset and it is only recognized as A2DP in my case.

The problem might be the Bluetooth profile and how the Sony Headphones present themselves to the Ubuntu system. Have a look here :).

@dgketchum

Copy link
Copy Markdown

Nice script. Many thanks!

@leka0024

leka0024 commented Jan 13, 2021

Copy link
Copy Markdown

No matter what I do (the order of turning headphone pairing on and turning bluetooth on, or leaving bluetooth off, etc.), I get the following messages in Ubuntu 20.04 when I run the script:

You need to specify a profile by its name.
Bluethoot headphones profile off
Agent registered
[bluetooth]# disconnect 
Missing device address argument
[bluetooth]#  quit
Agent registered
[bluetooth]# connect 
Missing dev argument
[bluetooth]#  quit
You need to specify a profile by its name.
Bluethoot headphones a2dp_sink

The headphones are Sony MDR-ZX780DC and they work just fine on iphone. (I did turn iphone bluetooth off)

Does anyone have any suggestion?

@egelev

egelev commented Jan 24, 2021

Copy link
Copy Markdown
Author

No matter what I do (the order of turning headphone pairing on and turning bluetooth on, or leaving bluetooth off, etc.), I get the following messages in Ubuntu 20.04 when I run the script:

You need to specify a profile by its name.
Bluethoot headphones profile off
Agent registered
[bluetooth]# disconnect 
Missing device address argument
[bluetooth]#  quit
Agent registered
[bluetooth]# connect 
Missing dev argument
[bluetooth]#  quit
You need to specify a profile by its name.
Bluethoot headphones a2dp_sink

The headphones are Sony MDR-ZX780DC and they work just fine on iphone. (I did turn iphone bluetooth off)

Does anyone have any suggestion?

Hello @leka0024.
Can you please provide the output of the following command: pacmd list-cards | grep bluez_card -B1 -A50 ?
If it is OK, it would be helpful to execute it twice:

  • when the headphones are not connected
  • when you connect them through the Ubuntu UI (don't pay attention to the profile - HSP/HFP or A2DP)

Thank you.

@leka0024

leka0024 commented Jan 24, 2021

Copy link
Copy Markdown

Hello @leka0024.
Can you please provide the output of the following command: pacmd list-cards | grep bluez_card -B1 -A50 ?
If it is OK, it would be helpful to execute it twice:

* when the headphones are not connected

* when you connect them through the Ubuntu UI (don't pay attention to the profile - HSP/HFP or A2DP)

Thank you.

Hi @egelev ,

Nothing returns with the pipe'd command you suggest. If I just run pacmd list-cards I get this info:

1 card(s) available.
    index: 0
	name: <alsa_card.pci-0000_00_1f.3-platform-skl_hda_dsp_generic>
	driver: <module-alsa-card.c>
	owner module: 23
	properties:
		alsa.card = "0"
		alsa.card_name = "sof-hda-dsp"
		alsa.long_card_name = "LENOVO-82HS-IdeaPadFlex514ITL05-LNVNB161216"
		alsa.driver_name = "snd_soc_skl_hda_dsp"
		device.bus_path = "pci-0000:00:1f.3-platform-skl_hda_dsp_generic"
		sysfs.path = "/devices/pci0000:00/0000:00:1f.3/skl_hda_dsp_generic/sound/card0"
		device.bus = "pci"
		device.vendor.id = "8086"
		device.vendor.name = "Intel Corporation"
		device.product.id = "a0c8"
		device.string = "0"
		device.description = "sof-hda-dsp"
		module-udev-detect.discovered = "1"
		device.icon_name = "audio-card-pci"

Is that helpful?

When I have turned Bluetooth on in the Ubuntu settings, it can never see my headphones (turned on, in pairing mode, and iphone bluetooth off), so I don't believe it has ever "connected".

Thanks for any suggestions!

@egelev

egelev commented Jan 25, 2021

Copy link
Copy Markdown
Author

Hi, @leka0024. Thank you for the info. Unfortunately, it looks like this is another issue. This script only changes the profile from HSP/HFP to A2DP once the headphones are successfully connected. I am sorry, it looks like some sort of incompatibility issue.

@rs-development

Copy link
Copy Markdown

Does someone has the problem that the Headset Mode is working but on A2DP no sound can be heard? It was workings since i upgraded to 20.xx but since one week or so i have problems again. Removing and Repairing does sometimes fix the issue.

WH-1000XM3, newest firmware.

@jrobinson-vs

Copy link
Copy Markdown

i am unable to as well on Linux Mint 20.1

@darrentmorgan

Copy link
Copy Markdown

Does someone has the problem that the Headset Mode is working but on A2DP no sound can be heard? It was workings since i upgraded to 20.xx but since one week or so i have problems again. Removing and Repairing does sometimes fix the issue.

WH-1000XM3, newest firmware.

This may or may not resolve your issue. I've found that on first connect it will not work with the headphones. I've had the Sony WH-1000xm3 and xm4's. My current simple fix is to connect the headphones, disconnect them and reconnect. Then click on the speaker icon and choose the applications tab and select the sound output to be the headphones. This is not a great work around, but it's the best that I've been able to come up with.

I've tested this on Ubuntu, mint and Mx Linux.

@marcelmanz

Copy link
Copy Markdown

Does this work with Pipewire ?

@jmarshallh

Copy link
Copy Markdown

thank you so much !
worked for me on Linux Mint 20.2 Cinnamon and Sony WH-1000XM3 headset .
happy new year !

@italomunozj

Copy link
Copy Markdown

Hi Emil. I happened to find your script just today ... and I love it!, very useful. Thank you! ( :

@egelev

egelev commented Dec 8, 2022

Copy link
Copy Markdown
Author

Hi Emil. I happened to find your script just today ... and I love it!, very useful. Thank you! ( :

I'm glad it is still useful :).

@pavdwest

pavdwest commented Dec 19, 2022

Copy link
Copy Markdown

Thank you very much for this - worked perfectly out of the box with my Bose QCII Headset on Ubuntu 22.04.

@arnavn101

Copy link
Copy Markdown

Thanks, worked for me!

@tbulligan

Copy link
Copy Markdown

Thank you @egelev for the script. I changed it to make it wotk with PipeWire. You can see it here: https://gist.github.com/tbulligan/b92e85a6e89e218d711a97cfa38f855e

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment