===== How to integrate Bluetooth on Artix =====

**Programms we need:**
     * **bluetoothctl**: An interactive command-line tool for managing Bluetooth devices and connections.
     * **pulseaudio**: A sound server for Linux that manages audio streams and routes them to various audio devices.
     * **pulseaudio-bluetooth**: A pulseaudio module that provides support for Bluetooth audio devices, including pairing and audio streaming.

----

==== Installation =====

Fresh installed Artix Linux 'out of the box', comes with the Audio Server 'pipewire', which in itself doesnt support bluetooth-modules. Therefore you need to install 'pulseaudio' and 'pulseaudio-blueooth' and check if you have it installed correctly on your System afterwards:
<code>pacman -Q pulseaudio pulseaudio-bluetooth</code>

The most important module called 'module-bluetooth-discover' is not activated by default which is why you have to do it manually with:
<code>pactl load-module module-bluetooth-discover</code>

Restart pulseaudio to ensure that all changes are applied:
<code>
pulseaudio -k
pulseaudio --start
</code>

----

==== Bluetoothctl =====

Use bluetoothctl to ensure that your Bluetooth devices are connected:
<code>bluetoothctl</code>

Within the bluetoothctl menu type in:
<code>
power on            <- Turn bluetooth on 
agent on            <- Set agent to on to enable automatic connections:
default-agent       <- Set default-agent to ensure that the agent is used as the default
scan on             <- Scan for available devices
</code>

Search for the MAC address of your device in the scan list and copy it. It looks something like this: <code>[NEW] Device XX:XX:XX:XX:XX:XX XX-XX-XX-XX-XX-XX</code>

Connect the device:
<code>connect XX:XX:XX:XX:XX:XX</code>

Disconnect the device:
<code>disconnect XX:XX:XX:XX:XX:XX</code>

Add the device to the list of trusted devices to connect it automatically in the future.
<code>trust XX:XX:XX:XX:XX:XX</code>

Check if the device has succesfully connected:
<code>devices</code>

Exit out of bluetoothctl:
<code>exit</code>

----

==== Autostart ====
You can use openrc in Artix Linux to ensure that Bluetooth is started automatically every time the system is started. 
<code>sudo rc-update add bluetoothd default</code>