LinuxCommandLibrary

btmgmt

TLDR

Start interactive mode

$ btmgmt
copy
List Bluetooth adapters
$ btmgmt info
copy
Use specific adapter
$ btmgmt -i [hci0] info
copy
Power on adapter
$ btmgmt power on
copy
Power off adapter
$ btmgmt power off
copy
Start discovery
$ btmgmt find
copy
Enable monitor mode
$ btmgmt -m
copy
Run command with timeout
$ btmgmt -t [10] find
copy

SYNOPSIS

btmgmt [options] [command]

DESCRIPTION

btmgmt is an interactive Bluetooth management tool that issues commands to the kernel using the Bluetooth Management socket. It provides low-level control of Bluetooth adapter settings, discovery, and pairing functionality.
The tool is part of the BlueZ Bluetooth stack and uses the management interface available since Linux kernel 3.4.

PARAMETERS

-i, --index adapter

Specify adapter index (e.g., hci0)
-m, --monitor
Enable monitor output
-t, --timeout seconds
Timeout for non-interactive mode
-v, --version
Display version
--init-script file
Run commands from init script
-h, --help
Display help

COMMANDS

info

Show adapter information
power on|off
Control adapter power state
find
Start device discovery
pair address
Pair with device
unpair address
Remove pairing
disconnect address
Disconnect device
con
List connections

CAVEATS

Some commands require net-admin capability or root privileges. This is a low-level interface meant for bluetoothd; applications should use D-Bus APIs instead. Direct use may cause unexpected behavior with the Bluetooth daemon.

SEE ALSO

Copied to clipboard