software catalog

content/software/bluez.md

@@ -0,0 +1,26 @@
+---
+title: "BlueZ"
+category: "Desktop and system"
+tagline: "The Linux Bluetooth stack, turned on, so headphones, mice and keyboards just pair."
+source: "pacman"
+package: "bluez"
+command: "bluetoothctl"
+code: "https://git.kernel.org/pub/scm/bluetooth/bluez.git"
+links:
+  - name: "Bluetooth on the Arch wiki"
+    url: "https://wiki.archlinux.org/title/Bluetooth"
+---
+
+## What it is
+
+BlueZ is the official Bluetooth stack for Linux. Its service talks to your Bluetooth adapter and handles pairing and connections, and GNOME's Bluetooth settings are built on it. bluez-utils adds `bluetoothctl`, a command-line tool for scanning, pairing and connecting devices.
+
+## Why it's here
+
+- **Wireless devices work.** Headphones, speakers, mice, keyboards and game controllers.
+- **Managed from Settings.** Pairing happens in GNOME, no terminal needed.
+- **A fallback in the terminal.** `bluetoothctl` helps when a device won't behave.
+
+## On CoreDesktop
+
+CoreDesktop installs BlueZ and bluez-utils from pacman and enables `bluetooth.service`. Pair devices in **Settings › Bluetooth**. `update` keeps both current.