Using rfkill, ensure your bluetooth chip is unblocked.

void setup

Install the bluez package:
xi bluez

Enable the bluetoothd and dbus services, add your user to the bluetooth group, and reboot.

For ALSA ONLY user you'll want the bluez-alsa to get bluetooth speakers working, or just use pulse/pipewire???

bluetoothctl

pairing

1. (optional) Select a default controller with select MAC_address.

2. (optional) Enter power on to turn the power to the controller on if the device is set to off. It is on by default; see #Default adapter power state.

3. Enter devices to get the MAC address of the device with which to pair.

4. Enter device discovery mode with scan on command if device is not yet on the list.

5. Turn the agent on with agent on or choose a specific agent: if you press tab twice after agent you should see a list of available agents. A bluetooth agent is what manages the Bluetooth 'pairing code'. It can either respond to a 'pairing code' coming in, or can send one out. The default-agent should be appropriate in most cases.

6. Enter pair MAC_address to do the pairing (tab completion works).

7. If using a device without a PIN, one may need to manually trust the device before it can reconnect successfully. Enter trust MAC_address to do so.

8. Enter connect MAC_address to establish a connection.