bt-device(1)

✨ bt-device — a bluetooth device manager ✨

okay bestie, so this is bt-device(1) from the bluez-tools manual 💖 it's your little group-chat manager for all things Bluetooth devices — listing them, connecting, disconnecting, yeeting them into the void, peeking at their info, hunting down their services, and tweaking their properties. no cap. 🦋

🌸 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 literally the way to manage Bluetooth devices 💅 you can:

• list the devices that have been added
• connect to a brand new device
• disconnect a device
• remove a device you've added
• show info about a device
• discover what services a remote device has to offer
• change device properties

it's giving "one tool to run the whole Bluetooth situation" and honestly? iconic. 👑

✨ OPTIONS ✨

• -h, --help — show help. that's it, that's the whole vibe 🫶
• -a, --adapter <name|mac> — pick which adapter to use, by its Name or its MAC address. if you don't define this option at all, the default adapter gets used 🌈
• -l, --list — list all the added devices. your lil roster 📋
• -c, --connect <mac> — connect to the remote device by its MAC, pull in all the SDP records, and then kick off the pairing 🔥
• -d, --disconnect <name|mac> — disconnects one specific remote device by terminating the low-level ACL connection. bye bestie 👋
• -r, --remove — remove the device (and the pairing information goes too, so like… be sure 💀)
• -i, --info — show information about a device. returns all the properties, no holding back 💜
• -s, --services <name|mac> [<pattern>] — starts service discovery to retrieve the remote service records. the pattern parameter lets you specify particular UUIDs if you're feeling specific 🧚
• --set <property> <value> — change device properties. (peep the DEVICE PROPERTIES section below for the list of available properties ✨)
• -v, --verbose — verbosely display remote service records. this one affects service discovery mode, so it's the "tell me EVERYTHING" switch 🙈

👑 DEVICE PROPERTIES 👑

• string Address [ro] — the Bluetooth device address (MAC) of the remote device. its little government name 🏠
• string Name [ro] — the Bluetooth remote device name.
• string Icon [ro] — the 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] — a list of 128-bit UUIDs that represents the available remote services.
• boolean Paired [ro] — indicates whether the remote device is paired.
• boolean Connected [ro] — indicates whether the remote device is currently connected.
• boolean Trusted [rw] — indicates whether the remote is seen as trusted.
• boolean Blocked [rw] — if set to true, any incoming connections from the device will be immediately rejected. hard block, no notes 🚫
• string Alias [rw] — the name alias for the remote device. the alias is how you can have a different, friendlier name for the remote device 💖

in case no alias is set, it will return the remote device name. setting an empty string as the 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. old-school fr fr 📻

🦋 AUTHOR 🦋

Alexander Orlenko <zxteam@gmail.com>. 🫶

🌟 SEE ALSO 🌟

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

heads up bestie — this page is from the bluez-tools manual, and it's dated 2014-08-01. so if it's vintage, that's on purpose 💅✨

k that's the whole page, go pair something 💖🎀🦋