Skip to content

Instantly share code, notes, and snippets.

@brayevalerien

brayevalerien/bluetooth_headset_manjaroi3.md

Created June 22, 2025 20:00
Show Gist options
  • Save brayevalerien/9b7df42326f0f1e4580d3f8596c386f4 to your computer and use it in GitHub Desktop.
Save brayevalerien/9b7df42326f0f1e4580d3f8596c386f4 to your computer and use it in GitHub Desktop.
Download ZIP
A guide to making a bluetooth headset work on a fresh Manjaro i3 community build.
Raw
bluetooth_headset_manjaroi3.md

Setting up a bluetooth headset on Manjaro i3

This document is a step by step guide for setting up a bluetooth heaset with working audio on a fresh Manjaro i3 community build. It's assumed that all the following is done in sudo mode.

Note

The following guide serves mostly as notes for the future me that has to set this up again, it might not work for your exact setup. Feel free to request corrections. It's also quite likely that this works on most Arch builds.

Start by updating (or installing) bluez, bluez-utils and pulseaudio-bluetooth.

pacman -S bluez bluez-utils pulsaudio-bluetooth

Enable bluetooth with systemctl.

systemctl enable bluetooth
systemctl start bluetooth

Pair and connect to the headset

bluetoothctl
power on
scan on # check the MAC address of the headset
pair MAC_ADDRESS # use the address just scanned
trust MAC_ADDRESS
connect MAC_ADDRESS

Optionally switch to pipwire

PulseAudio might not be perfectly suited and it sometimes fails to stream audio correctly. For this reason, I switched to PipeWire using the following commands (again, in sudo mode).

Start by uninstalling PulseAudio and installing PipeWire.

pacman -Rns pulseaudio pulseaudio-bluetooth
pacman -S pipewire pipewire-pulse wireplumber pipewire-audio

Enable PipeWire

systemctl enable pipewire wireplumber
systemctl start pipewire wireplumber

Reboot

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