bluetoothctl-telephony(1) Linux System Administration bluetoothctl-telephony(1)

# [Name](#Name)

bluetoothctl-telephony - Telephony Submenu

# [SYNOPSIS](#SYNOPSIS)

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

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

# [Telephony Commands](#Telephony_Commands)

## [list](#list)

List available audio gateways.

[**Usage**](#Usage)

**> list**

[**Example Display all available HFP audio gateways**](#Example)

```
> list
```

## [show](#show)

Show audio gateway information.

[**Usage**](#Usage~2)

**> show \[telephony]**

[**Uses**](#Uses)

[**org.bluez.Telephony(5)**](/man/os/bluez/org.bluez.Telephony.5) properties

**\[telephony]**

Audio gateway device path (optional, shows current if omitted)

[**Example Show information for currently selected audio gateway**](#Example~2)

```
> show
```

[**Example Show information for specific audio gateway device**](#Example~3)

```
> show /org/bluez/hci0/dev_00_11_22_33_44_55
```

[**Example Show information for another audio gateway**](#Example~4)

```
> show /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF
```

## [select](#select)

Select default audio gateway.

[**Usage**](#Usage~3)

**> select <telephony>**

**<telephony>**

Audio gateway device path to set as default

[**Example Select specific audio gateway as default**](#Example~5)

```
> select /org/bluez/hci0/dev_00_11_22_33_44_55
```

[**Example Select different audio gateway as default**](#Example~6)

```
> select /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF
```

## [dial](#dial)

Dial number.

[**Usage**](#Usage~4)

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

[**Uses**](#Uses~2)

[**org.bluez.Telephony(5)**](/man/os/bluez/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**](#Example~7)

```
> dial 555-1234
```

[**Example Dial international number using current audio gateway**](#Example~8)

```
> dial +1-555-123-4567
```

[**Example Dial emergency number using current audio gateway**](#Example~9)

```
> dial 911
```

[**Example Dial number using specific audio gateway**](#Example~10)

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

[**Example Dial UK number using specific audio gateway**](#Example~11)

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

[**Example Dial with caller ID blocking**](#Example~12)

```
> dial *67-555-1234
```

[**Example Dial with caller ID hiding (GSM format)**](#Example~13)

```
> dial #31#555-1234
```

## hangup-all

Hangup all calls.

[**Usage**](#Usage~5)

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

[**Uses**](#Uses~3)

[**org.bluez.Telephony(5)**](/man/os/bluez/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**](#Example~14)

```
> hangup-all
```

[**Example Terminate all calls on specific audio gateway**](#Example~15)

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

## list-calls

List available calls.

[**Usage**](#Usage~6)

**> list-calls**

[**Example Display all active, waiting, and held calls**](#Example~16)

```
> list-calls
```

## show-call

Show call information.

[**Usage**](#Usage~7)

**> show-call <call>**

[**Uses**](#Uses~4)

[**org.bluez.Call(5)**](/man/os/bluez/org.bluez.Call.5) properties

**<call>**

Call object path to display information for

[**Example Show information for specific call**](#Example~17)

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

[**Example Show information for another call**](#Example~18)

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

[**Example Show call information from different device**](#Example~19)

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

## [answer](#answer)

Answer call.

[**Usage**](#Usage~8)

**> answer <call>**

[**Uses**](#Uses~5)

[**org.bluez.Call(5)**](/man/os/bluez/org.bluez.Call.5) method **Answer**

**<call>**

Call object path to answer

[**Example Answer incoming call**](#Example~20)

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

[**Example Answer waiting call**](#Example~21)

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

[**Example Answer call from different device**](#Example~22)

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

## [hangup](#hangup)

Hangup call.

[**Usage**](#Usage~9)

**> hangup <call>**

[**Uses**](#Uses~6)

[**org.bluez.Call(5)**](/man/os/bluez/org.bluez.Call.5) method **Hangup**

**<call>**

Call object path to terminate

[**Example Terminate specific active call**](#Example~23)

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

[**Example Terminate waiting or held call**](#Example~24)

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

[**Example Terminate call from different device**](#Example~25)

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

# [RESOURCES](#RESOURCES)

<http://www.bluez.org>

# [REPORTING BUGS](#REPORTING_BUGS)

<linux-bluetooth@vger.kernel.org>

# [Copyright](#Copyright)

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

May 2025 BlueZ

---

Document: bluetoothctl-telephony(1) from bluez 5.87-r1 (Chainguard OS)
Source: https://github.com/bluez/bluez