bluez

pacman -S bluez
pacman -S bluez-utils
  • enable service
systemctl enable bluetooth.service
systemctl start  bluetooth.service
  • start command line prompt
bluetoothctl
  • turn power on, turn agent, start scanning for devices
[bluetooth]# power on
[bluetooth]# agent on
[bluetooth]# default-agent
[bluetooth]# scan on
  • find MAC address of device
  • note: might be spammed by other devices, exit to prevent
  • pair, connect, and trust for future auto-connect
[bluetooth]# pair MAC_ADDRESS
[bluetooth]# connect MAC_ADDRESS
[bluetooth]# trust MAC_ADDRESS
  • enable auto power-on of bluetooth module in /etc/bluetooth/main.conf 
[Policy]
AutoEnable=true

bluetooth randomly stuck

  • bluetooth stuck after waking up from sleep
  • sudo systemctl restart bluetooth.service and the like hangs
  • kill daemon directly
sudo pkill -9 bluetoothd

device not showing up

  • arch wiki - bluetooth
  • certain bluetooth low energy (BLE) devices don't show up in scan
  • set transport le
[bluetooth]# menu scan
[bluetooth]# transport le
[bluetooth]# back
[bluetooth]# scan on
[bluetooth]# devices