BLUETOOTH-CONFIG(8)

💙 BLUETOOTH-CONFIG 💙

okay so bestie, gather round, because we're talking about bluetooth-config — that's the bluetooth-config(8) page from section 8 of the System Manager's Manual, and it's literally your friendly little script for managing config files for the bluetooth subsystem 🦋

---

✨ NAME ✨

bluetooth-config — a script to manage config files for the bluetooth subsystem. that's it, that's the whole vibe 🎀

---

✨ SYNOPSIS ✨

bluetooth-config scan [-d device] [-n node]

---

✨ DESCRIPTION ✨

bluetooth-config is an interactive script that gives you a frontend to the complex bluetooth subsystem daemons. like, the daemons are doing A Lot and this is the cute little handler that makes it not scary 💅

The following options are available:

• -d — scan for a specific bluetooth device address 🔍
• -n — limit the scan to a specific host controller. hint: list all netgraph nodes with /usr/sbin/ngctl list 👑

bluetooth-config will help you find and set up bluetooth controllers, scan for nearby bluetooth devices that are in pairing mode, look up their names, let you map them to friendly names in /etc/bluetooth/hosts, ask for the pairing PIN, instrument hcsecd(8) so it can securely pair with new devices and — if the device offers HID endpoints like mice or keyboards — configure and restart bthidd(8). it's giving full-service concierge energy, honestly 🫶

bluetooth-config can bring up any interface and daemon necessary for operation and, if a node is provided on the command line, it will do so automatically for that interface. no cap, it handles it ⭐

---

🌸 FILES 🌸

• /etc/bluetooth/hosts
• sysrc -n bthidd_config
• sysrc -n hcsecd_config

---

💖 EXAMPLES 💖

1️⃣ here's one with a specific controller and address

bluetooth-config scan -n ubt0 -a 00:26:bb:7a:58:95

This will scan the bluetooth controller ubt0hci for a bluetooth device with the address 00:26:bb:7a:58:95, set up ubt0 if necessary, and enter an interactive dialog to pair the new device 🔥

Since in this example a mouse is paired, bluetooth-config will interact with bthidd(8), enabling it if necessary, and then write an HID descriptor to its config. iconic behavior, honestly 🐭

2️⃣ and here's the "just scan everything" one

bluetooth-config scan

This will scan all bluetooth controllers on the systems for bluetooth devices, prompting you to bring up controllers or daemons along the way 💫

---

👀 SEE ALSO 👀

bthost(1), bthidcontrol(8), bthidd(8), hccontrol(8), hcsecd(8), sdpcontrol(8), sysrc(8)

go read them, iykyk 📚

---

🌈 HISTORY 🌈

A bluetooth-config utility first appeared in FreeBSD 12.1. an icon, a legend, a moment 💜

---

👑 AUTHORS 👑

Dirk Engling <erdgeist@erdgeist.org> — thank you for your service 🫡

---

💀 CAVEATS 💀

⚠️ bluetooth-config can not parse entries in the hcsecd(8) config file and thus will ask the user to manually modify existing pairing PIN entries. so like, you will be touching that file yourself, bestie. heads up 🙈

---

🍓 THANKS TO 🍓

Lars Engels and Warren Block for suggestions, help, and testing. real ones fr fr 💖

---

and that's the page!! source is the Debian version, dated January 7, 2019, and the whole thing lives under BLUETOOTH-CONFIG(8). slay, go pair something 💅✨