bt-adapter(1)

💖 bt-adapter — the manual, bestie edition 💖

okay so you found bt-adapter(1) from bluez-tools and you're like "what is this" — bestie, sit down, we're managing Bluetooth adapters today and it's gonna be iconic.

✨ NAME ✨

bt-adapter — a bluetooth adapter manager. that's it, that's the whole vibe. it manages your adapters. 💅

🌸 SYNOPSIS 🌸

bt-adapter [OPTION...]

Help Options:
  -h, --help

Application Options:
  -l, --list
  -a, --adapter=<name|mac>
  -i, --info
  -d, --discover
  --set <property> <value>

look at her. so simple. so powerful. 🫶

🦋 DESCRIPTION 🦋

so like, this utility manages Bluetooth adapters. that's the whole job. you can:

• list all the available adapters
• show information about an adapter
• change adapter properties
• discover remote devices

four things. she does four things and she does them flawlessly. no cap. 🔥

👑 OPTIONS 👑

• -h, --help — Show help. the "hello what do i do" button. press it, get help, slay. ✨
• -l, --list — List all available adapters. every adapter you've got, lined up, ready to be perceived. 👑
• -a, --adapter <name|mac> — Specify adapter to use by his Name or MAC address (if this option does not defined - default adapter used). so you can call your adapter by its cute little name or by its raw MAC address, whichever. and if you don't say anything at all? the default adapter gets picked. she just knows. 🙈
• -i, --info — Show information about adapter (returns all properties). literally every property. the whole dossier. no secrets between us. 💀
• -d, --discover — Discover remote devices (with remote device name resolving). go out there and find your people, and yes it resolves their names so you're not just staring at a pile of hex. 🌈
• --set <property> <value> — Change adapter properties (see ADAPTER PROPERTIES section for list of available properties). you wanna tweak something? this is the tweaker. scroll down to ADAPTER PROPERTIES for the menu. 🎀

🧚 ADAPTER PROPERTIES 🧚

here's the full property list, typed exactly as she comes, typos and all, because we do not edit the source material in this house. 💜

• string Address [ro] — The Bluetooth adapter address (MAC). read-only bestie, you cannot change your own MAC by asking nicely. 💅
• string Alias [rw] — The Bluetooth adapter friendly name. this one you CAN change! give her a cute name. main character energy. ✨
• uint32 Class [ro] — The Bluetooth class of device. read-only. it is what it is. 🦋
• boolean Powered [rw] — Switch an adapter on or off. This will also set the appropiate connectable state. on = she's awake and connectable. off = do not perceive her. 🔌
• boolean Discoverable [rw] — Switch an adapter to discoverable or non-discoverable to either make it visible or hide it.

If the DiscoverableTimeout is set to a non-zero value then the system will set this value back to false after the timer expired.

In case the adapter is switched off, setting this value will fail. 💀

so basically: visible, or hidden, and if the timeout is ticking she'll flip herself back to false when it runs out. and if the adapter is OFF? nope. fail. she said no.

• boolean Pairable [rw] — Switch an adapter to pairable or non-pairable.

Note that this property only affects incoming pairing requests. so it's about who's asking you, not about you going out there asking. 🫶

• uint32 PaireableTimeout [rw] — The pairable timeout in seconds. A value of zero means that the timeout is disabled and it will stay in pareable mode forever. (yes the property name and the description are spelled that way, i'm just the messenger 🥲) zero = forever pairable, no timer, she's committed.
• uint32 DiscoverableTimeout [rw] — The discoverable timeout in seconds. A value of zero means that the timeout is disabled and it will stay in discoverable/limited mode forever.

The default value for the discoverable timeout should be 180 seconds (3 minutes).

so three minutes of being findable by default, or zero for "i live here now, forever discoverable." 🌸

• boolean Discovering [ro] — Indicates that a device discovery procedure is active. read-only, she just tells you if she's currently out there looking. 👀
• list UUIDs [ro] — List of 128-bit UUIDs that represents the available local services. all your local services, in their 128-bit UUID era. iconic. 💖

🌟 AUTHOR 🌟

Alexander Orlenko <zxteam@gmail.com>. the founder. the blueprint. the original main character. 👑

💫 SEE ALSO 💫

bt-agent(1) · bt-device(1) · bt-network(1)

go read those too, bestie, they're the rest of the friend group. 🎀

this page came to you from bluez-tools, dated 2014-08-01. vintage. classic. still slaps. 💅✨

okay that's the whole page, mwah, go manage some adapters 🫶🌈💖