btmgmt - Man Page

interactive bluetooth management tool

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

Info

July 2023 BlueZ Linux System Administration