BLUETOOTHCTL-TELEPHONY(1)

📦
version 5.87+2.git8750129efca8 · 5 versions
, in centos-stream 9

NAME 🎀

okay so bestie, this is the bluetoothctl-telephony manual page from Linux System Administration — yes, the BLUETOOTHCTL-TELEPHONY(1) one. It's all about the Telephony Submenu, and it's lowkey iconic. 💖

SYNOPSIS 🦋

bluetoothctl [--options] [telephony.commands]

This submenu manages telephony features using the org.bluez.Telephony(5) and org.bluez.Call(5) interfaces. Those two interfaces are the main characters here, no cap. ✨

TELEPHONY COMMANDS 👑

list 📞

List available audio gateways. Simple, clean, slay.

Usage:

Usage  > list

Example — Display all available HFP audio gateways:

> list

show 🔍

Show audio gateway information.

Usage:

Usage  > show [telephony]

Uses org.bluez.Telephony(5) properties.

  • [telephony] — Audio gateway device path (optional, shows current if omitted)

Example — Show information for currently selected audio gateway:

> show

Example — Show information for specific audio gateway device:

> show /org/bluez/hci0/dev_00_11_22_33_44_55

Example — Show information for another audio gateway:

> show /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF

select 👑

Select default audio gateway. Main character selection energy.

Usage:

Usage  > select <telephony>
  • <telephony> — Audio gateway device path to set as default

Example — Select specific audio gateway as default:

> select /org/bluez/hci0/dev_00_11_22_33_44_55

Example — Select different audio gateway as default:

> select /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF

dial ☎️

Dial number. We're making calls, bestie.

Usage:

Usage  > dial <number> [telephony]

Uses org.bluez.Telephony(5) method Dial.

  • <number> — Phone number to dial
  • [telephony] — Audio gateway device path (optional, uses current if omitted)

Example — Dial number using currently selected audio gateway:

> dial 555-1234

Example — Dial international number using current audio gateway:

> dial +1-555-123-4567

Example — Dial emergency number using current audio gateway:

> dial 911

Example — Dial number using specific audio gateway:

> dial 555-1234 /org/bluez/hci0/dev_00_11_22_33_44_55

Example — Dial UK number using specific audio gateway:

> dial +44-20-7946-0958 /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF

Example — Dial with caller ID blocking:

> dial *67-555-1234

Example — Dial with caller ID hiding (GSM format):

> dial #31#555-1234

hangup-all 💀

Hangup all calls. Goodbye to the whole call list, periodt.

Usage:

Usage  > hangup-all [telephony]

Uses org.bluez.Telephony(5) method HangupAll.

  • [telephony] — Audio gateway device path (optional, uses current if omitted)

Example — Terminate all active and waiting calls on current gateway:

> hangup-all

Example — Terminate all calls on specific audio gateway:

> hangup-all /org/bluez/hci0/dev_00_11_22_33_44_55

list-calls 📋

List available calls.

Usage:

Usage  > list-calls

Example — Display all active, waiting, and held calls:

> list-calls

show-call 🔎

Show call information.

Usage:

Usage  > show-call <call>

Uses org.bluez.Call(5) properties.

  • <call> — Call object path to display information for

Example — Show information for specific call:

> show-call /org/bluez/hci0/dev_00_11_22_33_44_55/call1

Example — Show information for another call:

> show-call /org/bluez/hci0/dev_00_11_22_33_44_55/call2

Example — Show call information from different device:

> show-call /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF/call1

answer 🫶

Answer call. Pick up, bestie!

Usage:

Usage  > answer <call>

Uses org.bluez.Call(5) method Answer.

  • <call> — Call object path to answer

Example — Answer incoming call:

> answer /org/bluez/hci0/dev_00_11_22_33_44_55/call1

Example — Answer waiting call:

> answer /org/bluez/hci0/dev_00_11_22_33_44_55/call2

Example — Answer call from different device:

> answer /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF/call1

hangup 📴

Hangup call. Bye-bye, specific call.

Usage:

Usage  > hangup <call>

Uses org.bluez.Call(5) method Hangup.

  • <call> — Call object path to terminate

Example — Terminate specific active call:

> hangup /org/bluez/hci0/dev_00_11_22_33_44_55/call1

Example — Terminate waiting or held call:

> hangup /org/bluez/hci0/dev_00_11_22_33_44_55/call2

Example — Terminate call from different device:

> hangup /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF/call1

RESOURCES 🌈

http://www.bluez.org

REPORTING BUGS 💀

Bug reports go to linux-bluetooth@vger.kernel.org.

Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL). That's the licensing tea, bestie. 🫶

xoxo, source/version: BlueZ — date: May 2025 💅✨

📦 where this page comes from