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 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