btmgmt🔗

interactive bluetooth management tool🔗

Version:

BlueZ

Copyright:

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

Date:

July 2023

Manual section:

1

Manual group:

Linux System Administration

SYNOPSIS🔗

btmgmt [–options] [commands]

DESCRIPTION🔗

btmgmt(1) 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 since 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 as it may result in unexpected behavior.

OPTIONS🔗

-i/–index:

Specify adapter index

-m-/-monitor:

Enable monitor output

-t/–timeout:

Timeout in seconds for non-interactive mode

-v/–version:

Display version

-i/–init-script:

Init script file

-h/–help:

Display help

COMMANDS🔗

main:

See bluetoothctl-mgmt(1)

monitor:

See bluetoothctl-monitor(1)

AUTOMATION🔗

Two common ways to automate the tool are 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

REPORTING BUGS🔗

linux-bluetooth@vger.kernel.org