---
name: "bluetoothctl-telephony"
section: "1"
platform: "linux"
package: "bluez-utils"
version: "5.87-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/bluetoothctl-telephony"
---

# bluetoothctl-telephony(1)

Telephony Submenu

## Name

bluetoothctl-telephony - Telephony Submenu

## SYNOPSIS

**bluetoothctl** \[--options\] \[telephony.commands\]

This submenu manages telephony features using the **[org.bluez.Telephony(5)](/org.bluez.Telephony/5.md)** and **[org.bluez.Call(5)](/org.bluez.Call/5.md)** interfaces.

## Telephony Commands

### list

List available audio gateways.

- **Usage**

  **\> list**

- **Example Display all available HFP audio gateways**

  ```
  > list
  ```

### show

Show audio gateway information.

- **Usage**

  **\> show \[telephony\]**

- **Uses**

  **[org.bluez.Telephony(5)](/org.bluez.Telephony/5.md)** 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.

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

- **Usage**

  **\> dial \<number\> \[telephony\]**

- **Uses**

  **[org.bluez.Telephony(5)](/org.bluez.Telephony/5.md)** 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.

- **Usage**

  **\> hangup-all \[telephony\]**

- **Uses**

  **[org.bluez.Telephony(5)](/org.bluez.Telephony/5.md)** 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**

  **\> list-calls**

- **Example Display all active, waiting, and held calls**

  ```
  > list-calls
  ```

### show-call

Show call information.

- **Usage**

  **\> show-call \<call\>**

- **Uses**

  **[org.bluez.Call(5)](/org.bluez.Call/5.md)** 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.

- **Usage**

  **\> answer \<call\>**

- **Uses**

  **[org.bluez.Call(5)](/org.bluez.Call/5.md)** 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.

- **Usage**

  **\> hangup \<call\>**

- **Uses**

  **[org.bluez.Call(5)](/org.bluez.Call/5.md)** 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

\<linux-bluetooth@vger.kernel.org\>

## Copyright

Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL).