bt-device (1) - Linux Manuals

bt-device: a bluetooth device manager


bt-device - a bluetooth device manager


bt-device [OPTION...]

Help Options:
  -h, --help

Application Options:
  -a, --adapter=<name|mac>
  -l, --list
  -c, --connect=<mac>
  -d, --disconnect=<name|mac>
  -r, --remove=<name|mac>
  -i, --info=<name|mac>
  -s, --services <name|mac> [<pattern>]
  --set <name|mac> <property> <value>
  -v, --verbose


This utility is used to manage Bluetooth devices. You can list added devices, connect to a new device, disconnect device, remove added device, show info about device, discover remote device services or change device properties.


-h, --help
 Show help

-a, --adapter <name|mac>
 Specify adapter to use by his Name or MAC address
 (if this option does not defined - default adapter used)

-l, --list
 List added devices

-c, --connect <mac>
 Connect to the remote device by his MAC, retrieve all SDP
 records and then initiate the pairing

-d, --disconnect <name|mac>
 Disconnects a specific remote device by terminating the
 low-level ACL connection.

-r, --remove
 Remove device (and also the pairing information)

-i, --info
 Show information about device (returns all properties)

-s, --services <name|mac> [<pattern>]
 Starts the service discovery to retrieve remote service records,
 the `pattern` parameter can be used to specify specific UUIDs

--set <property> <value>
 Change device properties (see DEVICE PROPERTIES section for list
 of available properties)

-v, --verbose
 Verbosely display remote service records (affect to service
 discovery mode)


string Address [ro]
  The Bluetooth device address (MACof the remote device.

string Name [ro]
  The Bluetooth remote device name.

string Icon [ro]
  Proposed icon name according to the
  icon naming specification.

uint32 Class [ro]
  The Bluetooth class of device of the remote device.

list UUIDs [ro]
  List of 128-bit UUIDs that represents the available
  remote services.

boolean Paired [ro]
  Indicates if the remote device is paired.

boolean Connected [ro]
  Indicates if the remote device is currently connected.

boolean Trusted [rw]
  Indicates if the remote is seen as trusted.

boolean Blocked [rw]
  If set to true any incoming connections from the
  device will be immediately rejected.

string Alias [rw]
  The name alias for the remote device. The alias can
  be used to have a different friendly name for the
  remote device.

        In case no alias is set, it will return the remote
        device name. Setting an empty string as alias will
        convert it back to the remote device name.

boolean LegacyPairing [ro]
  Set to true if the device only supports the pre-2.1
  pairing mechanism.


Alexander Orlenko <zxteam [at]>.


bt-adapter(1) bt-agent(1) bt-network(1)