BTMGMT(1)

🦋 btmgmt: interactive bluetooth management tool 🦋

Okay so welcome to BTMGMT(1), bestie — this is the Linux System Administration page for btmgmt, the interactive bluetooth management tool. Group-chat summary: it's lowkey powerful, highkey a little dangerous if you're not supposed to be there, and it wants you to know the rules. 💖

---

✨ NAME ✨

btmgmt — interactive bluetooth management tool

🌸 SYNOPSIS 🌸

btmgmt [--options] [commands]

💅 DESCRIPTION 💅

btmgmt(1) is the interactive bluetooth management tool. The tool issues commands to the Kernel using the Bluetooth Management socket. Some commands may require net-admin capability in order to work, because the Bluetooth Management interface is considered a low-level interface meant for the likes of bluetoothd(8).

⚠️ It is not recommended for applications to use it directly — that may result in unexpected behavior. No cap, this is giving "look, don't touch unless you know what you're doing" energy. 😭

🎀 OPTIONS 🎀

• -i/--index — specify adapter index. Pick your adapter, bestie. 🦋
• -m-/-monitor — enable monitor output. Yes, the page spells it exactly like that — I'm not fixing it. 💀
• -t/--timeout — timeout in seconds for non-interactive mode. So it knows when to stop waiting. ⏳
• -v/--version — display version. Vibe check: which version are we on? ⭐
• -i/--init-script — init script file. Point it at your script. 🎀
• -h/--help — display help. The classic. 💖

🌈 COMMANDS 🌈

• main — see bluetoothctl-mgmt(1). 👑
• monitor — see bluetoothctl-monitor(1). 🧚

⭐ AUTOMATION ⭐

There are two common ways to automate the tool. One is to pass the commands directly, like in the follow example:

btmgmt <<EOF
list
show
EOF

Or create a script and pass it as init-script:

$ vi test-script.bt
list
show
quit
: wq
$ btmgmt --init-script=test-script

🫶 RESOURCES 🫶

http://www.bluez.org — that's the BlueZ home base, bestie. 🌐

💀 REPORTING BUGS 💀

linux-bluetooth@vger.kernel.org — send bug reports here. 📬

👑 COPYRIGHT 👑

Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL). 💅

---

That's the whole BTMGMT(1) page, bestie — source/version BlueZ, dated July 2023. Bye and slay responsibly 💖✨