---
name: "bt-device"
section: "1"
platform: "linux"
package: "bluez-tools"
version: "0.2.0-6"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/bt-device"
---

# bt-device(1)

a bluetooth device manager

## NAME

bt-device - a bluetooth device manager

## SYNOPSIS

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

## DESCRIPTION

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.

## OPTIONS

**-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)

## DEVICE PROPERTIES

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\
         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.

## AUTHOR

Alexander Orlenko \<zxteam@gmail.com\>.

## SEE ALSO

[*bt-adapter*(1)](/bt-adapter/1.md) [*bt-agent*(1)](/bt-agent/1.md) [*bt-network*(1)](/bt-network/1.md)