-s, --services <name|mac> [<pattern>]
--set <name|mac> <property> <value>
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
- -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
string Address [ro]
The Bluetooth device address (MAC) of the remote device.
string Name [ro]
The Bluetooth remote device name.
string Icon [ro]
Proposed icon name according to the freedesktop.org
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
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
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
Alexander Orlenko <firstname.lastname@example.org>.
bt-adapter(1) bt-agent(1) bt-network(1)
bt-adapter(1), bt-agent(1), bt-network(1), bt-obex(1).